Ops Codegraph Tool

How to Set Up and Use Ops Codegraph Tool

Ops Codegraph Tool (codegraph) is a code intelligence CLI and 34-tool MCP server that builds a function-level dependency graph across 34 programming languages and exposes it to AI agents for deep codebase understanding. It provides capabilities including symbol location, call chain tracing, blast radius analysis for proposed changes, cyclomatic and cognitive complexity metrics, circular dependency detection, architecture boundary enforcement via manifesto rules, hybrid BM25 and semantic search, and git co-change analysis — all with sub-second incremental rebuilds at 4.4 ms per file using a native Rust engine. Developers use it to give AI coding agents reliable, structured context before and after making changes, dramatically reducing hallucination and missed dependencies.

npm install -g @optave/codegraph

cd /path/to/your/project
codegraph build

{
  "include": ["src/**"],
  "exclude": ["**/*.test.js", "**/*.spec.ts"],
  "ignoreDirs": ["node_modules", ".git", "dist"],
  "aliases": { "@/": "./src/" },
  "build": { "incremental": true }
}

# Single-repo mode (default)
codegraph mcp

# Multi-repo mode
codegraph mcp --multi-repo

{
  "mcpServers": {
    "codegraph": {
      "command": "codegraph",
      "args": ["mcp"],
      "env": {
        "CODEGRAPH_LLM_API_KEY": "your-openai-api-key-for-semantic-search"
      }
    }
  }
}

{
  "mcpServers": {
    "codegraph": {
      "command": "codegraph",
      "args": ["mcp"],
      "env": {
        "CODEGRAPH_LLM_API_KEY": "sk-your-openai-api-key"
      }
    }
  }
}

- "Find where handleAuth is defined and show me all its callers before I modify it"
- "What is the blast radius of changing the UserRepository.findById function?"
- "Show me the shortest call path between the API gateway and the database connection pool"
- "Detect all circular dependencies in the src/modules directory"
- "Analyze the cognitive complexity of my top 10 most complex functions and suggest refactoring priorities"
- "Show me which files are most historically co-changed with auth/login.ts in git history"