codegraph

给 AI 编程助手一张实时更新的代码地图

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署编程开发 🍴 复刻 5099 🐛 待处理 254 👀 关注 173

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 76770

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源免费，本地运行

项目预览

项目数据

分类编程开发

开发团队colbymchenry

官网地址https://colbymchenry.github.io/codegraph

GitHubhttps://github.com/colbymchenry/codegraph

定价模式🏷️完全免费

价格说明开源免费，本地运行

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言TypeScript

GitHub 星标★ 76770

上线时间2026-01-18 00:00:00

代码更新2026-11-01

仓库体积47.2 MB

本站数据更新2026-11-06

维护状态活跃

收录时间2026-11-06

浏览次数0

项目介绍

codegraph 是一个面向 AI 编程助手的代码知识图谱工具，用 TypeScript 编写。它把代码库预先索引成结构化的知识图谱，并在代码变更时自动同步，让 Claude Code、Codex、Gemini、Cursor、OpenCode、AntiGravity、Kiro、CoPilot、Hermes Agent 等智能体在理解项目时少走弯路。核心能力包括：跨文件符号与依赖关系建模、增量更新索引、为智能体提供精简而准确的上下文，从而减少 token 消耗和工具调用次数。所有索引与查询都在本地完成，代码不上传，适合对隐私敏感或代码规模较大的团队。它解决的是 AI 助手在大型仓库中检索效率低、上下文碎片化、反复调用工具的问题，相当于给智能体装了一张可随时更新的项目地图。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-11-06 · 当前星标 ★ 76770

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

能运行 npx 的终端环境（Quick Start 用 npx 运行安装器）
支持的 AI 编程助手之一，如 Claude Code、Cursor、Codex CLI、Gemini CLI、GitHub Copilot 等
如需在自己的 Node 进程中嵌入库用法，需 Node 22.5+（CLI 与 MCP 服务使用自带运行时，不受此限制）
本地待索引的项目代码目录

安装与启动步骤

1运行安装器

在终端执行交互式安装器，它会自动检测本机已安装的智能体并询问配置项。
```
npx @colbymchenry/codegraph
```
2按提示选择智能体

依次选择要接入的智能体、是否把 codegraph 装到 PATH、配置作用于全局还是当前项目。
3非交互安装

脚本或 CI 场景可用参数跳过交互，用 --target 指定智能体列表。
```
codegraph install --yes
codegraph install --target=cursor,claude --yes
codegraph install --yes --init
```
4为项目建索引

安装器只写智能体配置、不索引代码；每个项目需单独执行一次初始化生成索引。
```
codegraph init
```
5查看配置片段

只打印某个智能体的 MCP 配置片段、不写文件，便于核对接入内容。
```
codegraph install --print-config codex
```
6卸载与升级

卸载会先列出所有已安装形态再删除；--keep-cli 只清智能体配置。项目索引用 uninit 清理。
```
codegraph upgrade
codegraph uninstall --keep-cli
codegraph uninit
```

关键配置

配置项	必填	说明	示例
`exclude`	否	排除已提交但不想索引的目录，gitignore 风格，按仓库根相对路径匹配	`{"exclude": ["static/", "/vendor/"]}`
`include`	否	强制把被 .gitignore 排除的真实源码纳入索引，显式 exclude 仍优先	`{"include": ["Tools/", "Local/typescript/"]}`