CodeGraph

CodeGraph is an independent project under the MIT license, created and maintained by Colby McHenry. It is not part of maestria.

What It Is

CodeGraph is a local-first code intelligence tool. It parses your codebase into a queryable SQLite knowledge graph using tree-sitter WASM parsers, and the index auto-syncs via an OS file watcher as you edit.

Everything runs locally with no network access. CodeGraph exposes an MCP server with a codegraph_explore tool that agents query instead of running grep or read loops. One call returns the verbatim source of relevant symbols, the call path among them, and a blast-radius summary.

It supports 20+ languages including TypeScript, JavaScript, Python, Go, Rust, Java, and C#.

Why Use It Alongside maestria

One codegraph_explore call replaces 5-10 separate grep and read operations during reconnaissance. maestria supplies the workflow; CodeGraph handles codebase access within it.

Installation

Three options:

1. npm global install: npm install -g @colbymchenry/codegraph@latest
2. Run without install:
   npm

   npx @colbymchenry/codegraph@latest

   yarn

   yarn dlx @colbymchenry/codegraph@latest

   pnpm

   pnpx @colbymchenry/codegraph@latest

   bun

   bunx @colbymchenry/codegraph@latest

   deno

   deno x @colbymchenry/codegraph@latest

   ni

   nlx @colbymchenry/codegraph@latest

3. Standalone installer: Download from the GitHub releases page

Quick Start

Run codegraph init in your project root. Once indexed, agents can query CodeGraph via its MCP server.

Resources

Official DocsFull documentation for CodeGraph: configuration, language support, and API reference.

GitHub RepositorySource code, issues, and releases.