# 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.

This is a Grok-Wiki source-grounded repository wiki. Use the complete Markdown link when an agent needs the full repo context.

## Context Links

- [Complete Markdown wiki](https://grok-wiki.com/public/wiki/colbymchenry-codegraph-89e8b2c4d43a/llms-full.txt)
- [Complete Markdown alias](https://grok-wiki.com/public/wiki/colbymchenry-codegraph-89e8b2c4d43a.md)
- [Human interactive wiki](https://grok-wiki.com/public/wiki/colbymchenry-codegraph-89e8b2c4d43a)
- [GitHub repository](https://github.com/colbymchenry/codegraph)

## Repository

- Repository: colbymchenry/codegraph

- Generated: 2026-05-22T16:27:32.272Z
- Updated: 2026-05-22T16:36:41.406Z
- Runtime: Codex CLI
- Format: First 30 Minutes
- Pages: 6

## Pages

- [Start Here](https://grok-wiki.com/public/wiki/colbymchenry-codegraph-89e8b2c4d43a/pages/01-start-here.md): What 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 Targets](https://grok-wiki.com/public/wiki/colbymchenry-codegraph-89e8b2c4d43a/pages/02-cli-installer-agent-targets.md): The 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 Workflow](https://grok-wiki.com/public/wiki/colbymchenry-codegraph-89e8b2c4d43a/pages/03-mcp-tools-context-workflow.md): How 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 Pipeline](https://grok-wiki.com/public/wiki/colbymchenry-codegraph-89e8b2c4d43a/pages/04-indexing-language-extraction-pipeline.md): The 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 Routes](https://grok-wiki.com/public/wiki/colbymchenry-codegraph-89e8b2c4d43a/pages/05-reference-resolution-framework-routes.md): How 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 Next](https://grok-wiki.com/public/wiki/colbymchenry-codegraph-89e8b2c4d43a/pages/06-freshness-storage-what-to-try-next.md): The 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.

## Source Files

- `__tests__/extraction.test.ts`
- `__tests__/frameworks.test.ts`
- `__tests__/installer-targets.test.ts`
- `__tests__/mcp-initialize.test.ts`
- `__tests__/mcp-roots.test.ts`
- `package.json`
- `README.md`
- `src/bin/codegraph.ts`
- `src/bin/node-version-check.ts`
- `src/config.ts`
- `src/context/formatter.ts`
- `src/context/index.ts`
- `src/db/index.ts`
- `src/db/queries.ts`
- `src/db/schema.sql`
- `src/db/sqlite-adapter.ts`
- `src/directory.ts`
- `src/extraction/grammars.ts`
- `src/extraction/index.ts`
- `src/extraction/languages/python.ts`
- `src/extraction/languages/typescript.ts`
- `src/extraction/parse-worker.ts`
- `src/extraction/tree-sitter-types.ts`
- `src/extraction/tree-sitter.ts`
- `src/graph/queries.ts`
- `src/graph/traversal.ts`
- `src/index.ts`
- `src/installer/index.ts`
- `src/installer/targets/claude.ts`
- `src/installer/targets/codex.ts`
- `src/installer/targets/registry.ts`
- `src/installer/targets/types.ts`
- `src/mcp/index.ts`
- `src/mcp/server-instructions.ts`
- `src/mcp/tools.ts`
- `src/mcp/transport.ts`
- `src/resolution/frameworks/express.ts`
- `src/resolution/frameworks/index.ts`
- `src/resolution/import-resolver.ts`
- `src/resolution/index.ts`
- `src/resolution/name-matcher.ts`
- `src/resolution/path-aliases.ts`
- `src/resolution/types.ts`
- `src/sync/git-hooks.ts`
- `src/sync/watcher.ts`
- `src/types.ts`