README

CodeGraph

Already installed? Run codegraph upgrade

Follow @getcodegraph on X for updates.

 Supercharge Claude Code, Cursor, Codex, OpenCode, Hermes Agent, Gemini, Antigravity, Kiro, GitHub Copilot, and more with Semantic Code Intelligence

The fastest complete code graph · surgical context · built for how agents actually work · 100% local


  
  
  Kernel powered by Rust

 Documentation & Website →
































The CodeGraph platform is coming — for every PR, know exactly what to test, what could break, which flows are affected, and whether business logic is compromised.



Get early beta access to the hosted product · getcodegraph.com



 Contents

- Get Started
- Language Support
- Why CodeGraph?
- Key Features
- Framework-aware Routes
- Mixed iOS / React Native / Expo bridging
- Quick Start
- How It Works
- CLI Reference
- MCP Tools
- Library Usage
- Configuration
- Telemetry
- Verified releases
- Supported Platforms
- Supported Agents
- Supported Languages
- Measured cross-file coverage
- Troubleshooting
- Contributing
- License

 Get Started

 1. Install the CLI

No Node.js required — one command grabs the right build for your OS:

bash
 macOS / Linux
curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh

 Windows (PowerShell)
irm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1 | iex



Already have Node? Use npm instead (works on any version)

bash
npm i -g @colbymchenry/codegraph


CodeGraph bundles its own runtime — nothing to compile, no native build, works the same everywhere. The installer puts codegraph on your PATH but doesn't change your current shell — open a new terminal before the next step so the command resolves.

Upgrade any time with codegraph upgrade — it detects how you installed (bundle, npm, or npx) and updates in place. Add --check to see if an update is available, or codegraph upgrade  to pin one.



 2. Wire up your agent(s)

In a new terminal, run the installer to connect CodeGraph to the agents you use:

bash
codegraph install


Detects and auto-configures Claude Code, Cursor, Codex CLI, opencode, Hermes Agent, Gemini CLI, Antigravity IDE, Kiro, GitHub Copilot (VS Code, Copilot CLI, JetBrains IDEs), IBM Bob, Factory Droid, Windsurf, Qwen Code, DeepSeek Harness, Grok Build, Kimi Code, Qoder CLI, and Pi — wiring the CodeGraph MCP server into each. This is the step that connects CodeGraph to your agent; installing the CLI in step 1 does not do it on its own. It only wires up your agent — it does not index any code; building each project's graph is the separate codegraph init in step 3. (Shortcut: npx @colbymchenry/codegraph downloads and runs this in one go.)

 3. Initialize each project

bash
cd your-project
codegraph init


codegraph init creates the local .codegraph/ directory and builds the full graph in the same step — one command, done.



!1_C_VYnhpys0UHrOuOgpgoyw



 4. No more syncing!

Auto-sync is enabled by default. CodeG

Top issues

Latest release

[1.6.2] - 2026-10-03

 Highlights

- Far fewer wrong links, in every language. A call, import or type now resolves the way its language scopes names — through imports, packages, namespaces and the class it is written in — so it stops landing on an unrelated symbol that only shares its name. This covers TypeScript and JavaScript, Python, Java, Kotlin, Scala, C, VB.NET, Swift, Objective-C, Go, Rust, C and C++, PHP, Ruby, Dart, Lua, R and more, and makes callers, impact and codegraph_explore answers more trustworthy.
- Overloads, super and recursion resolve correctly. A call reaches the overload