Integrations

The interactive installer auto-detects and configures each supported agent — wiring up the MCP server, writing its instructions file, and installing the shared codegraph-workspace skill for global installs.

Supported agents

Claude Code
Cursor
Codex CLI
opencode
Hermes Agent

Run npx @colbymchenry/codegraph and pick your agent(s); see Installation for the non-interactive flags.

After installing and indexing a project, run codegraph doctor --target=<agent> --location=global to verify the selected agent config, shared skill, MCP launch, and index health from the installed runtime.

Manual setup

If you’d rather wire it up yourself, install globally:

npm install -g @colbymchenry/codegraph

Add the MCP server to ~/.claude.json:

{
  "mcpServers": {
    "codegraph": {
      "type": "stdio",
      "command": "codegraph",
      "args": ["serve", "--mcp"]
    }
  }
}

Optionally auto-allow the read-only tools in ~/.claude/settings.json:

{
  "permissions": {
    "allow": [
      "mcp__codegraph__codegraph_search",
      "mcp__codegraph__codegraph_context",
      "mcp__codegraph__codegraph_callers",
      "mcp__codegraph__codegraph_callees",
      "mcp__codegraph__codegraph_impact",
      "mcp__codegraph__codegraph_node",
      "mcp__codegraph__codegraph_explore",
      "mcp__codegraph__codegraph_status",
      "mcp__codegraph__codegraph_files",
      "mcp__codegraph__codegraph_trace"
    ]
  }
}