MCPcopy Create free account
hub / github.com/colbymchenry/codegraph

github.com/colbymchenry/codegraph

Chat with this repo
repository ↗ · DeepWiki ↗ · release v1.6.3 ↗ · + Follow · compare 7 versions
14,398 symbols 62,941 edges 1,486 files 4,470 documented · 31% ● updated todayv1.6.3 · 2026-11-17★ 78,023134 open issues

Browse by type

⨍ Functions 12,468◇ Types & classes 1,929↳ Endpoints 1
What it actually does AI analysis from the code graph — generated when you open this
loading…
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

Rust

  Kernel powered by Rust

Documentation & Website →

npm version License: MIT Self-contained npm provenance Attested builds

Windows macOS Linux

Claude Code Cursor Codex opencode Hermes Agent Gemini Antigravity Kiro GitHub Copilot IBM Bob Factory Droid Windsurf Qwen Code DeepSeek Harness Grok Build Kimi Code Qoder Pi

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.

Join the waitlist for early beta access

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

Contents

Get Started

1. Install the CLI

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

# 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)

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 <version> to pin one. After an upgrade, codegraph status and your agent tell you when a project's index was built by an older version: run codegraph index there to rebuild it.

2. Wire up your agent(s)

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

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

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. CodeGraph watches the project and updates the graph on every file change — while your agent edits code, or you add, modify, or delete files. The index is never stale, and there is nothing to re-run.

Uninstall

Changed your mind? One command removes CodeGraph from every agent it configured and the CLI itself — every install it finds (standalone bundle, npm global package, launcher link), shown to you before anything is deleted:

codegraph uninstall

Pass --keep-cli to remove only the agent configurations and keep the CLI installed.

Reverses the installer — strips CodeGraph's MCP server config, instructions, and permissions from each configured agent. Your project indexes (.codegraph/) are left untouched; remove those per-project with codegraph uninit. Use --target to remove from specific agents, or --yes to run non-interactively.


Language Support

Every language below gets the same treatment — full structural extraction and cross-file resolution into one graph, no per-language setup:

TypeScript JavaScript ArkTS Python Go Rust Java C# PHP Ruby C C++ Objective-C Metal CUDA Swift Kotlin Scala Dart Svelte Vue Astro Liquid Pascal / Delphi Lua R Luau CFML COBOL Visual Basic .NET Erlang Solidity Terraform / OpenTofu Nix

Per-language details — extensions, frameworks, and what exactly gets extracted — in Supported Languages.


Why CodeGraph?

When an AI agent needs to understand code — to answer a question or make a change — it discovers structure the slow way: grep, glob, and Read, one file at a time, rebuilding call paths and dependencies by hand. That's a pile of tool calls and round-trips before it even starts the real work.

CodeGraph hands the agent the exact code it needs in one call. It's a pre-built knowledge graph of every symbol, call edge, and dependency in your codebase — so instead of crawling files, the agent asks one question and gets back the relevant source, the call paths between those symbols (including dynamic-d

Extension points exported contracts — how you extend this code

browse all types & interfaces →

Core symbols most depended-on inside this repo

browse all functions →

Shape

Function 8,647
Method 3,821
Interface 1,349
Class 478
Struct 49
Enum 36
TypeAlias 15
FuncType 2
Route 1

Languages

TypeScript86%
Rust8%
Go1%
C1%
C++1%
Kotlin1%

Modules by API surface

__tests__/fixtures/tail-render-ts/types/worker-configuration.d.ts1,261 symbols
src/mcp/tools.ts247 symbols
src/db/queries.ts231 symbols
src/extraction/tree-sitter.ts207 symbols
src/resolution/callback-synthesizer.ts180 symbols
src/resolution/import-resolver.ts162 symbols
src/index.ts150 symbols
src/resolution/index.ts143 symbols
src/resolution/frameworks/react.ts129 symbols
src/extraction/index.ts115 symbols
codegraph-kernel/src/ccpp/mod.rs112 symbols
src/resolution/vbnet-receivers.ts102 symbols

Dependencies from manifests, versioned

@astrojs/starlight0.39.2 · 1×
@clack/prompts1.3.0 · 1×
@fontsource-variable/archivo5.3.0 · 1×
@fontsource/ibm-plex-mono5.3.0 · 1×
@sveltejs/package2.5.8 · 1×
@sveltejs/vite-plugin-svelte6.2.4 · 1×
@types/node20.19.30 · 1×
@types/picomatch4.0.2 · 1×
@xyflow/svelte1.6.5 · 1×
astro6.3.1 · 1×
chart.js4.4.0 · 1×
commander14.0.2 · 1×

Datastores touched

(mysql)Database · 1 repos

For agents

$ claude mcp add codegraph \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page