CodeGraph
github.com/colbymchenry/codegraph- Category
- Developer Tools
- Rank
- No. 273Tools index
- Type
- APP
- Builder
- colbymchenry
- GitHub
- 71.0k stars
- Latest release
- v1.6.0
- Date
About
A pre-indexed code knowledge graph that auto-syncs on changes, for Claude Code and other agents.
What it does
CodeGraph parses a project into symbols and relationships, stores them locally, then combines full-text search with graph traversal to assemble focused context for coding tasks. A filesystem watcher incrementally reconciles added, changed, and removed source files.
Why it's ranked here
CodeGraph has unusual breadth for a local coding-agent companion. It offers a CLI, an MCP server, and an embeddable TypeScript interface, while its SQLite storage, cross-process locking, worker recycling, daemon sharing, and incremental reconciliation show attention to real operational failure modes.
What's good
The context builder limits search results, traversal depth, nodes, and code blocks by default, which helps control prompt size. Parsing runs through worker threads with timeouts and recycling. Shared MCP clients can use one detached daemon, watcher, and database connection instead of duplicating them.
Tradeoffs
Every project requires explicit initialization and its own local index. Files larger than one megabyte are skipped, while dependency, build, cache, coverage, and several generated-output directories are excluded by default. Watchers may be disabled in some environments, with optional Git hooks offered as a fallback.
How to use it well
Use CodeGraph for agents that repeatedly investigate symbol relationships, call paths, relevant files, and task context inside substantial repositories. Initialize each active project, keep automatic synchronization enabled, and ask with exact symbol names when possible. It does not provide the announced hosted pull-request analysis platform.
Technical notes+
package.json defines the npm package, CLI binary, declaration entry, TypeScript build, Vitest scripts, and bundled WASM asset copying. src/index.ts exposes the main facade plus database, query, extraction, synchronization, error, and MCP building blocks. src/extraction/index.ts coordinates scanning, worker-thread parsing, size and ignore policies, storage, and reference resolution. src/db/index.ts configures SQLite with WAL, migrations, full-text-search healing, bulk-load index management, and oversized-WAL recovery. src/context/index.ts combines full-text search, graph traversal, code extraction, confidence handling, and Markdown or JSON formatting. src/mcp/index.ts selects direct, proxy, or detached-daemon operation over stdio and local sockets or named pipes. src/sync/index.ts exports filesystem watching, Git hook support, watch policy, and worktree mismatch handling.
Observed
- License
- MIT
- Primary language
- TypeScript
- Package
- Published as @colbymchenry/codegraph with a command-line binary and TypeScript declarations
- Interfaces
- CLI, TypeScript library, and MCP server
- Platforms
- Windows, macOS, and Linux
- Installation
- Standalone bundled-runtime installers or global npm installation
- Storage
- Per-project local SQLite database using WAL mode
Read from README.md, package.json, src/index.ts, src/db/index.ts, src/mcp/index.ts, src/sync/index.ts, src/graph/index.ts, src/context/index.ts, src/upgrade/index.ts, src/installer/index.ts, src/extraction/index.ts.
Intel on CodeGraph
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.