Scan a project directory and build the knowledge graph from code files. Uses tree-sitter AST (with regex fallback) for all code files. Fast, local, no API key needed. Run once per project; rebuild whenever code changes.

Ask a structural question about the codebase OR look up a specific node by name — or both in one call. Pass question for natural-language traversal: what calls X, what does module Y depend on. Pass node for fast single-node lookup: returns type, file, depends_on, used_by. Pass both to get node detail + surrounding graph context together. Returns structured text within token_budget. Use before reading any files.

Build a bounded, token-budgeted context subgraph for an AI coding task. Finds query-matching seed nodes, expands callers/dependencies/imports up to max_hops, ranks candidates, and returns compact nodes, relationship paths, budget usage, candidate counts, and per-item drop reasons.

Return CODEGRAPH_REPORT.md — god nodes, clusters, surprising connections, suggested questions.

List all nodes of a given type, sorted by PageRank (most connected first).

Generate interactive vis.js HTML graph visualization. Dark theme, search box, community toggle, click-to-inspect node panel. Outputs codegraph-cache/graph.html. Also generates graph.graphml and obsidian/ vault.

BFS traversal: given a node name, find every node that would be affected if you change it — callers, importers, inheritors, etc. Use before refactoring to understand blast radius. Returns affected nodes with file paths, relation types, and traversal depth.

Filter graph nodes by semantic properties. Results sorted by PageRank (most connected first). All filters optional — combine freely. node_type: function|class|module|file. exported/side_effect: bool. return_type: substring match. called_by/calls: node name. file_pattern: glob. token_budget: max tokens in response.

Return a module map: every file with its exported functions/classes and what it imports. Use this to understand project structure without reading any files. Call after codegraph_build. Much faster than reading each file.