cobuilt

cobuilt プラグイン

AI コーディングエージェントから、プロジェクトのビルドレシートを cobuilt.dev に公開できます。ビルドレシートは、プロジェクトがどのように構築され、AI がどのように関与したかを正直に記録するものです。エージェントはリポジトリとセッションをもとに下書きを作成し、あなたにしか答えられないことを尋ね、すべての項目を承認するまで何も送信しません。

対応環境

公開は、エージェントトークンを送信できる Claude Code と Gemini CLI で利用できます。claude.ai のチャットと Cowork ではスキルは読み込まれますが、cobuilt ツールは動作しません。これらのアプリは OAuth サインイン経由でサーバーに接続しますが、cobuilt はまだ対応していないためです。公開するには、Claude Code でプロジェクトを開いてください。

試してみる

プロジェクト内で、次のいずれかを伝えてください。

• 「このプロジェクトを cobuilt に公開して。」エージェントがレシートの下書きを作成し、把握できないことを尋ねたうえで、承認用の最終項目を表示します。
• 「このプロジェクトが cobuilt に公開しているビルドレシートを見せて。」あなたのプロジェクトの中から該当するものを見つけ、現在のレシートを読み込みます。変更は加えられません。
• 「このプロジェクトの cobuilt 上のビルドレシートを更新して。」公開済みのレシートをもとに作業を開始し、変更前と変更後のテキストを並べて表示し、置き換える前に警告します。

インストール（Claude Code）

1. cobuilt.dev にサインインし、エージェントトークンを作成します：Settings → Agent tokens（トークンは cbt_ で始まります）。

2. Claude Code のセッションで、次を実行します：

   /plugin install cobuilt --marketplace cobuilt-dev/agent-plugins
   

   ダイアログで求められたらトークンを貼り付け、その後 /reload-plugins を実行します。

3. **「このプロジェクトを cobuilt に公開して」**と伝えるか、/cobuilt:publish を実行します。

動作しない場合

• 以前に claude mcp add で cobuilt を追加しましたか？ まず claude mcp remove cobuilt --scope user を実行してください。同じアドレスに手動で追加したサーバーが、プラグインのサーバーを通知なしに置き換えます。
• cobuilt ツールが表示されませんか？ /plugin configure cobuilt@cobuilt を実行してトークンを貼り付け、その後 /reload-plugins を実行してください。シェルからインストールした場合（claude plugin install）、トークンの入力は求められません。
• claude.ai でプラグインを追加しましたか？ Claude Code では cobuilt@synced として認識されるため、代わりに /plugin configure cobuilt@synced を実行してください。
• Cursor も使っていますか？ Cursor はインストール済みの Claude Code プラグインをインポートし（Cursor Settings → Agents → Third-Party Imports、デフォルトでオン）、このプラグインを「cobuilt · Plugin」と表示しますが、トークンを読み取れないためエラーになります。Cursor の MCP リストでその項目をオフにしてください（再起動後もオフのままです）。そのうえで、cobuilt.dev/connect にある ~/.cursor/mcp.json の設定スニペットを使って Cursor を設定してください。

インストール（Gemini CLI）

1. 上記の手順でエージェントトークンを作成します。

2. ターミナルで、次を実行します：

   gemini extensions install https://github.com/cobuilt-dev/agent-plugins
   

   cobuilt agent token を求められたら、トークンを貼り付けます。

3. Gemini CLI を起動し、**「このプロジェクトを cobuilt に公開して」**と伝えます。

cobuilt ツールが表示されませんか？ gemini extensions config cobuilt を実行してトークンを貼り付け、その後 Gemini CLI を再起動してください。gemini mcp list で cobuilt が接続済みと表示されるはずです。

その他のクライアントの設定：cobuilt.dev/connect。

含まれるもの

• cobuilt MCP サーバー（https://cobuilt.dev/mcp）。トークンは Authorization: Bearer … として送信されます。搭載するツール：プロジェクトの一覧表示、作成ガイドの取得、現在のレシートの読み込み、ビルドレシートの送信。
• Claude Code と Gemini CLI で共有される publish スキル。許可しない限り、クライアントは cobuilt のツールを呼び出す前に確認します。また、レシートの送信時には必ず確認を求めます。

トークン

Claude Code はトークンをシークレットとして保存します。macOS では Keychain に、その他の環境ではユーザーフォルダー内にある Claude Code 独自の認証情報ファイルに保存します。 プラグインをアンインストールすると、トークンは削除されます。

Gemini CLI はトークンをシステムのキーチェーンに保存します（Windows では、「Gemini CLI Extensions cobuilt …」という項目の資格情報マネージャーに保存されます。キーチェーンがない場合は、Gemini CLI 独自の設定フォルダー内のファイルに保存されます）。拡張機能をアンインストールしても、トークンは削除されません。該当する項目は自分で削除してください（Windows の場合：コントロール パネル → 資格情報マネージャー → Windows 資格情報 → 汎用資格情報）。

トークンを無効にするには、cobuilt.dev の Settings → Agent tokens でトークンを取り消してください。

送信される情報と送信先

このプラグインは、お使いのマシン上で何も実行しません。フック、スクリプト、ローカルコマンドは一切ありません。単一のサーバー https://cobuilt.dev/mcp と通信し、すべてのリクエストにエージェントトークンが含まれます。

• 読み取り： エージェントは、作成ガイド、プロジェクト一覧、プロジェクトの現在のレシートを取得します。
• 公開： 承認後、レシートを送信します。内容は、プロジェクト名、説明、リンク、種類と技術スタック（新規プロジェクトの場合）、AI の関与方法、使用した AI ツール、AI が行ったこと、自分が行ったこと、問題が発生したこと、エージェント名とモデル名、コミット数などの任意の概要数値です。

プロジェクトが承認されると、送信したレシートは公開されます。新規プロジェクトは、まず審査されます。既存のプロジェクトにレシートを送信すると、現在のレシートが置き換えられます。cobuilt は、レシートが置き換えられるか、プロジェクトが削除されるまでレシートを保持します。

プラグインの指示では、ソースコード、差分、ファイルの内容、プロンプト、チャットの記録、シークレット、環境変数、ローカルファイルのパスを決して送信しないよう、エージェントに伝えています。エージェントはすべての項目を送信前に表示するため、承認する前に確認してください。プライバシーポリシーと利用規約をご覧ください。

リリース

変更のたびに、すべてのマニフェストのバージョンを更新し、vX.Y.Z タグを付けた GitHub リリースを作成します。作成ガイドとツールの変更は cobuilt.dev で公開されるため、プラグインの更新は必要ありません。この README のみの変更では、バージョンを更新しません。

server.json は、公式 MCP レジストリ（official MCP Registry）にサーバーを dev.cobuilt/cobuilt として登録します。バージョンはプラグインと同じです。公開済みのバージョンは再公開できないため、server.json を変更する場合はリリースを作成し、その後、新たに公開する必要があります。

ライセンス

MIT