Agent-readable wiki
CodeGraph First 30 Minutes Wiki
A fast orientation map for CodeGraph, a local TypeScript CLI and MCP server that indexes code into a SQLite-backed semantic graph for agent-friendly search, context, and impact analysis. The structure emphasizes source-backed entry points, provider-neutral agent integration, and the implementation boundaries a new contributor should understand first.
Pages
- Start HereWhat this repo is, the fastest read order, the first files to open, and the vocabulary behind nodes, edges, projects, tools, and local-first indexing.
- CLI, Installer & Agent TargetsThe command surface a new reader should try first: interactive install, project init, indexing, sync, status, query, context, serve, affected tests, and portable agent config writers for Claude Code, Cursor, Codex CLI, and opencode.
- MCP Tools & Context WorkflowHow CodeGraph exposes provider-neutral code intelligence through stdio JSON-RPC tools, why codegraph_context is the primary workflow, and how search, callers, callees, impact, explore, node, status, and files fit together.
- Indexing & Language Extraction PipelineThe pipeline from project files to graph records: git-aware scanning, include and exclude filters, language detection, tree-sitter WASM loading, worker-based parsing, extraction results, and tests that prove supported language behavior.
- Reference Resolution & Framework RoutesHow unresolved references become graph edges through import resolution, name matching, path aliases, framework detectors, and route resolvers for web frameworks across JavaScript, Python, Ruby, Java, Go, Rust, C#, Swift, PHP, Svelte, and Vue.
- Freshness, Storage & What to Try NextThe closing map for the first 30 minutes: understand the SQLite schema, query and traversal layers, file watcher, git hook sync path, safety checks, and the concrete next experiments that prove the local graph is fresh and useful.
Complete Markdown
The complete agent-readable Markdown files are published separately from this HTML page.