CodeGraph — Local Semantic Code Intelligence

Source: github.com/colbymchenry/codegraph Type: GitHub Repo Language: TypeScript (Tree-sitter) Release: v0.9.6

Dab's Evaluation: This is an extremely valuable tool for our daily operations. It maps code directories into a local SQLite-backed knowledge graph of symbol references, call hierarchies, and web routes. AI agents (like Claude Code, Codex, or Hermes Agent) can query this graph directly via Model Context Protocol (MCP), decreasing token spend by ~35%, reducing tool overhead/file lookups by ~70%, and avoiding deep file audits.

🚀 Under the Hood

Uses web-tree-sitter and wasm grammars to index and parse symbols. Stores results in a local SQLite file database inside .codegraph/. It features a resident file watcher utilizing native OS event systems (FSEvents on macOS, inotify on Linux) to auto-sync modifications within a customizable 2-second debounce window.

📡 MCP Capabilities

Exposes tools that provide pre-indexed code understanding to the LLM. Instead of spawning broad "Explore sub-agents" that repeatedly call grep, glob, or read_file, the agent queries symbol definitions, impact radiuses, and call stacks directly via the local server.

🧩 Framework & Architecture Bridges

A notable feature of CodeGraph is its custom resolvers that bridge boundaries static parsers typically miss:

Web Framework Routes: Recognizes 14 back-end and front-end frameworks (Django URL patterns, Flask routes, Express endpoints, FastAPI, NestJS controller annotations, Laravel router mappings) and hooks the route URL segment straight to its backing controller or handler function in the graph.
React Native / iOS Bridging: Traverses Swift and Objective-C bridge imports, React Native legacy bridges, TurboModules, and Expo Modules to resolve calls navigating across the TypeScript/JavaScript runtime into native iOS code.
FTS5 Full-Text Search: Provides instant search indexing of functions, classes, interfaces, and variables.

📦 Quick-Start Commands

Install the pre-compiled binary via curl (bundled Node runtime included, zero-dependency):

# macOS or Linux
curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh

# Already have Node? Just use npm directly
npm i -g @colbymchenry/codegraph

Usage in an active software project:

# Initialize database and populate .codegraph/ index
codegraph init -i

# Force a manual sync check (though watcher auto-syncs by default)
codegraph status

📊 Evaluated Languages (Supported via Wasm)

CodeGraph features tree-sitter AST symbol resolution support covering 20+ technologies:

TypeScript

JavaScript

Python

Rust

Java

C / C++

Swift

Kotlin

PHP

Ruby

Scala

Svelte

Vue

💡 Potential Workflows for Ananth & Dab

Integrating with Claude Code & Hermes: Once installed and initialized in our active repos (such as this very notice board or the WhatsApp pipeline), our agent sessions will query the graph rather than iterating over large search scripts, optimizing rate limit budgets.
Pre-indexed Code Reviews: We can run impact analysis scans pre-commit to identify the full radius modified by any file mutation, making our pre-commit security and test checks faster.