codegraph

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Chinese

Local code graph exposed as 8 MCP tools. Replaces grep + Read loops for exploration with O(1) SQLite lookups and FTS5 search.

本地代码图谱以8个MCP工具的形式提供。将用于代码探索的grep + 读取循环替换为O(1)的SQLite查询和FTS5搜索。

Brownfield repo where structure is non-obvious
Task involves: "where is X used", "what breaks if I change Y", "trace flow from A to B"
Long-running session — cold-start cost amortizes over multiple queries

Single-file edits or trivial lookups
Session likely shorter than cold-start cost (see
```
references/spike.md
```
for per-repo numbers)
Repo not initialized AND no cached
```
.codegraph/
```
AND short session

Node 18+ on PATH
Project has
```
.codegraph/
```
(run
```
codegraph init
```
if not)
For cloud sessions: cold-start cost verified via
```
references/spike.md
```
for the target repo

```
references/install.md
```
— installation for local / Claude Code Cloud / devcontainer
```
references/usage.md
```
— which of the 8 MCP tools to use when, with main-session vs subagent rules
```
references/spike.md
```
— cold-start measurement protocol; run once per new target repo before relying on codegraph in cloud sessions

Cold-start measured locally (Node 22, 4 cores). Cloud cold-start still pending — re-run

references/spike.md

in a cloud session before relying on these numbers there.

Repo	Indexed files	Nodes / edges	DB size	Cold init+index	Query wall
onsager-ai/onsager	578 (rust + tsx/ts)	8.6k / 20k	24 MB	12s	~0.9s
crawlab-team/crawlab	644 (go)	6.8k / 15k	11 MB	6s	~0.9s
codervisor/leanspec	695 (tsx/rust/ts)	8.9k / 21k	23 MB	10s	~0.9s

Per-query wall is dominated by Node startup — the SQLite work itself is milliseconds. End-to-end cold-start including one-shot

npx install

is ~13–19s for repos in this size class.

冷启动时长已在本地环境（Node 22，4核）下测量完成。云环境的冷启动时长仍在测试中——在云环境中依赖这些数据之前，请在云会话中重新运行

references/spike.md

。

仓库	已索引文件数	节点/边数	数据库大小	冷启动初始化+索引时长	查询耗时
onsager-ai/onsager	578（rust + tsx/ts）	8.6k / 20k	24 MB	12s	~0.9s
crawlab-team/crawlab	644（go）	6.8k / 15k	11 MB	6s	~0.9s
codervisor/leanspec	695（tsx/rust/ts）	8.9k / 21k	23 MB	10s	~0.9s

单次查询耗时主要受Node启动影响——SQLite本身的操作仅需数毫秒。对于此类规模的仓库，包括一次性

npx install

在内的端到端冷启动时长约为13–19秒。