用途：为仓库构建、更新或同步持久化的代码知识图谱，供影响面分析（blast-radius）和图谱驱动的代码审查使用。
主要能力：用 Tree-sitter 解析代码库，生成函数、类、导入、调用、测试等结构图谱，存储于 .code-graph/graph.db（SQLite，自动 gitignore）。支持 Python、TypeScript、JavaScript、Vue、Go、Rust、Java、C#、Ruby、Kotlin、Swift、PHP、Solidity、C/C++。构建后自动运行连接器：API 端点匹配（前端 HTTP 调用对应后端路由）与隐式连接（实体事件、消息总线、命令事件），生成 MESSAGE_BUS、TRIGGERS_EVENT、PRODUCES_EVENT、TRIGGERS_COMMAND_EVENT、API_ENDPOINT 等边。
使用方式：需 Python 3.10+，安装 pip install tree-sitter tree-sitter-language-pack networkx。--scope 选择操作：默认无参数按状态自动检测（从未构建则全量，否则增量）；--scope=full 强制全量重建；--scope=update 处理未提交工作区变更；--scope=sync 先同步已提交 git 变更再更新工作区。对应命令如 python .claude/scripts/code_graph status --json、build --json、update --json、sync --json。可用 describe --json 获取命令结构化说明。
适用场景：首次为项目建立图谱、大规模重构或切换分支后、图谱疑似过期时。文件编辑由 PostToolUse 钩子自动更新，HEAD 移动由 SessionStart/UserPromptSubmit 钩子自动同步，通常无需手动构建。
限制：sync/update 无 --files 参数，变更由 git 自动检测；无 incremental 子命令，增量是 update 的默认行为。检出较旧提交时 sync 会返回 graph_ahead_skipped 并保持图谱不变，此时图谱描述的是较新代码树，如需精确匹配旧分支应运行 --scope=full。初始构建约 500 文件 10 秒，增量小于 2 秒。其余细节暂未提供。