Get Started
Get up and running with CodeGraph in seconds.
1. Install the CLI
Section titled “1. Install the CLI”No Node.js required — one command grabs the right build for your OS:
# macOS / Linuxcurl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh
# Windows (PowerShell)irm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1 | iexAlready have Node? npm i -g @colbymchenry/codegraph works on any version. 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.
2. Wire up your agent(s)
Section titled “2. Wire up your agent(s)”codegraph installAuto-detects and 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 step connects your agents only; it does not index any code. (Shortcut: npx @colbymchenry/codegraph downloads and runs the installer in one go.)
3. Initialize each project
Section titled “3. Initialize each project”cd your-projectcodegraph initcodegraph init creates the local .codegraph/ directory and builds the full graph in the same step — one command, done. Your agent will use CodeGraph tools automatically when a .codegraph/ directory exists.
Next: build Your First Graph, or see the full Installation options.