Spiderbrain

spiderbrain

リポジトリの理解を蓄積するレイヤーと、それを扱うための単一のコマンドです。リポジトリから AI エージェントに伝わるのは、コードが「何」であるかだけです。何が重要なのか、変更がどこまで影響するのか、なぜそのように構築されたのかは伝わりません。spiderbrain がそれを解決します。

• ウェブサイト：https://spiderbrain.ai
• 形式仕様とソース：https://github.com/aabhisrv/Spiderbrain.ai-Coremind

リポジトリの理解を作成する

export SPIDERBRAIN_API_KEY=sb_live_...     # https://spiderbrain.ai/dashboard?tab=keys
npx spiderbrain create

ソースコードを含まない .spiderbrain/ フォルダーと AGENTS.md のブロックを書き込みます。両方をコミットしてください。

リポジトリの理解を読み取る（アカウント不要）

リポジトリに .spiderbrain/ フォルダーがあれば、どのエージェントや開発者でもオフラインで利用できます。

npx spiderbrain mcp --root .        # an MCP server for Claude Code / Cursor
npx spiderbrain blast src/db.ts     # what a change here reaches
npx spiderbrain impact              # what your current git diff reaches
npx spiderbrain keystones           # the load-bearing files
npx spiderbrain path a.ts b.ts      # how one file reaches another
npx spiderbrain verify --allow-stale   # folder untampered? (CI gate)

MCP クライアントの作業ディレクトリは通常、リポジトリではないため、--root <path>、--root=<path>、または SPIDERBRAIN_ROOT 環境変数でリポジトリを明示してください。指定しない場合、サーバーは作業ディレクトリを提供し、理解レイヤーが見つからなかったと報告します。これはエラーではなく、誤った応答です。

すべてのコマンドで --json を指定できます（終了コード：0 成功、1 失敗、2 使用方法、3 理解レイヤーなし）。 フォルダーがコミットされていない場合、リポジトリの origin に非公式の brain があれば、リーダーはパブリックレジストリにフォールバックします。

構成要素

spiderbrain は、個別にインストール可能な 2 つのパッケージを仲介する軽量なディスパッチャーです。

• @spiderbrain/read — 利用側：リーダー、CLI、MCP サーバー。依存関係はありません。
• @spiderbrain/create — 作成側：スコア付けされた brain を取得し、理解セットを書き込みます。

理解レイヤーの公開だけを行う CI ジョブは @spiderbrain/create のみを依存関係にできます。読み取りだけを行う MCP 設定では @spiderbrain/read を指定できます。手軽に使いたい場合に入力するのが spiderbrain です。

ライセンス

MIT。