Spiderbrain

spiderbrain

为你的代码库提供一层可提交的理解信息，并用一条命令即可操作。代码库会告诉 AI Agent 代码「是什么」，却不会告诉它什么重要、某项更改会影响到哪里，或为什么要以某种方式构建。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/ 文件夹时，任何 Agent 或开发者都可以离线使用：

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 表示没有理解信息）。 没有已提交的文件夹？如果代码库的源仓库在公共注册表中有非官方的 brain，读取器会回退到该注册表。

组件

spiderbrain 是一个精简的分发器，负责调用两个可独立安装的软件包：

• @spiderbrain/read — 使用：读取器、命令行、MCP 服务。零依赖。
• @spiderbrain/create — 生成：获取评分后的 brain，并写入理解信息集。

只发布理解信息的 CI 任务可以仅依赖 @spiderbrain/create；只需读取信息的 MCP 配置可以指向 @spiderbrain/read。只想直接使用时，输入 spiderbrain 即可。

许可证

MIT。