Pre-indexed code knowledge graph
for your AI coding agent.

Extraction

tree-sitter parses every source file into an AST. Per-language queries lift out nodes (functions, classes, methods, types) and edges (calls, imports, extends, implements). 19+ languages share the same pipeline.

// per-language query (TypeScript)
(call_expression
  function: (identifier) @callee)            ; emits a call edge

(class_declaration
  name: (type_identifier) @name
  body: (class_body) @body)                  ; emits a class node

Storage — SQLite + FTS5

Everything goes into a single file at .codegraph/codegraph.db. Symbol names are mirrored into an FTS5 virtual table so name lookups are instant across millions of symbols. WAL journaling lets concurrent reads never block on writes.

CREATE TABLE nodes (
  id        INTEGER PRIMARY KEY,
  kind      TEXT,        -- function | class | method | route ...
  name      TEXT,
  file_id   INTEGER,
  range     TEXT         -- start/end line+col
);

CREATE TABLE edges (
  src       INTEGER,
  dst       INTEGER,
  rel       TEXT         -- calls | imports | extends | references ...
);

CREATE VIRTUAL TABLE nodes_fts
  USING fts5(name, content='nodes');

Resolution

After extraction, references are resolved across files: foo() → its definition; import { X } → source module; class inheritance chains; framework-specific routing (Django path(), Express app.get(), NestJS @Controller + @Get, Rails routes, Spring @GetMapping, …).

The result is a traversable graph: callers(X) returns the set of functions that actually call X, including hops through dynamic dispatch, interfaces, callbacks, and re-render boundaries that grep misses.

Auto-sync

The MCP server subscribes to native OS file events (FSEvents on macOS, inotify on Linux, ReadDirectoryChangesW on Windows). Changes are debounced with a 2-second quiet window, filtered to source extensions, and incrementally re-indexed — only touched files re-parse. The graph stays current as you code, zero config.

watcher.on('change', debounce(2000, files => {
  const sources = files.filter(isSupportedExt);
  cg.syncFiles(sources);   // re-parse + re-link only the dirty set
}));