建立索引和查询
联网内容不联网
索引是项目中的一个 SQLite 数据库,解析、引用匹配和所有查询都在本机进行。
浏览器查看器目前是预览功能,需要手动开启;其余功能都属于常规命令。
通过标准输入输出提供只读工具,一条命令即可写入每个已安装 Agent 的配置。
在本机通过 streamable HTTP 提供同样的工具,适用于编辑器和远程开发。
告诉 Agent 在什么情况下使用哪个工具的说明,安装到各 Agent 的 Skill 目录。
符号、文件、调用路径、模块结构图、类型层级和未被到达的代码,支持浅色和深色主题。
curl -fsSL https://raw.githubusercontent.com/sunerpy/codegraph-rust/main/scripts/install.sh | sh
Windows 上使用 PowerShell 脚本,也可以从发布页下载压缩包。
codegraph init .
在项目的 .codegraph 目录中建立索引,之后的更新只读取发生变化的文件。
codegraph explore "how does checkout compute the total" -p .
返回相关的源码、依赖它的代码,以及其中的调用关系。
codegraph install --yes
把 MCP 服务写入它找到的每个 Agent 的配置。
接入 CodeGraph 的 Agent 只需提出一个结构性问题,不必逐个搜索和读取文件,得到的回答直接包含相关源码以及它们之间的调用关系。答案来自解析出的代码,每次运行都相同。
codegraph install --yes 会把 MCP 服务写入 Claude Code、Cursor、Codex CLI、Kiro、Zed、VS Code 以及其他受支持 Agent 的配置。
| 问题 | 命令行 | MCP 工具 |
|---|---|---|
| 这块代码是怎么工作的? | codegraph explore | codegraph_explore |
| 查看这个符号或文件 | codegraph node | codegraph_node |
| 它在哪里定义? | codegraph search | codegraph_search |
| 谁调用了它? | codegraph callers | codegraph_callers |
| 改动它会影响哪里? | codegraph impact | codegraph_impact |
两侧运行的是同一个引擎,Agent 和你得到的答案相同。所有工具都是只读的。
查看器读取同一份索引:一个符号的调用方和被调用方、一个函数到另一个函数的调用路径、按模块划分的仓库结构图、类型的继承层级,以及没有任何代码到达的代码。它在你的电脑上运行,只读取,不修改。


| 深度 | 提取内容 | 语言 |
|---|---|---|
| 完整符号 | 函数、类、方法、导入、调用和引用 | TypeScript、TSX、JavaScript、JSX、ArkTS、Python、Go、Rust、Java、C、C++、C#、PHP、Ruby、Swift、Kotlin、Dart、Scala、Lua、Luau、Objective-C、R、Solidity、Nix、Terraform、Erlang、GDScript、Pascal、CFML |
| 嵌入内容 | 宿主文件中嵌入的脚本和模板标记 | Vue、Svelte、Astro、Razor、Liquid、MyBatis XML |
| 文件级 | 文件以及文件之间的引用 | YAML、Twig、Properties,以及 Godot 的场景、资源和项目文件 |
表中没有的语言,其文件不会进入图中。可以在 .codegraph/codegraph.json 中把其他扩展名映射到这些语言。
每个版本为每个平台提供一个压缩包,并附带 SHA256SUMS 文件和每个压缩包的构建来源证明。
| 平台 | Target | 压缩包 |
|---|---|---|
| Linux x86_64已发布 | x86_64-unknown-linux-musl | .tar.gz |
| Linux ARM64已发布 | aarch64-unknown-linux-musl | .tar.gz |
| macOS Intel已发布 | x86_64-apple-darwin | .tar.gz |
| macOS Apple Silicon已发布 | aarch64-apple-darwin | .tar.gz |
| Windows x86_64已发布 | x86_64-pc-windows-msvc | .zip |
| Windows ARM64已发布 | aarch64-pc-windows-msvc | .zip |
Linux 版本是静态链接的,不依赖任何系统库。从源码构建需要 Rust 工具链和 C 编译器。
CodeGraph 不依赖任何托管服务。
联网内容不联网
索引是项目中的一个 SQLite 数据库,解析、引用匹配和所有查询都在本机进行。
联网内容不联网
MCP 服务只与启动它的程序通信,HTTP 服务和查看器只在本机监听。
联网内容从 GitHub 下载
安装脚本和 codegraph self-update 从 GitHub Releases 下载发布版本。
curl -fsSL https://raw.githubusercontent.com/sunerpy/codegraph-rust/main/scripts/install.sh | shirm https://raw.githubusercontent.com/sunerpy/codegraph-rust/main/scripts/install.ps1 | iexcargo install --locked --git https://github.com/sunerpy/codegraph-rust codegraph-rs安装脚本在安装前会用该版本的 SHA256SUMS 校验每个压缩包。安装指南介绍了如何安装指定版本、更新和卸载。
问题报告和功能建议请提交到 GitHub Issues。使用微信扫码,可以关注公众号「六月水蓝」。CodeGraph 以 MIT 许可发布。
