Quick reference
The tables below summarise key dimensions. Direct alternatives compete in the same category. Complementary tools solve adjacent problems and work alongside jCodeMunch.
Direct Alternatives — tools in the same category
| jCodeMunch + jDocMunch | Raw File Tools (Read/Grep/Glob/Bash) |
mcp-server-filesystem | RepoMapper | Pharaoh | GitNexus | Serena | GrapeRoot (Dual-Graph) | vexp | code-review-graph | cymbal | Context+ | Axon | SocratiCode | Octocode | Repomix | codebase-memory-mcp | CodeGraph | SigMap | trace-mcp | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Token reduction on code exploration | ✓ ~95 % | ✗ 0 % (baseline) | ✗ 0 % | ~ Token-budgeted map (not retrieval) | ~ Graph queries replace file reads (no benchmark published) | ~ Graph queries; no benchmarks published | ~ Symbol-level tools reduce reads; no token benchmarks published | ~ 30–45% cost reduction (80-prompt benchmark); pre-loads context, not symbol-level retrieval | ~ 65–70% claimed; no published methodology or reproducible benchmark | ~ 8.2× avg on commit-scoped reviews (6 repos, 13 commits, published raw data); 0.7× on small single-file express changes (graph context exceeds raw file); 49× claimed for large monorepos | ~ 17–100% fewer tokens vs ripgrep (self-reported); baseline is ripgrep, not raw file reads — not directly comparable to jCodeMunch's 58–100× benchmark; no published methodology or reproducible test harness | ~ "99% accuracy" claimed; no token-reduction benchmark published; no reproducible methodology | ~ Precomputed graph returns "complete context in one tool call"; claims token efficiency via fewer agent hops; no published benchmark or reproducible methodology | ~ 61% less tokens, 84% fewer calls, 37× faster than standard AI grep (self-reported benchmark); baseline is grep, not raw file reads | ~ Retrieval-quality benchmark on 254 hand-annotated queries (127 code + 127 docs): code Hit@10 = 0.992 / MRR = 0.895; docs Hit@10 = 0.953 / MRR = 0.776. Methodology in benchmark/. No token-savings claim against file reads. |
~ Single-shot pack of the whole repo; --compress strips bodies via tree-sitter; pack ships in every prompt — no per-query reduction |
~ "120× fewer tokens" claimed (5 structural queries: ~3,400 vs ~412,000 file-by-file); arXiv preprint cites 10× tokens, 83% answer quality on 31 repos | ~ "94% fewer tool calls, 71% faster" on 6-codebase Claude-Code Explore-agent benchmark; per-query token deltas not separated from call-count deltas | ~ "40–98% token reduction" claimed (avg 96.8% on 18 repos); baseline is whole-repo dump, not file-by-file reads | ~ "40–50% token reduction" / "one call replaces ~42 min of exploration" claimed (self-reported); no published reproducible benchmark vs raw file reads |
| Symbol-level extraction (functions, classes) | ✓ 70+ languages (incl. YAML/Ansible, Razor/Blazor, SQL/dbt, Erlang, Fortran, Pascal, MATLAB, Ada, COBOL, Zig, PowerShell) | ✗ Whole-file only | ✗ Whole-file only | ~ Signatures only, no retrieval | ~ Signatures + graph nodes; TypeScript & Python only | ✓ 12 languages; graph nodes + call edges | ✓ 30+ languages via LSP; type-aware cross-file references | ~ Symbols & imports extracted for graph ranking; no on-demand per-symbol retrieval | ~ 30 languages via tree-sitter; skeleton generation strips bodies (70–90%); no named on-demand per-symbol retrieval | ~ 19 languages + Jupyter/Databricks notebooks via tree-sitter; graph nodes (functions, classes, imports) + edges (calls, inheritance, test coverage); no named on-demand per-symbol retrieval | ✓ 20 parseable languages via tree-sitter; named on-demand per-symbol retrieval (cymbal show); Go binary, no Python runtime required |
✓ 43 languages via tree-sitter; AST extraction with semantic search; spectral clustering groups related files | ~ 3 languages (Python, JavaScript, TypeScript) via tree-sitter; graph nodes for functions, classes, imports; KuzuDB graph storage with Cypher queries | ~ Language-agnostic with ast-grep AST-aware chunking for 18+ languages (line-based fallback elsewhere); Qdrant vector store; polyglot dependency graph with circular-dep detection | ~ 14 languages via tree-sitter (Rust, Python, TS/JS, Go, PHP, C++, Ruby, Java, Lua, Svelte, JSON, CSS, Bash, Markdown); knowledge-graph nodes with 11+ relationship types (imports, calls, implements, extends, configures, ...) and importance weighting | ~ Whole-file pack; --compress extracts signatures via tree-sitter (~70–90% body strip); no on-demand per-symbol retrieval |
✓ 155 vendored tree-sitter grammars; functions/classes/routes as graph nodes; LSP-style hybrid type resolution for Go, C, C++, TS/JS/JSX/TSX | ✓ 19+ languages via tree-sitter; symbols + framework-aware route nodes (13 frameworks: Django, Flask, FastAPI, Express, Laravel, Rails, Spring, Gin, Axum, ASP.NET, Vapor, React Router, SvelteKit) | ~ 19+ languages; signature extraction (no bodies); writes compact signatures to a .context file rather than offering an on-demand symbol-retrieval API |
✓ AST-first via tree-sitter; framework request-flow nodes layered on via 15+ framework plugins + 7 ORM adapters |
| Doc section search | ✓ via jDocMunch | ✗ Whole-file only | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✓ Documentation corpus indexed as a separate searchable surface alongside code | ✗ | ✗ Code graph only | ✗ Code graph only | ✗ Signatures only | ~ Indexes markdown vaults into the same graph; no dedicated section-level doc-retrieval surface |
| Requires pre-indexing | ✓ One-time, incremental; SHA-based freshness managed automatically via freshness_mode config (relaxed/strict); list_repos exposes git_head for agent-side freshness reasoning; index_file for single-file surgical updates; watch-claude auto-discovers Claude Code worktrees |
✓ None needed | ✓ None needed | ~ Per-query map generation | ~ Hosted backend; auto-updates on push via webhook | ~ One-time + auto-reindex on git commit via hook | ~ LSP servers spin up on first use; indexing latency per language | ~ One-time graph build; real-time watcher keeps index fresh | ~ One-time + real-time AST diff watcher; cross-repo tracking; session memory persists across restarts | ~ One-time build (~10s / 500 files); incremental re-index on file save + git commit (<2s on 2,900-file repos via SHA-256 diff | ~ One-time index; JIT freshness — mtime+size fast path auto-detects changed files before every query; no watch daemon needed | ~ One-time indexing; embedding cache on disk; no incremental update details published | ~ One-time axon analyze . (~5s); real-time watcher (--watch) keeps index fresh; no incremental partial re-index — full re-analyze on change |
~ Auto-index on first use; per-branch separate vector collections; resumable batched indexing (checkpoints every 50 files); requires Docker for default mode (Qdrant + Ollama auto-managed) — external Qdrant + native Ollama also supported | ~ One-time octocode index builds the LanceDB collection; incremental re-index on changed files |
✗ Single-shot pack at invocation; nothing to pre-build, but every run re-packs from scratch | ✓ Persistent SQLite knowledge graph; auto-sync watcher on file changes | ✓ Persistent SQLite + FTS5 graph; native-OS filewatcher with debounced auto-sync | ✓ TF-IDF index per project; regenerated on demand | ~ trace-mcp init (global) + trace-mcp add per project; incremental; index in ~/.trace-mcp/ |
| Works with AI agents (MCP) | ✓ Native MCP server (stdio, SSE, streamable-http); Claude Code hook integration (PreToolUse/PostToolUse → index-file); 5 built-in MCP prompt templates (workflow, explore, assess, triage, trace) |
~ Via MCP tool calls | ✓ Native MCP server | ✓ Native MCP server | ✓ Native MCP server (SSE) | ✓ MCP + Claude Code PreToolUse/PostToolUse hooks | ✓ Native MCP server; also OpenAPI for non-MCP clients | ✓ Native MCP server; supports 6 AI assistants (Claude Code, Codex CLI, Gemini CLI, Cursor, OpenCode, GitHub Copilot) | ✓ Native MCP; auto-generates config files; VS Code extension + npm CLI; 12 AI agents supported | ✓ Native MCP server; auto-configures Claude Code, Cursor, Windsurf, Zed, Continue, OpenCode on install; 5 built-in MCP prompt templates | ✗ CLI subprocess, not an MCP server; agent calls via shell-out or Docker; ships a CLAUDE.md policy block instructing agents to prefer cymbal over Read/Grep/Glob/Bash |
✓ Native MCP server; 17 tools across discovery, analysis, code ops, version control, and memory/RAG; supports 12 platforms including Claude Code, Cursor, VS Code Copilot | ✓ Native MCP server (axon serve --watch); also exposes REST API + interactive web dashboard at localhost:8420 |
✓ Native MCP server (stdio); Cursor, VS Code, and Windsurf integration; Docker-based multi-container setup | ✓ Native MCP server (Claude, Cursor, Windsurf); also a standalone CLI (octocode search, octocode index) |
~ MCP server bundled (repomix --mcp) — 7 tools: pack_codebase, pack_remote_repository, attach_packed_output, read_repomix_output (line-range partial reads), grep_repomix_output (regex search in pack), file_system_read_file, file_system_read_directory. Pack-first paradigm, but grep+partial-read now offer per-query slicing |
✓ 14 MCP tools; install auto-configures 11 agents (Claude Code, Codex, Gemini CLI, Zed, OpenCode, Antigravity, Aider, KiloCode, VS Code, OpenClaw, Kiro) |
✓ MCP server; codegraph_explore, codegraph_search, codegraph_callers, codegraph_callees; targets Claude Code primarily |
✓ MCP server with 9 on-demand tools; primary surface is the static .context file though |
~ Native MCP server, but ~170 tools — a large surface that crowds the agent’s tool budget and trips tool-count caps (e.g. Antigravity’s 50-tool limit) |
| Import graph / reference tracing | ✓ find_importers (with has_importers flag), find_references, check_references, get_blast_radius (depth-scored risk + has_test_reach per file), get_changed_symbols, get_dependency_graph; get_untested_symbols (import-graph test reachability); TS/SvelteKit path alias resolution; cross-repo via cross_repo=true on find_importers, get_blast_radius, get_dependency_graph + dedicated get_cross_repo_map |
~ Manual grep | ✗ | ~ Dependency graph for ranking only | ✓ Blast Radius, Reachability, Dependency Paths (graph-native) | ✓ impact, detect_changes, call chain tracing, Cypher queries | ✓ find_referencing_symbols via LSP (type-aware, cross-file) | ~ Import relationships in semantic graph; file + symbol level; no cross-repo call tracing | ~ LSP bridge for type-resolved call graphs; no dedicated blast-radius scoring or git-diff-to-symbol mapping | ✓ Blast-radius with 100% recall (F1 0.54, precision ~0.38 — deliberately conservative); call chain tracing; test coverage gap detection; detect_changes maps diffs to affected functions and flows |
✓ cymbal refs, cymbal importers, cymbal impact (transitive callers, depth cap 5); cymbal trace (downward call graph); --graph mode emits Mermaid/DOT/JSON for trace/impact/importers/impls |
~ get_blast_radius tool; call-site tracing maps symbol usage; no dedicated import graph or cross-repo tracing |
✓ axon_impact with depth grouping (will break / may break / review) and confidence scores; call chain tracing via KuzuDB graph; Cypher queries for ad-hoc traversal; no cross-repo support |
~ Dependency visualization via Mermaid diagrams; cross-project search; no dedicated blast-radius or import graph tracing tool | ✓ Knowledge graph with 11+ relationship types (imports, calls, implements, extends, configures, ...); importance-weighted; structural AST pattern search for code-smell hunting | ✗ Pure file packer — no graph, no edges | ✓ CALLS, IMPORTS, IMPLEMENTS, INHERITS edges; HTTP/gRPC/GraphQL/tRPC cross-service linking; Cypher-like queries | ✓ Symbol relationships, callers/callees, full impact radius via dedicated tools; framework-route ↔ handler edges | ✗ TF-IDF over signatures; no edge tracing | ✓ Standout: framework-semantic request flow (route→middleware→controller→service→view) with cross-language bridges (Inertia::render linking PHP→Vue) via 15+ framework plugins + 7 ORM adapters. jCodeMunch v1.108.58 resolves route→handler + render→view over one language-agnostic shape-keyed resolver (no per-framework plugins), deeper layers on the roadmap; plus find_importers / get_blast_radius / get_cross_repo_map |
| Architecture-decision context (revert/tradeoff/root-cause history surfaced during analysis) | ✓ get_blast_radius / get_impact_preview surface git-mined decision-bearing commits (revert/perf/refactor/rename/bugfix) + a volatility read (v1.108.59, opt-in include_decisions); get_symbol_provenance adds a per-symbol decision narrative. Read-only — surfaced from the commit record, never persisted |
✗ Manual git log reading |
✗ | ✗ | ✗ | ✗ | ✗ | ~ Persists agent session memory across restarts — not architecture-decision rationale | ✗ | ~ Commit-scoped review context (diff→symbol), not a stored decision/rationale memory | ✗ | ~ propose_commit + shadow restore points (undo), not decision rationale |
✗ | ✗ | ✗ | ✗ | ~ Persistent code knowledge graph (structural relationships), not architecture-decision rationale | ✗ | ✗ | ✓ Standout #2: mine_sessions/query_decisions scrape agent session logs into a persistent decision graph that auto-surfaces in get_change_impact — richer narrative, but written/stored and sourced from chat transcripts rather than the durable commit record |
| Write / modify files | ✗ Read-only by design | ✓ | ✓ | ✗ | ✗ Read-only by design | ~ rename tool for coordinated refactoring | ✓ replace_symbol_body, insert_after_symbol, rename (codebase-wide) | ✗ Read-only by design | ✗ Read-only | ✗ Read-only | ✗ Read-only | ~ propose_commit and shadow restore points; undo support without git; not direct file writes |
✗ Read-only by design | ✗ Read-only by design | ✗ Read-only by design | ✗ Read-only | ✗ Read-only | ✗ Read-only | ✗ Read-only | ✗ Read-only on source |
| Runs fully offline / local | ✓ Local index, no backend | ✓ | ✓ | ✓ | ✗ Requires hosted Neo4j + OAuth | ✓ Local LadybugDB; browser WASM option | ~ Local; requires language server binaries installed per language | ✓ Fully local; code never leaves machine | ✓ Fully local; no code leaves machine; no account required for Starter | ✓ Local SQLite in .code-review-graph/; no external database; no cloud dependency |
✓ Go binary; per-OS cache dir (~/.cache/cymbal/repos/<hash>/index.db on Linux); no external services; no account required |
~ Local index + disk-cached embeddings; requires Ollama (default) or OpenAI-compatible API (OpenAI, Gemini free tier, Groq, vLLM) for embeddings — fully local only when paired with Ollama | ✓ Fully local; KuzuDB + local embeddings (BAAI/bge-small-en-v1.5); no API keys; no data leaves machine | ~ Local processing — code stays on machine; default mode requires Docker (auto-managed Qdrant + Ollama); optional cloud embeddings (OpenAI, Gemini) and Qdrant Cloud when desired | ~ LanceDB index lives locally; embeddings default to Voyage AI cloud — fully-local path only on macOS ARM (local-model option); OpenAI / Jina / Google also supported | ✓ Pure CLI; web UI optional | ✓ Single static binary; bundled Nomic-embed-code embeddings; no API key | ✓ Pure local; SQLite-only; no API | ✓ Pure local; bundled standalone binaries; no API | ✓ Local Node/TypeScript; SQLite index in ~/.trace-mcp/; embeddings optional (local Ollama or OpenAI); no telemetry |
| Commercial use permitted | ✓ Paid license available | ✓ Built-in tools | ✓ MIT | ✓ MIT | ~ Parser MIT; MCP server paid tier | ✗ PolyForm Noncommercial — commercial use prohibited | ✓ MIT | ~ Launchers: Apache 2.0; Graph engine: Proprietary (PyPI-distributed) | ~ Starter free but capped (2,000 nodes, 8 calls/day); commercial scale requires Pro ($19/mo) | ✓ MIT — no node caps, no call limits | ✓ MIT | ✓ MIT | ✓ MIT | ~ AGPL-3.0 — copyleft; commercial license available separately | ✓ Apache-2.0 | ✓ | ✓ | ✓ | ✓ | ✓ MIT |
| License | Free non-commercial; paid commercial | N/A (built-in tools) | MIT | MIT | Parser: MIT; MCP server: free / $27/mo Pro | PolyForm Noncommercial 1.0.0 | MIT | Launchers: Apache 2.0; Engine: Proprietary | Proprietary SaaS; Starter free (capped); Pro $19/mo; Team $29/user/mo | MIT | MIT | MIT | MIT | AGPL-3.0 (commercial license available) | Apache-2.0 | MIT | MIT | MIT | MIT | MIT |
| Dead code detection | ✓ find_dead_code — free; confidence-scored; cascading dead-code chains; entry-point heuristics |
✗ | ✗ | ✗ | ~ Pro tier ($27/mo) | ✗ | ✗ | ✗ | ✗ | ~ Refactoring tools include dead code detection; no dedicated confidence-scored cascading analysis or entry-point heuristics | ✗ | ~ run_static_analysis tool; no dedicated dead code detection |
✓ Multi-pass dead code: zero callers → framework exemptions → override pass → Protocol conformance → Protocol stubs; 3 languages only | ✗ | ✗ | ✗ | ✓ Functions with zero callers, excluding entry points | ✗ | ✗ | ✗ No dedicated dead-code tool documented |
| Semantic / hybrid search | ✓ Opt-in BM25+vector (embed_repo); 3 providers: sentence-transformers, Gemini (task-aware), OpenAI; pure BM25 when disabled |
✗ | ✗ | ✗ | ✗ | ✓ BM25 + embeddings + RRF — native | ~ LSP type inference (not embedding-based) | ✗ | ~ FTS5 full-text + TF-IDF; no BM25+vector hybrid mode | ~ Optional vector embeddings via sentence-transformers, Gemini, or MiniMax; FTS5 keyword+vector hybrid; enabled separately from core graph | ✗ FTS5 keyword search only; no vector or embedding layer | ✓ Embeddings via Ollama or OpenAI-compatible APIs with disk caching; semantic search across file headers and identifiers | ✓ BM25 (KuzuDB FTS) + 384-dim vector (BAAI/bge-small-en-v1.5) + Levenshtein fuzzy; fused via Reciprocal Rank Fusion; results grouped by execution flow | ✓ Dense vector (Qdrant) + BM25 sparse; fused via Reciprocal Rank Fusion; 6 embedding providers (Local Ollama, Docker Ollama, OpenAI, Gemini free tier, LM Studio, LiteLLM); per-branch separate collections | ✓ Vector search via LanceDB + structural AST pattern matching (e.g. find every .unwrap() call); 5 embedding providers (Voyage AI default, OpenAI, Jina, Google, macOS-ARM local) |
✗ Pure text pack — no embeddings | ✓ Bundled Nomic-embed-code (768d int8) compiled into the binary; 11-signal scoring (TF-IDF, RRI, AST profiles, MinHash, graph diffusion, etc.) | ~ FTS5 full-text only; no embeddings claimed | ~ TF-IDF ranking only; no semantic embeddings | ✓ SQLite FTS5 + optional bundled ONNX embeddings (Ollama / OpenAI swappable) |
| Token-budgeted retrieval | ✓ get_ranked_context (BM25 + PageRank strategies) + get_context_bundle budget params |
✗ | ✗ | ~ Map-based (not retrieval) | ✗ | ✗ | ✗ | ~ Pre-loading (not retrieval) | ✗ | ✗ Graph returns blast-radius context set; no token-budget parameter on retrieval | ✗ | ✗ No token-budget parameter on retrieval | ✗ No token-budget parameter on retrieval | ✗ No token-budget parameter on retrieval | ✗ No token-budget parameter on retrieval | ~ Per-file token counts reported; no retrieval-side budget — the whole pack ships every call | ~ Structural queries replace large reads; no explicit per-query token budget | ~ Compact tool returns; no explicit budget API | ✓ Writes minimum signatures to a .context file — explicit "compact signatures" mode; ships ~2k–4k tokens vs 80k+ |
✗ No token-budget parameter on retrieval |
| Works alongside the others | ✓ Complements all of them | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ~ Same MCP layer; overlapping problem space — pick one for primary code intelligence (both expose code-search / index / graph-traversal MCP tools) | ✓ Different layer (whole-pack vs symbol-extract); pack first, query precisely with jCodeMunch when needed | ~ Same MCP layer + same agent surface; would conflict at the protocol level (overlapping tool names, both want to be the code-intelligence MCP) | ~ Same MCP layer; overlapping problem space — pick one, not both, for code intelligence in Claude Code | ~ Mostly orthogonal: SigMap writes static signatures into .context; jCodeMunch handles live retrieval. Could co-exist if you want both flat ranking and live symbol fetch. |
~ Same MCP layer and the same grounded-retrieval lane — overlapping code-intelligence graph; pick one for primary code intelligence, and its ~170-tool surface makes co-loading costly |
Complementary Tools — different problems, same ecosystem
| jCodeMunch + jDocMunch | RTK | lean-ctx | Context Mode | OpenViking | ClawMem | mem0 | LanceDB | QMD | Obsidian | chonkify | Aegis | Caliber | Citadel | codesight | repowise | caveman | Headroom | distill | tokf | ||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Token reduction on code exploration | ✓ ~95 % | ~ N/A (different problem) | ~ Entropy filtering, signature mode, and aggressive AST stripping reduce read tokens; no symbol index — code exploration still requires file reads | ~ BM25 text search over intercepted output; no structured code retrieval | ✗ Agent memory system; no code exploration tools | ✗ Agent memory system; not designed for code exploration | ✗ Memory & personalization layer; no code navigation | ✗ Vector database infrastructure; no code-specific tooling | ✗ Doc/notes search only; no code navigation or symbol extraction | ✗ Note-taking app; no code navigation or symbol extraction | ✗ Document compression library; no code exploration tools | ✗ Architecture governance layer; no code exploration or symbol extraction | ✗ Config management layer; no code exploration or symbol extraction | ✗ Orchestration harness; no code exploration or symbol extraction | ~ Architecture-level scan (routes, schemas, middleware chains, import graphs) — not symbol-level retrieval; no token benchmarks published | ~ LLM-generated wiki articles answer high-level questions without file reads; no on-demand symbol retrieval or published token benchmarks | ✗ Compresses model output (replies), not codebase retrieval | ~ Compresses tool outputs / RAG / files in the prompt stream; "code search 92%" claim is on prompt-stream compression, not symbol retrieval | ✗ Operates on CLI output, not codebase | ✗ Operates on CLI output, not codebase | |
| Token reduction on terminal output | ~ Not the focus | ✓ ~89 % avg | ✓ 60–95% via shell hook (90+ patterns, 34 command categories) | ✓ ~98% on shell/log/web output (their primary feature) | ✗ Not the focus | ✗ Not the focus; reduces session bloat via decay & dedup | ✗ Not the focus | ✗ Not the focus | ✗ Not the focus | ✗ Not the focus | ✗ Not the focus | ✗ Not the focus | ✗ Not the focus | ✗ Not the focus | ✗ Not the focus | ✗ Not the focus | ✗ Not the focus | ✗ Output-token compressor for model replies, not terminal output | ✓ Wraps tool outputs in the agent's context; bundles RTK for shell-output rewriting | ✓ "Up to 99% token reduction" via LLM-summarisation (sample: 7,648 → 99 tokens); requires an OpenAI-compatible endpoint | ✓ "60–90% reduction" via TOML rule-based filtering — no LLM in the loop |
| Agent memory / cross-session continuity | ✗ Not the focus | ✗ | ~ ctx_session + ctx_knowledge provide cross-session task/decision persistence (CCP protocol) | ~ Session state snapshot via PreCompact hook | ✓ L0/L1/L2 tiered memory; skill library; auto session compression | ✓ Hybrid search vault; typed decay; causal links; cross-session handoffs | ✓ Multi-level adaptive memory (user / session / agent state) | ✗ Storage primitive; no memory semantics | ✗ Knowledge base retrieval, not session memory | ~ Vault functions as persistent knowledge store; no agent memory API | ✗ Not the focus | ~ Observation layer learns from agent edits and PR merges over time; not traditional session memory | ✓ Session learning hooks capture corrections, gotchas, and patterns into CALIBER_LEARNINGS.md |
✓ Campaign persistence — phases, decisions, and continuation state survive across sessions | ✗ Per-session in-memory scan; no cross-session persistence | ~ Wiki articles persist across sessions; no agent memory API | ~ /caveman-stats persists lifetime savings; /caveman-compress rewrites CLAUDE.md into caveman-speak (~46% input-token cut) |
✓ Cross-agent memory; headroom learn mines failed sessions and writes corrections to CLAUDE.md / AGENTS.md / GEMINI.md |
✗ Stateless transformer | ✗ Stateless transformer | |
| Requires pre-indexing | ✓ One-time, incremental | ✓ None needed | ✓ None needed; compression is stateless per-call; session knowledge accumulates automatically | ~ No upfront step; auto-indexes tool output on flow-through via hooks | ~ LLM-driven; organized on first ingest, updated as agent works | ~ No upfront step; memory captured automatically via hooks | ~ No upfront step; memories accumulate as the agent interacts | ~ Vectors must be pre-computed externally and loaded | ~ One-time embed step; re-run after adding new docs | ✗ No indexing API; files are created and read via the GUI or filesystem | ~ Embedding pass required per compression call; local model ~419 MB or cloud API | ~ Knowledge base must be manually populated via aegis_import_doc; no auto-scan |
~ One-time caliber init scan; re-run caliber refresh as codebase evolves; auto-refresh hooks available |
~ No indexing; /do setup scaffolds per-project config on first run |
~ One-shot scan per session (~2s startup); no persistent index between sessions | ~ One-time LLM-assisted wiki generation; re-run repowise refresh as codebase evolves |
✗ Skill / plugin only | ✗ Compression at request time | ✗ Per-call summarisation | ✗ Per-call rule application | |
| Works with AI agents (MCP) | ✓ Native MCP server | ~ Hook-based, not MCP | ✓ 24 MCP tools; lean-ctx init --agent claude-code one-command setup |
✓ Native MCP server + PreToolUse/PostToolUse/PreCompact/SessionStart hooks | ~ Python SDK + agent framework; MCP integration not documented | ✓ 28 MCP tools + Claude Code hooks + native OpenClaw plugin | ~ Python + TypeScript SDK; LangGraph & CrewAI integrations; no native MCP server | ~ REST API + Python/TS/Rust SDKs; LangChain & LlamaIndex integrations; no native MCP server | ✓ Native MCP server (query, get, multi_get, status) | ~ Community MCP plugins available; no official MCP server from Obsidian | ✗ No MCP server; standalone library and CLI only | ✓ Native MCP server; dual-surface (agent read-only + admin approval-gated) | ~ CLI tool, not an MCP server; auto-discovers and configures MCP servers for your project | ~ Claude Code plugin, not an MCP server; orchestrates agents and hooks within Claude Code | ✓ Native MCP server; zero-install via npx codesight |
✓ Native MCP server; pip install repowise |
~ Skill format for Claude Code + 30+ agents; caveman-shrink is MCP middleware that compresses tool descriptions |
✓ Native MCP server (headroom mcp install) exposes headroom_compress / headroom_retrieve / headroom_stats |
✗ CLI utility — invoked manually via shell pipes | ~ Hooks for Claude Code, OpenCode, Codex CLI; not native MCP | |
| Runs fully offline / local | ✓ Local index, no backend | ✓ | ✓ Single Rust binary; zero dependencies; no network calls | ✓ Local SQLite index; no network calls | ✗ Requires external LLM provider; network required | ~ Fully local but requires 4–11 GB VRAM; WSL2 on Windows | ✗ Self-hosted requires vector DB + PostgreSQL + LLM API keys | ✓ Embedded library; no external services required | ~ Local GGUF models via node-llama-cpp; VRAM required for semantic reranking | ✓ Core app fully local; Sync is optional paid cloud add-on | ~ Local SentenceTransformers supported; requires ~419 MB model download + VRAM | ✓ Fully local SQLite; optional SLM (llama.cpp) runs locally; no external services | ~ Scoring is fully local; generation requires your LLM provider (Claude Code seat, Cursor seat, or API key) | ✓ Fully local Node.js plugin; no external services or API keys required beyond Claude Code itself | ✓ Fully local TypeScript; zero dependencies; no network calls at runtime | ~ Local SQLite + LanceDB; wiki generation requires an LLM API key (Anthropic, OpenAI, or local Ollama) | ✓ Skill content is local; no service round-trip | ✓ Local Kompress-base text compressor (HuggingFace); no cloud egress | ~ Needs an OpenAI-compatible LLM endpoint (local Ollama / LM Studio works; or hosted) | ✓ Pure rule engine, no LLM in the loop | |
| Commercial use permitted | ✓ Paid license available | ✓ MIT | ✓ MIT | ~ Internal & commercial use OK; SaaS/managed service prohibited (ELv2) | ✓ Apache 2.0 | ✓ MIT | ~ Apache 2.0 self-hosted (free); hosted platform = paid (pricing undisclosed) | ✓ Apache 2.0 (OSS free; cloud/enterprise paid) | ✓ MIT | ✓ Core app free including commercial; commercial license $50/user/yr (voluntary) | ✗ Evaluation-only; commercial use requires paid license from author | ✓ ISC license — permissive, commercial use permitted | ✓ MIT | ✓ MIT | ✓ MIT | ~ AGPL-3.0 — commercial use permitted, but any hosted derivative must be open-sourced | ✓ | ✓ | ~ No LICENSE file in repo at time of survey — verify before commercial use | ✓ | |
| License | Free non-commercial; paid commercial | MIT (free); $15/dev/mo cloud | MIT (free) | Elastic License 2.0 (ELv2) | Apache 2.0 | MIT | Apache 2.0 (self-hosted free); hosted platform paid | Apache 2.0 (OSS free); cloud/enterprise paid | MIT | Proprietary freeware; Sync $4/mo; Publish $8/mo; Commercial license $50/user/yr (optional) | Proprietary (evaluation-only); commercial license contact: th@chonkydb.com | ISC (open source, permissive) | MIT | MIT | MIT | AGPL-3.0 | MIT | Apache-2.0 | Unlicensed | MIT | |
| Works alongside jCodeMunch | ✓ | ✓ Covers terminal output; jCodeMunch covers code reads | ✓ Compresses file reads + terminal output; jCodeMunch adds the semantic indexing lean-ctx lacks | ✓ Covers session output bloat; jCodeMunch covers code reads | ✓ Agent memory layer; jCodeMunch is code navigation layer | ✓ Agent memory layer; jCodeMunch is code navigation layer | ✓ Agent memory layer; jCodeMunch is code navigation layer | ✓ Vector search infrastructure; jCodeMunch is structured code navigation | ✓ Doc/notes knowledge search; jCodeMunch + jDocMunch handle code and structured docs | ✓ Obsidian vault .md files are directly indexable by jDocMunch for agent retrieval | ✓ PDF compression upstream of jDocMunch; fills jDocMunch's PDF gap | ✓ Architecture governance layer; jCodeMunch is live code structure layer — natural pairing | ✓ Caliber configures jCodeMunch as an MCP server; jCodeMunch is its recommended code exploration piece | ✓ Citadel orchestrates the workflow; jCodeMunch powers the code reads — /review and /refactor skills get dramatically cheaper | ✓ Architectural orientation layer; jCodeMunch provides the symbol-level retrieval codesight lacks — orient with codesight, then drill with jCodeMunch | ✓ Wiki Q&A and doc generation layer; jCodeMunch delivers precise live symbol retrieval alongside the static wiki | ✓ Different layer — caveman compresses outgoing replies, jCodeMunch compresses incoming retrieval | ✓ Different layer — Headroom compresses prompt streams, jCodeMunch shapes what enters those streams | ✓ Different layer — distill is for terminal output, jCodeMunch is for code retrieval | ✓ Different layer — tokf is for terminal output, jCodeMunch is for code retrieval |
Raw file tools — Read, Grep, Glob, Bash
Every AI coding environment ships with tools to read files and search text. They work. They just cost a lot of tokens — because they return entire files when you only needed one function.
- Read a file → get the entire file (even if you need 10 lines)
- Grep returns lines but no surrounding structure or type info
- No symbol index — agent must re-read files each session
- No import graph — tracing call chains requires many tool calls
- No section-level doc access — doc files read in full
- Token cost scales with codebase size, not query complexity
- search_symbols returns matching symbols with signatures — no file read needed
- get_symbol returns the exact implementation, nothing more
- Index is built once and reused — incremental updates on change
- find_importers and find_references trace the call graph in one call
- jDocMunch delivers section-level doc retrieval across .md, .rst, .ipynb, HTML
- Token cost is flat and tiny regardless of codebase size
Express.js (34 files) — ~58× efficiency | FastAPI (156 files) — ~100× efficiency | Gin (40 files) — ~66× efficiency
Workflow measured:
search_symbols (top 5) + get_symbol ×3 vs. concatenating all source files.
Full methodology and raw data: benchmarks/
mcp-server-filesystem
The canonical Model Context Protocol reference server — published in the modelcontextprotocol/servers monorepo (85k+ stars) and the most-cited "first MCP server" example. It exposes 13 file system operations over MCP: read, write, edit, list, move, search, and metadata. Not bundled with Claude Desktop by default; users wire it in via claude_desktop_config.json against an allowlist of directories.
read_text_file/read_multiple_filesreturn whole files — same token cost as native Read, just over MCPsearch_filesis a filename glob match, not a content search — no grep equivalent at all- No symbol index, no AST parsing, no language awareness
write_file,edit_file(text-pattern with dry-run),move_file,create_directory— full read/write surface- No import graph, no reference tracing, no doc section search
- No indexing step — point it at directories and it works immediately
- get_symbol returns the exact function body — not the whole file
- search_symbols understands types, signatures, and language constructs
- AST-based parsing for 70+ languages — finds things grep cannot
- Read-only by design — predictable, safe for agent use
- Import graph and reference tracing built into the index
- Requires one-time
index_folderorindex_repocall
search_files finds filenames; search_symbols finds symbols. A grep over content is still a job for native Grep or a separate MCP — the filesystem server doesn't do that either. jCodeMunch's search_text covers regex content search with structural context the filesystem server has no way to surface.
RepoMapper
RepoMapper
is an open-source Python MCP server that generates a token-budgeted "map" of a repository
by applying PageRank to a dependency graph built with Tree-sitter — a direct port of the
"Repo Map" feature Aider uses internally. Given a token budget (e.g. --map-tokens 2048),
it selects the most important files and surface-level signatures to fill that window.
Small, focused project: 165 stars, ~25 commits, last activity mid-2025; intentionally one-tool scope.
- PageRank over a Tree-sitter dependency graph identifies the most-referenced files
- Binary search fills a specified token budget to within ~15% of the limit
- Surfaces class/function signatures — not bodies — to maximise breadth per token
- 34+ languages via Tree-sitter grammars
- Single
repo_maptool — simple API, low learning curve - MIT-licensed; based on Aider's proven RepoMap algorithm
get_repo_map(v1.101.0) — direct RepoMapper parity. Query-less, token-budgeted, signature-only repo overview ranked by PageRank. One tool, four optional parameters.search_symbolsfinds a function by name — no map to scan, no signatures to skimget_symbol_sourcereturns the complete implementation body, not just the signature- Index is built once; subsequent queries are O(1) and sub-millisecond
find_importersandfind_referencestrace call graphs across the whole repoget_symbol_importanceranks symbols by PageRank or in-degree — on demand, no static mapget_ranked_contextassembles a token-budgeted context bundle ranked by BM25 + PageRank combined score — same idea asrepo_map, but query-driven and with full bodiesget_tectonic_mapgoes further than PageRank: fuses structural (imports), behavioral (shared symbol references), and temporal (git co-churn) signals to surface logical module boundaries, drifters, and god-module risk- jDocMunch covers documentation — section search across .md, .rst, .ipynb, HTML
- 80+ tools covering outlines, content, search, context bundles, import graphs, dead-code detection, and refactor planning
search_symbols("authenticate")) and gets a precise answer.
Summarisers are great for "What matters here?" — retrievers are great for
"Where is this, exactly?" Both questions arise in a real coding session;
they are not in competition.
get_repo_map(repo, token_budget=2048) is a direct one-call counterpart
to repo_map(project_root) — query-less, signature-level, token-budgeted,
PageRank-ranked. Same job, same API shape, on jCodeMunch's already-built index.
You also get get_tectonic_map (multi-signal orientation:
imports + shared references + git co-churn) and get_ranked_context
(query-driven retrieval with full bodies) — the orientation toolkit goes broader
and deeper than a single PageRank map.
search_symbols call costs a fraction
of any map-based approach. For orientation, get_repo_map gives RepoMapper
parity at the API surface (one call, token budget in, ranked signature map out), while
get_tectonic_map and get_ranked_context exceed what
repo_map offers algorithmically. RepoMapper remains a fine choice when
you want a tiny single-purpose dependency and no index lifecycle at all.
Pharaoh
Pharaoh
is a two-layer system: an open-source AST parser (pharaoh-parser, MIT)
that extracts structural metadata from TypeScript and Python using tree-sitter,
and a hosted MCP server that loads that metadata into a Neo4j knowledge graph
and exposes 16 architectural tools (8 free + 8 on the $27/mo Pro tier).
The central design principle: "no source code is ever captured" —
only signatures, hashes, and graph edges. Cloud-only by design; no self-hosted option.
- Free tier (8 tools): Codebase Map, Module Context, Function Search, Blast Radius, Dependency Paths + 3 more
- Pro tier (+8 tools, $27/mo): Regression Risk, Check Reachability, Dead Code Detection, Consolidation Opportunities, Test Coverage Map, Vision Docs + Gaps, Cross-Repo Audit
- Neo4j knowledge graph enables raw Cypher access on the graph
- Parser is fully open source (MIT) — "the exact code that runs in production"
- Security-first: no source code captured; constants with secret-like names are skipped
- Auto-updates via GitHub webhook on every push — no manual re-indexing
- TypeScript decorator extraction for DI containers and controller analysis
- 70+ languages vs. Pharaoh's TypeScript and Python only
- Runs entirely offline — local SQLite index, no OAuth, no hosted backend
get_symbol_sourcereturns the full function body; Pharaoh intentionally omits source- Published benchmarks: 58–100× token efficiency on real production repos
- Free equivalents of every named Pro feature:
find_dead_code(Dead Code),get_untested_symbols(Test Coverage Map),get_blast_radius+find_dead_codeconfidence (Reachability),get_pr_risk_profilewith v1.100.0 runtime-aware scoring (Regression Risk),get_cross_repo_map(Cross-Repo Audit),get_repo_map(Codebase Map),find_similar_symbolsv1.102.0 (Consolidation Opportunities — and stronger: multi-signal cluster detection with verdict tiers + canonical pick, not just pair scoring) - 80+ tools across the suite — superset of Pharaoh's 16, all in one tier
- jDocMunch covers documentation — Pharaoh has no equivalent
- v1.102.0 with 4,188 tests;
pharaoh-parserpublic repo at 2 stars, last commit April 2026 (early stage)
trusted_folders allowlist that restricts
which directories the indexer may read — suitable for multi-tenant or data-residency
environments.
pharaoh-mcp, which connects to a
hosted Neo4j instance at mcp.pharaoh.so via OAuth. There is no
local or self-hosted option documented. For teams with air-gap or data-residency
requirements, the open-source parser alone is available — but the MCP tools that
make it useful are cloud-only. jCodeMunch runs entirely on your machine with no
external calls except optional AI summaries.
GitNexus
GitNexus
bills itself as the "nervous system for agent context." It builds a knowledge
graph from your codebase — call edges, inheritance chains, execution flows,
functional clusters via Leiden community detection — stored in a local LadybugDB
(formerly KuzuDB) instance and queryable via 12 MCP tools including raw Cypher.
Hybrid dual-mode: CLI runs locally (native Node.js + Tree-sitter), web UI runs
in-browser (WASM, zero-server), bridge via gitnexus serve.
Launched August 2025; 37.4k GitHub stars as of May 2026 (v1.6.4) —
one of the fastest-growing open-source code-intelligence projects of the year.
- Per-repo tools (7):
list_repos,query,context,impact,detect_changes,rename,cypher(raw Cypher on LadybugDB) - Multi-repo group tools (5):
group_list,group_sync,group_contracts,group_query,group_status— cross-repo dependency analysis - Leiden community detection clusters related symbols + cohesion scores
- Hybrid search: BM25 + semantic embeddings + reciprocal rank fusion (native, always-on)
- Browser WASM UI with Sigma.js / WebGL visualisation + in-browser Graph RAG agent
- v1.6.4 (May 2026), 919 commits, 3,000+ forks, 45 contributors
- 70+ languages vs. GitNexus's 14 — adds Erlang, Fortran, SQL, Assembly, XML, GraphQL, Haskell, Elixir, Lua, Kotlin, Razor/Blazor, AL, Verse, and more
- Commercial use permitted out of the box — GitNexus's PolyForm NC license prohibits it
- Published token efficiency benchmarks: 58–100× on real production repos
- Opt-in hybrid BM25 + vector search via
search_symbols(semantic=true)— local sentence-transformers, bundled ONNX, Gemini, or OpenAI; zero overhead when disabled get_changed_symbols↔ GitNexus'sdetect_changes;get_blast_radius+get_impact_preview↔impact;plan_refactoring↔rename(rename + move + extract + signature change);get_cross_repo_map+get_group_contracts(v1.103.0) ↔group_*tools — ourget_group_contractsadds 4-tier intent classification (de_facto_api/leaky_internal/dead_contract/version_skew), stability scoring, last-breaking-change history, and runtime hit counts on top of the shared-symbol surface- Beyond GitNexus's surface:
assemble_task_context(v1.105.0 — single-call task-aware orchestrator with explainable intent classification + source-attributed entries),find_similar_symbols(multi-signal consolidation detection),get_pr_risk_profile(Phase 7 runtime-aware),get_tectonic_map(3-signal module topology),get_repo_map(PageRank-ranked overview),get_signal_chains(entry-point pathway tracing) - jDocMunch covers documentation — GitNexus has no equivalent for .md/.rst/.ipynb section search
- v1.103.0 with 4,204 tests; SQLite index, no Neo4j/LadybugDB dependency, no native binary crashes
cypher tool — an open query
surface jCodeMunch deliberately doesn't expose (we use SQLite, not a graph DB).
The browser-WASM zero-server mode is genuinely unique — drop in a
GitHub repo URL or ZIP and explore without installing anything. Their hybrid search
is native and always-on; jCodeMunch's is opt-in and requires a one-time
embed_repo warm-up. Sigma.js/WebGL graph visualisation
out of the box has no equivalent on our side. And the trajectory matters — 37.4k
stars in 9 months is real adoption momentum we should respect.
get_changed_symbols, get_blast_radius, get_impact_preview,
plan_refactoring, get_cross_repo_map, get_group_contracts,
and our newer additions (find_similar_symbols, get_repo_map,
get_tectonic_map, get_pr_risk_profile) cover the workflows
GitNexus is known for.
GitNexus still wins on raw Cypher access and the WASM browser UI;
jCodeMunch leads on language breadth (70+ vs. 14), suite scope (jDocMunch + jDataMunch),
and runtime evidence (Phase 7 runtime-aware PR risk).
The two tools can coexist — GitNexus for graph exploration in a non-commercial
context, jCodeMunch for everything else.
Serena
Serena
is an open-source coding agent toolkit that exposes IDE-level semantic code tools
to LLMs via MCP. Rather than static AST parsing it spins up real language servers
(Pyright, rust-analyzer, typescript-language-server, gopls, etc.) and routes tool
calls through them — giving it type-aware cross-file reference resolution,
rename-across-codebase, and symbol-level code editing. The v1.x line (current
v1.2.0, April 2026) graduated out of pre-stable and added JetBrains IDE backend,
symbol-level debug with breakpoints, monorepo / multi-project querying, and a
custom solidlsp LSP library replacing the earlier multilspy fork.
24.1k GitHub stars; Apache 2.0; built by Oraios AI.
- Type-aware cross-file reference + declaration + implementation resolution via real language servers
- Symbol editing:
rename_symbol,replace_symbol_body,insert_after_symbol,safe_delete,move,inline - JetBrains IDE backend (v1.x) with
debugtool — breakpoints, variable inspection, execution control get_diagnostics_for_file/get_diagnostics_for_symbol— LSP errors/warnings surfaced to the agent- Monorepo / multi-project querying:
QueryProjectTool,ListQueryableProjectsTool, multi-languageproject.yml - Memory: project-scoped + global markdowns,
read_only_memory_patterns,ignored_memory_patterns execute_shell_commandfor direct shell access- Compatible with Claude Code, Cursor, Cline, Roo Code, Codex, Gemini CLI, JetBrains IDEs
- Zero external binaries — tree-sitter grammars bundled; works instantly in CI, containers, ephemeral environments
- Published token efficiency benchmarks: 58–100× on real production repos (Express, FastAPI, Gin)
- Python ≥3.10 (broad compatibility); Serena requires Python 3.13
- No per-language install burden — 70+ languages via bundled tree-sitter, no LSP setup per language
- Lightweight: no background language-server processes, no per-language tmpfs/RAM cost, no LSP indexing wait at startup
plan_refactoringcovers rename/move/extract/signature change in a read-only way — the agent applies the edits, jCodeMunch never mutates filesfind_implementations(v1.104.0) — 4-channel resolution (LSP 1.0 / AST 0.85 / duck-typed 0.65 / decorator 0.45) with classification + differs_by breakdown + optional cross-repo. Goes beyond Serena's flat list of implementations.check_delete_safe(v1.104.0, read-only) — composite of importers + references + dead-code confidence + runtime traces + entry-point heuristics; 8 verdict tiers + ranked blockers + one-line recommended_action- Runtime evidence on top of static analysis:
get_pr_risk_profile(Phase 7 runtime-aware),find_hot_paths,find_unused_paths— Serena has no equivalent - Architectural intelligence Serena doesn't ship:
get_tectonic_map,find_similar_symbols,get_group_contracts,get_repo_map,get_pr_risk_profile - jDocMunch + jDataMunch cover docs and tabular data — Serena's scope is code-only
- v1.104.0 with 4,227 tests
rustup,
PHP needs Phpactor, Kotlin's language server is historically problematic, Julia's LSP has documented
initialisation failures. The custom solidlsp library and JetBrains backend alternative
mitigate but don't eliminate the operational cost: in CI, containerised, or ephemeral environments
every language-server install is a step that can fail or pull in hundreds of MB. jCodeMunch
requires no external binaries — tree-sitter grammars are bundled in the wheel; indexing is fully
self-contained.
replace_symbol_body,
insert_after_symbol, safe_delete, move, inline,
cross-codebase rename_symbol) is genuinely an IDE replacement; jCodeMunch is
deliberately read-only and emits plan_refactoring + check_delete_safe
for the agent to apply via native Edit/Write.
The v1.x JetBrains backend + debug tool (breakpoints, variable
inspection, execution control) has no equivalent on our side and is uniquely useful for
agent-driven debugging sessions. LSP diagnostics surfaced as tools
(get_diagnostics_for_file, get_diagnostics_for_symbol) mean the agent
sees the same errors the IDE sees, which we don't do.
Dual-Graph (a.k.a. GrapeRoot)
Dual-Graph
(graperoot v3.9.64, April 2026 — 83 PyPI releases indicating a very active
iteration cadence) is a local CLI context engine that makes AI coding assistants
cheaper and faster by pre-loading the right files into every prompt. It supports
six AI assistants: Claude Code, Codex CLI, Gemini CLI, Cursor, OpenCode, and GitHub Copilot.
It builds two data structures: an info_graph.json (a semantic graph of files,
symbols, and import relationships) and a chat_action_graph.json (session memory
recording reads, edits, and queries). Before each turn the graph ranks relevant files and packs
them into the prompt automatically — no extra tool calls required. A persistent
context-store.json carries decisions, tasks, and facts across sessions. The tool
is activated with dgc . (Claude Code), dg . (Codex CLI), or
graperoot . --cursor/--gemini/--opencode/--copilot and runs entirely offline.
Launcher scripts are Apache 2.0; the graph engine (graperoot) is proprietary,
distributed via PyPI.
- Semantic graph extracts files, symbols, and import relationships at project scan time; 11 languages (TS, JS, Python, Go, Swift, Rust, Java, Kotlin, C#, Ruby, PHP)
- Session memory (
chat_action_graph.json) tracks reads, edits, and queries — context compounds across turns - Auto pre-loads relevant files before the model sees the prompt — no tool calls needed for basic navigation
- Persistent
context-store.json: decisions, tasks, and facts carried across sessions CONTEXT.mdsupport for free-form session notes- MCP tools for deeper exploration:
graph_read,graph_retrieve,graph_neighbors - Benchmarked: 30–45% cheaper, 16/20 prompts win on cost, quality equal or better at all complexity levels
- Supports 6 AI assistants: Claude Code, Codex CLI, Gemini CLI, Cursor, OpenCode, GitHub Copilot
- Token tracking dashboard (
localhost:8899); configurable via env vars (DG_HARD_MAX_READ_CHARS, etc.) - Fully local; all data in
<project>/.dual-graph/(gitignored automatically) - Launcher scripts: Apache 2.0; graph engine: proprietary (PyPI-distributed)
- Tree-sitter AST parsing — retrieves individual functions and classes, not file blocks
search_symbols+get_symbol_source: find any function by name and return its full body in one callfind_importers/find_references/get_blast_radius: trace call graphs and impact chains across the entire repo- Published benchmarks: 58–100× token reduction on Express, FastAPI, and Gin repos
- 80+ MCP tools; tool profiles (core/standard/full) +
compact_schemasto control context budget - Refactor/safety surface:
plan_refactoring(rename/move/extract/signature),check_rename_safe,check_delete_safe(8-tier verdict + recommended action) - Architectural intelligence Dual-Graph doesn't ship:
get_tectonic_map(3-signal module topology),find_similar_symbols(consolidation clusters),get_group_contracts(cross-repo API surface),get_pr_risk_profile(Phase 7 runtime-aware),find_implementations(4-channel impl discovery),get_repo_map(PageRank-ranked overview) audit_agent_config— scans CLAUDE.md/.cursorrules for stale references and token waste- jDocMunch covers documentation — .md, .rst, .ipynb, and HTML section search; jDataMunch covers tabular data
- Zero extra dependencies: tree-sitter grammars bundled, no Node.js required
- Paid commercial license; v1.104.0 with 4,227 tests; active release cadence (v1.x with v1.100→v1.104 in May 2026 alone)
search_symbols("authenticate")) and gets the exact symbol body back.
Pre-loading works well when the right files are predictable; retrieval wins when the codebase
is large and the agent knows exactly what it needs. The two strategies are genuinely
complementary — Dual-Graph to orient, jCodeMunch to pinpoint.
context-store.json — persisting decisions, tasks, and facts
between conversations — is a feature jCodeMunch does not offer. The automatic pre-loading
also means the model starts each turn with relevant code already in context, eliminating the
need for an explicit retrieval call in straightforward sessions. The broad AI assistant support
(6 tools including Cursor, Gemini CLI, OpenCode, and Copilot) and the built-in token tracking
dashboard at localhost:8899 are practical workflow additions. For users who want
session continuity out of the box across multiple AI assistants, this is a meaningful workflow
advantage. The 83-release cadence on PyPI signals an actively-maintained
product — worth respecting.
search_symbols call
returns exactly that body without injecting anything else — and structural queries like
get_blast_radius, find_dead_code, and plan_refactoring
have no Dual-Graph equivalent. The licensing split (Apache 2.0 launchers, proprietary
engine) is clearer than the previous unlicensed state, but the proprietary engine still
limits forkability and auditability.
Running both is practical: Dual-Graph to pre-load context and persist session memory,
jCodeMunch to answer precise symbol and cross-reference queries that the graph pre-loader
would miss.
Note: GrapeRoot's benchmark scores jCodeMunch on code-generation tasks
it was never designed to perform — those numbers do not reflect retrieval quality.
vexp
vexp (v1.2) is a local-first code context engine for AI coding agents — native Rust binary, local SQLite, parses codebases into a dependency graph, and serves only relevant code per task. Positioned as a privacy-first, zero-network-call alternative; ships a VS Code extension, an npm CLI (15 commands), and auto-generates MCP configuration files for 12+ AI coding agents. 11 MCP tools on Pro tier (7 on Starter). Paid SaaS pricing (Starter free with hard caps / Pro $19/mo / Team $29/user/mo). Maintains an open SWE-bench leaderboard at Vexp-ai/vexp-swe-bench claiming 73% pass@1 at $0.67/task when paired with Claude Code.
- Tools:
run_pipeline(orchestrator),get_context_capsule,get_impact_graph,search_logic_flow,get_skeleton,index_status,workspace_setup,submit_lsp_edges,get_session_context,search_memory,save_observation(11 total on Pro) - Native Rust binary + local SQLite; <15s to index 5,000 files, <500ms P95 query latency (vendor-claimed)
- Hybrid search: FTS5 + TF-IDF
- LSP bridge for type-resolved call graphs via
submit_lsp_edges(caller pushes LSP data in) - Session memory:
save_observation+search_memorypersist agent observations across sessions - Intent detection adapts search strategy by task type (debug, refactor, modify) — Pro only
get_skeletonstrips function bodies, retains signatures (claims 70–90% body reduction)- SWE-bench benchmark repo: 73% pass@1 at $0.67/task with Claude Code (vendor-run, vendor-published)
- Starter plan caps: 2,000 nodes / single repo / 7 tools / 8 calls/day — Pro ($19/mo) caps: 50,000 nodes / 3 repos
- Proprietary SaaS — closed source, no public test suite, no reproducible token-efficiency benchmark with raw data
- No documentation/data layer; no dead-code detection; no token-budgeted ranked retrieval; no PageRank/centrality; no runtime evidence
- Benchmarked ~95% token reduction: 58–100× on Express.js, FastAPI, Gin — tiktoken-measured with published methodology and raw data at benchmarks/
- 70+ languages (tree-sitter bundled, zero binary installs) — YAML/Ansible, Razor/Blazor, SQL/dbt/SQLMesh, Erlang, Fortran, AL, Verse, and more
find_dead_code— confidence-scored with cascading chains and entry-point auto-detection; no Pro tierget_ranked_context+get_context_bundle— true token-budgeted retrieval with BM25, PageRank, fusion strategiesget_symbol_importance,get_repo_map,get_tectonic_map— PageRank centrality + 3-signal module topology (no vexp equivalent)- Opt-in hybrid BM25 + vector search via
search_symbols(semantic=true); bundled ONNX (all-MiniLM-L6-v2), sentence-transformers, Gemini, or OpenAI - AI summaries via 6 providers: Anthropic, Gemini, OpenAI-compat, MiniMax, GLM-5, OpenRouter (free model); circuit-breaker protection
get_changed_symbols,get_blast_radius(depth-scored),get_impact_preview,get_pr_risk_profile(Phase 7 runtime-aware — fuses static + production trace evidence)assemble_task_context(v1.105.0) — task-aware single-call orchestrator. Direct counterpart to vexp'srun_pipeline: explainable intent classification (6 intents with matched keywords + confidence), per-entry source attribution, runtime evidence woven in, override hooks for forcing stages, end-to-end token budget. Free.- Architectural intelligence:
find_similar_symbols(consolidation clusters),get_group_contracts(cross-repo API surface),find_implementations(4-channel impl discovery),check_delete_safe(8-tier deletion preflight) - Cross-repo built-in:
get_cross_repo_map,cross_repo=trueon find_importers / get_blast_radius / get_dependency_graph — no separate "repo cap" tier - Runtime evidence:
get_runtime_coverage,find_hot_paths,find_unused_paths— Phase 7 trace ingestion (OTel / SQL log / stack-frame log) index_filefor surgical reindex; Claude Code PostToolUse hook auto-triggers after every edit;watch-claudeauto-discovers worktrees- jDocMunch: section-level search across .md, .rst, .ipynb, HTML; jDataMunch: SQLite-backed tabular data MCP
- Open source; v1.104.0 with 4,227 tests; supply-chain integrity check at startup;
trusted_foldersallowlist
submit_lsp_edges as a pushed-in data channel (caller hands vexp LSP-resolved edges)
is an interesting integration shape we don't expose — our LSP bridge is pull-based.
The VS Code extension lowers setup friction for IDE-bound users compared to a raw
MCP server configuration.
Their intent detection (adapts search strategy by task type — debug/refactor/modify)
is a novel UX idea that maps to our agent_selector + plan_turn infrastructure but isn't packaged
identically.
If these specific capabilities are blockers, vexp is worth evaluating — at Pro pricing.
code-review-graph
code-review-graph
(v2.3.3, May 8 2026) is an open-source MCP server that builds a persistent SQLite knowledge graph
using Tree-sitter, tracks changes incrementally, and surfaces blast-radius context to AI coding
assistants at review time. It auto-configures Claude Code, Cursor, Windsurf, Zed, Continue, and
OpenCode on a single install command, and updates the graph automatically on every
file save and git commit. 16k GitHub stars (up from 4.3k earlier in 2026 — one
of the fastest-growing tools in this category). 28 MCP tools, MIT license. Published benchmarks:
8.2× average token reduction across 6 real repositories, range 4.9× to 27.3× depending on repo —
though performance drops below 1× on small single-file edits in compact packages like Express.
- 28 MCP tools:
build_or_update_graph_tool,get_minimal_context_tool,detect_changes_tool,query_graph_tool,semantic_search_nodes_tool,traverse_graph_tool+ community detection / architecture / refactoring suite - 8.2× avg token reduction on commit-scoped reviews; 4.9× to 27.3× range across repos — published methodology
- Blast-radius with 100% recall — never misses an impacted file; F1 0.54 / precision ~0.38 (deliberately conservative over-prediction)
- Below-1× on small single-file Express changes — graph context exceeds raw file; acknowledged in their own benchmarks
- 5 built-in MCP prompt templates: review, architecture, debug, onboard, pre-merge
- D3.js interactive force-directed graph visualisation with edge-type toggles
- Community detection via Leiden algorithm + auto-generated Markdown wiki
- Architecture overview map with coupling warnings
- Test coverage gap detection embedded in blast-radius analysis
- Incremental re-index in <2s on 2,900-file repos via SHA-256 diff
- Multi-repo registry — search across registered repos
- 24 languages incl. Jupyter notebooks; no YAML/Ansible, Razor/Blazor, SQL/dbt/SQLMesh, Erlang, Fortran, AL, Verse, GraphQL, OpenAPI
- No documentation/data layer (no .md/.rst/.ipynb section search, no schema exploration)
- No named per-symbol retrieval — context is always blast-radius sets, not individual symbols
- No token-budget parameter on retrieval; no PageRank/centrality ranking; no runtime evidence
- MRR 0.35 on keyword search; flow detection 33% recall outside Python repos (acknowledged)
- 80+ MCP tools across the suite
- 58–100× token efficiency on full-codebase exploration tasks (Express, FastAPI, Gin — tiktoken-measured, raw data and harness at benchmarks/)
- 70+ languages — YAML/Ansible, Razor/Blazor, SQL/dbt/SQLMesh, Erlang, Fortran, AL, Verse, GraphQL, OpenAPI, and more
- Named per-symbol retrieval:
get_symbol_source,get_symbol_diff,get_context_bundle— read exactly what you need, nothing more get_ranked_context— token-budgeted retrieval with BM25, PageRank, and fusion strategies (the budget knob code-review-graph doesn't expose)assemble_task_context(v1.105.0) — task-aware single-call orchestrator. Direct counterpart to code-review-graph'sget_minimal_context_tool: explainable intent classification (review intent runsget_changed_symbols+ blast + risk + similar-changed clusters in one call), per-entry source attribution, override hooks, end-to-end token budget.get_blast_radiuswith depth-scored risk + per-hopimpact_by_depth+has_test_reach;get_changed_symbolsmaps a git diff to affected symbols;get_pr_risk_profilewith Phase 7 runtime-aware scoringfind_dead_code+find_similar_symbols(consolidation clusters) +get_untested_symbols+check_delete_safe(deletion preflight with 8-tier verdict) +find_implementations(4-channel impl discovery) +get_group_contracts(cross-repo API surface)get_tectonic_map— 3-signal community detection (imports + shared refs + git co-churn) vs. their Leiden-only approach;get_repo_mapfor PageRank-ranked overview- Runtime evidence:
get_runtime_coverage,find_hot_paths,find_unused_paths— Phase 7 trace ingestion (OTel / SQL log / stack-frame log) - Opt-in hybrid BM25 + vector search via
search_symbols(semantic=true); bundled ONNX, sentence-transformers, Gemini, or OpenAI - AI summaries via 6 providers with circuit-breaker;
suggest_queriesfor unfamiliar repos;audit_agent_configfor stale-reference detection - jDocMunch: section-level search across .md, .rst, .ipynb, HTML; jDataMunch: schema exploration, drift, data hotspots
- 5 MCP prompt templates: workflow, explore, assess, triage, trace
- v1.104.1 with 4,228 tests; supply-chain integrity check at startup;
trusted_foldersallowlist
render_diagram
for static output but not interactive WebGL/force-directed graphs.
Their 16k-star trajectory (roughly 4× growth in 2026) is real adoption momentum and worth
respecting. If your primary workflow is PR-scoped code review with visual graph exploration rather
than open-ended codebase exploration, code-review-graph's commit-centric design is a closer fit.
cymbal
cymbal is a Go CLI for code symbol navigation. It parses your repo with tree-sitter,
stores symbols and imports in a local SQLite/FTS5 database, and answers queries in roughly
10–40ms. It ships a CLAUDE.md policy block that instructs agents to call
cymbal instead of Read, Grep, Glob, or Bash — the same agent-integration
approach jCodeMunch pioneered. v0.13.1 (May 2026) added --graph mode for
trace/impact/importers/impls (Mermaid,
DOT, JSON outputs), a structure command for entry-point and hotspot overview,
impls for finding implementers/conformers, diff for git diffs
scoped to a symbol's line range, and one-line agent-hook installers for OpenCode and
Claude Code. The core commands — search, show,
refs, importers, impact, context,
outline — map closely to jCodeMunch's search_symbols,
get_symbol_source, find_references, find_importers,
get_blast_radius, get_context_bundle, and
get_file_outline. The meaningful difference is delivery: cymbal is a CLI
subprocess; jCodeMunch is a native MCP server. For teams already using Python, that's a
footnote. For teams on Go stacks, it's a real advantage.
- tree-sitter AST → SQLite/FTS5 index; ~10–40ms query latency on the bench corpus
- Named on-demand symbol retrieval:
cymbal show <symbol> - Call graph traversal:
cymbal trace(down) +cymbal impact(up, depth cap 5);--graphmode emits Mermaid/DOT/JSON structurecommand for entry points / hotspots / central packages;implsfor implementers/conformers;difffor symbol-scoped git diffsinvestigateadaptive single-call command; batch mode (cymbal investigate Foo Bar Baz)- Go binary — no Python runtime; Homebrew / AUR / PowerShell / Docker /
go install - JIT freshness: auto-detects changed files via mtime+size before every query — no watch daemon
- 20 parseable languages; per-OS cache index (
~/.cache/cymbal/repos/<hash>/index.db); fully offline - One-line agent-hook installers:
cymbal hook install opencode/claude-code(install-only — no uninstall, no status, no per-target dry-run) - CLI subprocess — agent shell-outs via Docker or bash; not an MCP server
- FTS5 keyword search only; no vector/embedding layer
- 14 commands; no doc section search, no dead code detection, no session analytics, no rename/delete-safety preflight
- Native MCP server (stdio, SSE, streamable-http) — tools appear directly in Claude, Cursor, Windsurf, Zed, Continue
- 80+ tools covering symbol retrieval, session context, architectural health, data-layer exploration, and doc search
- Opt-in BM25 + vector hybrid search (
embed_repo) — 3 embedding providers; FTS5 when disabled - 70+ languages incl. YAML/Ansible, Razor/Blazor, SQL/dbt, Erlang, Fortran
- Published, reproducible benchmarks: 58–100× token reduction (tiktoken-measured, 3 production repos)
find_dead_code,get_hotspots,get_churn_rate,audit_agent_config- Refactoring preflight tools cymbal doesn't ship:
check_rename_safe,check_delete_safe,find_similar_symbols,assemble_task_context,get_group_contracts - Per-agent installer with uninstall + status (v1.105.1):
jcm install claude-desktop/install --list/install-status --json/uninstallwith scoping flags (--keep-claude-md, etc.) — supports 5 clients vs. cymbal's 2, preserves user-authored hook rules on uninstall render_diagramemits Mermaid for any graph tool — same visual output cymbal's--graphproduces, but from richer signals- jDocMunch for section-level doc retrieval; jDataMunch for tabular data
pip install jcodemunch-mcp— works in any MCP-compatible client
search_symbols and
get_symbol_source appear alongside the agent's built-in tools
with full type signatures and structured return values.
On benchmarks: cymbal's bench harness reports 40–100% fewer tokens on focused investigations vs. grep-driven flows, 113/113 accuracy checks passed, and 79/79 ground-truth passes at 100% search precision/recall. jCodeMunch's 58–100× figure uses a different baseline (concatenating all source files) and a different measurement method (tiktoken against 3 production repos with published raw data). The claims are not directly comparable — ripgrep already reduces context vs. full-file reads, so the baselines diverge significantly. Both projects publish their benchmark harnesses, which is the right standard.
investigate adaptive command, the new
--graph mode, and the one-line agent-hook installers are genuine
additions worth respecting.
For most teams, jCodeMunch's advantages are decisive: native MCP integration (no subprocess wiring), 70+ languages vs. 20, hybrid semantic search, 80+ tools including dead code detection, session analytics, and refactoring preflight (
check_rename_safe, check_delete_safe,
find_similar_symbols) — none of which cymbal ships — plus
tiktoken-measured production benchmarks.
If Python is already in your stack, jCodeMunch is the stronger choice.
If your team is Go-only and subprocess orchestration is acceptable, cymbal is a
credible alternative worth evaluating.
Context+
Context+ (github.com/ForLoopCodes/contextplus) is a TypeScript MCP server that transforms
codebases into searchable, hierarchical feature graphs for AI coding assistants. It combines
tree-sitter AST parsing (43 languages), embedding-based semantic search via Ollama (default)
or any OpenAI-compatible endpoint (OpenAI, Gemini free tier, Groq, vLLM), spectral clustering,
and Obsidian-style wikilink hubs. v1.0.9 (May 2026) adds run_static_analysis
that delegates to native linters/compilers (TypeScript, Python, Rust, Go) for unused-variable
and type-error detection, plus one-line CLI init for Claude Code, Cursor, VS Code, Windsurf,
and OpenCode. Bundles shadow restore points for undo without git involvement and a six-tool
memory graph for RAG-style cross-session knowledge. At 1,878 stars (148 forks), it has
meaningful adoption.
- 43 languages via tree-sitter; AST extraction with embedding-based search
- Spectral clustering groups semantically related files into navigable clusters
- Obsidian-style wikilink hubs connect features to code locations
get_blast_radiusand call-site tracing for impact analysisrun_static_analysisdelegates to native linters/compilers (TS, Python, Rust, Go) — requires those toolchains installed- Shadow restore points — undo changes without git involvement;
propose_commitis the only write path - Memory graph with RAG:
upsert_memory_node,search_memory_graph,retrieve_with_traversal(6 memory tools) - Multi-provider embeddings: Ollama (default) or OpenAI-compatible (OpenAI, Gemini free tier, Groq, vLLM) — fully offline only with Ollama
- CLI init for 5 IDEs (Claude Code, Cursor, VS Code, Windsurf, OpenCode);
skeleton/treeCLI for terminal use without MCP - No token-reduction benchmarks published; "99% accuracy" claim without methodology
- 17 tools total; no doc section search, no churn/hotspot analysis, no refactoring preflight
- 70+ languages via tree-sitter — including YAML/Ansible, Razor/Blazor, SQL/dbt, Erlang, Fortran, COBOL
search_symbols+get_symbol_sourcereturn exact implementations, not graph summaries- Published, reproducible benchmarks: 58–100× token reduction (tiktoken-measured, 3 production repos)
find_importers,find_references,get_blast_radiuswith depth-scored risk andhas_test_reachfind_dead_codewith confidence scoring — pure-AST, no native linter required (vs. Context+'s linter delegation)- Refactoring preflight Context+ doesn't ship:
check_rename_safe,check_delete_safe,find_similar_symbols,find_implementations get_hotspots;get_churn_rate;audit_agent_config;get_pr_risk_profile- Opt-in BM25+vector hybrid search with 3 embedding providers — works fully offline with BM25 alone
get_ranked_context+assemble_task_contextassemble token-budgeted context bundles ranked by BM25 + PageRank- CLI init for 5 IDEs (same coverage as Context+) via
jcm install <agent>+uninstall+install-status(v1.105.1) - jDocMunch for section-level doc retrieval; jDataMunch for tabular data exploration
- 80+ tools covering symbols, context, architecture health, session analytics, runtime traces, and cross-repo maps
propose_commit) that jCodeMunch intentionally excludes as a read-only tool.
upsert_memory_node, create_relation,
retrieve_with_traversal) gives agents persistent, cross-session knowledge that
survives context compaction — a capability jCodeMunch does not offer. The spectral clustering
and wikilink hubs provide a "feature map" view of a codebase that is useful for orientation.
The shadow restore points are a creative alternative to git stash for quick undo.
run_static_analysis
and the multi-provider embedding flexibility (Ollama / OpenAI / Gemini free tier / Groq /
vLLM) are credible adds. It remains a strong choice for teams that prioritise holistic
codebase navigation and session-persistent knowledge.
jCodeMunch's advantages are measurable and have widened since the last review: 58–100× token reduction (published, reproducible), 70+ languages vs. 43, 80+ tools vs. 17, token-budgeted retrieval, pure-AST dead-code detection (no native-linter dependency), refactoring preflight (
check_rename_safe / check_delete_safe /
find_similar_symbols) that Context+ doesn't ship, architectural health metrics,
and a fully offline mode that requires no external embedding API.
For teams that want precise, benchmarked code retrieval with the broadest language
and tooling coverage, jCodeMunch is the stronger choice. For teams that want graph-based
navigation with persistent cross-session memory, Context+ remains worth evaluating.
Axon — Knowledge-Graph Code Intelligence
Axon indexes codebases into a KuzuDB knowledge graph with community detection (Leiden algorithm),
execution flow tracing, and hybrid search (BM25 + vector + fuzzy). It also ships an interactive
web dashboard with force-directed graph visualization at localhost:8420.
662 stars, MIT licensed, Python/JS/TS only (3 languages via tree-sitter).
- KuzuDB graph backend with Cypher query console — powerful for ad-hoc exploration
- Leiden community detection auto-discovers architectural clusters
- Execution flow tracing: detects entry points, traces BFS paths from each
- Multi-pass dead code with Protocol conformance and override awareness
- Hybrid search (BM25 + 384-dim vector + Levenshtein) fused via RRF
- Interactive web UI (Sigma.js + WebGL): force-directed graph, health dashboard, Cypher console
- Python, JavaScript, TypeScript only — 3 languages total
- Heavy dependency footprint: kuzu, igraph, leidenalg, fastembed, fastapi, uvicorn
- No token-budgeted retrieval, no doc search, no cross-repo support
- No published token-reduction benchmark or reproducible methodology
- 70+ languages (incl. YAML, Razor, SQL/dbt, Erlang, Fortran, COBOL, Zig, PowerShell)
- 58–100× token reduction, published with reproducible methodology and raw data
- 50+ tools: blast radius, hotspots, coupling metrics, tectonic plates, signal chains, refactoring planner
- Signal chain discovery: traces gateway-to-leaf pathways with rich labels (POST /api/users, cli:seed-db)
- Tectonic map: 3-signal fusion (structural + behavioral + temporal) community detection
- Token-budgeted retrieval: get_ranked_context packs results into a token budget
- Doc section search via jDocMunch (.md, .rst, .ipynb, HTML)
- Cross-repo dependency tracing via get_cross_repo_map
- Claude Code hook integration (PreToolUse/PostToolUse auto-reindex)
- Lightweight: pure Python, SQLite-backed, no graph database dependency
The web dashboard is a real differentiator for developers exploring code visually — force-directed graphs, community hull overlays, and the Cypher console are features no other MCP tool in this space offers. The Protocol-aware dead code analysis is also more sophisticated than most competitors. If your team is Python/JS/TS-only and wants a visual exploration layer alongside MCP, Axon is worth trying.
jCodeMunch covers 70+ languages, provides 58–100× measured token reduction (published methodology), offers 50+ tools including signal chain discovery (our answer to execution flow tracing — with richer gateway labeling and tectonic plate integration), and requires no graph database runtime. For teams that need broad language support, benchmarked efficiency, and the deepest tooling surface, jCodeMunch is the stronger choice. For Python/JS/TS teams that want a visual graph dashboard, Axon is a credible alternative.
SocratiCode — Enterprise Vector Code Intelligence
SocratiCode indexes codebases into per-branch Qdrant vector collections with AST-aware chunking via ast-grep (18+ languages, line-based fallback elsewhere). It combines dense vector + BM25 retrieval via Reciprocal Rank Fusion across 6 embedding providers (Local Ollama, Docker Ollama, OpenAI, Gemini free tier, LM Studio, LiteLLM). v1.8.10 (May 2026) ships native plugins for Claude Code, VS Code/Cursor (Marketplace + Open VSX), Gemini CLI, OpenCode, and Codex, plus one-click MCP install URLs. Adds polyglot dependency graph with circular-dep detection, symbol-level impact analysis, call-flow tracing, interactive HTML graph viewer, multi-agent shared index (cross-process file locking), and resumable batched indexing. Battle-tested on 40M+ LOC repos. Sister project JanuScope (MCP governance proxy) and SocratiCode Cloud (private beta — SSO, audit, VPC/air-gap) extend the offering. 2,477 stars, AGPL-3.0.
- Per-branch separate Qdrant vector collections — true branch isolation (opt-in via
SOCRATICODE_BRANCH_AWARE=true) - Hybrid search: dense vector + BM25 sparse, fused via RRF; 6 embedding providers
- AST-aware chunking via ast-grep for 18+ languages (line-based fallback for others)
- Polyglot dependency graph with circular-dep detection; Mermaid diagram output
- Symbol-level impact analysis + call-flow tracing across 18 languages
- Interactive HTML graph viewer (webview in VS Code extension)
- Multi-agent shared index via
proper-lockfilecross-process locking (single lock scope; holder identity not surfaced cross-process) - Resumable batched indexing — checkpoints every 50 files, survives crashes/restarts
- Cross-project/repo search across linked codebases (
.socraticode.json) - Native plugins: Claude Code, VS Code/Cursor (Marketplace + Open VSX), Gemini CLI, OpenCode, Codex; one-click MCP install URLs
- Sister projects: JanuScope (MCP governance proxy) + SocratiCode Cloud (private beta — SSO, audit, VPC/air-gap)
- Self-reported: 61% less tokens, 84% fewer calls, 37× faster than grep on VS Code 2.45M LOC w/ Claude Opus 4.6
- Docker required for default zero-config mode (auto-managed); external Qdrant + native Ollama optional
- AGPL-3.0 copyleft (MCP-server use generally fine; redistribution / SaaS embedding triggers obligations)
- No dead code detection, no refactoring preflight, no doc section search, no churn/hotspot analysis
- Benchmark baseline is grep, not raw file reads — not directly comparable to tools that benchmark against agent file reads
- 70+ languages (incl. YAML, Razor, SQL/dbt, Erlang, Fortran, COBOL, Zig, PowerShell)
- 58–100× token reduction, published with reproducible methodology and raw data — benchmarked against actual agent file reads
- 80+ tools: blast radius, hotspots, coupling metrics, tectonic plates, signal chains, refactoring planner, PR risk profile
- Refactoring preflight SocratiCode doesn't ship:
check_rename_safe,check_delete_safe,find_similar_symbols,find_implementations - Token-budgeted retrieval:
get_ranked_context+assemble_task_contextpack results into a token budget - Pure-AST dead code detection with confidence scoring and cascading chain analysis
- Runtime trace ingestion (OTel / SQL logs / stack traces) layered onto static signals — capability SocratiCode doesn't offer
- jDocMunch for section-level doc retrieval; jDataMunch for tabular CSV/Excel exploration
- Zero Docker, zero external databases — pure Python, SQLite-backed, pip install
- One-click install via
jcm install <agent>(5 IDEs) +uninstall+install-statusverbs (v1.105.1) - Multi-process shared index (v1.106.0): two lock scopes (watcher + indexwrite), holder identity surfaced via
get_watch_status.watcher_holder={pid, client_id, started_at, age_seconds}— agents see when a parallel session is live and why our watcher is idle - Claude Code hook integration (PreToolUse/PostToolUse auto-reindex)
- Cross-repo dependency tracing via
get_cross_repo_map+get_group_contractswith stability scoring - MIT licensed — no copyleft, no commercial-use friction
The per-branch vector collection approach gives complete branch isolation with no index composition overhead at query time. The Qdrant backend is battle-tested for large-scale vector search (40M+ LOC enterprise validation), and the multi-provider embedding model (local Ollama through Gemini free tier) offers genuine flexibility. The distribution story has matured significantly: native plugins for Claude Code, VS Code, Cursor, Gemini CLI, and OpenCode, plus one-click MCP install URLs — on par with the most polished offerings in the space. The multi-agent shared index via cross-process file locking is a real differentiator for parallel-agent workflows. If your team already runs Docker and wants production-grade vector search with branch isolation, SocratiCode is a credible option.
cat / Read (which is what agents actually do without
a code-intelligence layer). Docker is still required for the default zero-config experience —
while it's now auto-managed (auto-pulls images, auto-starts containers), the operational footprint
remains larger than a pip-install tool. AGPL-3.0 copyleft is fine for in-house MCP-server use but
triggers obligations if you redistribute or embed in a SaaS product — check with counsel if
that's a fit concern.
jCodeMunch's advantages remain measurable and have widened: 70+ languages vs. 18+, 58–100× token reduction (published methodology, benchmarked against actual agent file reads — not grep), pure-Python pip-install with no Docker, an 80+ tool surface including refactoring preflight (
check_rename_safe, check_delete_safe,
find_similar_symbols), pure-AST dead-code detection, runtime trace ingestion,
v1.106.0 multi-process shared-index coordination with two lock scopes and cross-process
holder identity surfaced through get_watch_status, and the jDocMunch + jDataMunch
sister suites — none of which SocratiCode offers. MIT license avoids the AGPL
redistribution friction.
For teams that want the deepest analysis tooling with zero-infra setup, multi-agent
parallel workflows, and MIT-clean licensing, jCodeMunch is the stronger choice. For teams
already on Docker with 10M+ LOC repos who need resumable batched indexing, a polished
plugin experience, and the enterprise distribution / governance / cloud story, SocratiCode
is worth evaluating.
Octocode — Rust-based Structural Code Intelligence
Octocode (by Muvon) is a Rust-built MCP server plus CLI that combines a LanceDB
vector index with a typed knowledge graph for AI-agent code retrieval. Tree-sitter
parses 14 languages (Rust, Python, TypeScript / JavaScript, Go, PHP, C++, Ruby,
Java, Lua, Svelte, plus configs). The knowledge graph extracts 11+ relationship
types — imports, calls, implements,
extends, configures, and others — with importance
weighting, alongside structural AST pattern matching (e.g. find every
.unwrap() call). Documentation is indexed as a separate corpus mode
alongside code; commit history is also searchable. Five embedding providers ship:
Voyage AI (default), OpenAI, Jina, Google, and a fully-local model option on macOS
ARM. Apache-2.0, 374 stars, v0.14.1 (April 2026). Genuinely lightweight install
— LanceDB is embedded, no Docker, no Qdrant.
- Knowledge graph with 11+ typed relationships (
imports,calls,implements,extends,configures, ...) and importance weighting - Structural AST pattern search — find every
.unwrap(), everynewinstantiation, etc. across the corpus - 14 languages via tree-sitter (Rust, Python, TS / JS, Go, PHP, C++, Ruby, Java, Lua, Svelte, JSON, CSS, Bash, Markdown)
- Documentation indexed as a separate corpus mode; commit-history search included
- 5 embedding providers: Voyage AI (default), OpenAI, Jina, Google, local model on macOS ARM
- LanceDB embedded; no Docker, no external vector database, no separate index process
- Published retrieval-quality benchmark: 254 hand-annotated queries (127 code + 127 docs), code Hit@10 = 0.992 / MRR = 0.895, docs Hit@10 = 0.953 / MRR = 0.776, methodology in
benchmark/ - Apache-2.0 — permissive, commercial use fine
- Rust binary — fast cold-start, single executable, no Python runtime
- No dead-code detection, no refactoring-preflight tooling (no
check_rename_safe/check_delete_safeequivalents) - No churn / hotspot / coupling metrics; no PR-risk profile; no runtime-trace ingestion
- No doc-section indexer in the structural sense (jDocMunch's heading hierarchy + section boundaries with byte-precise offsets)
- Default embedding path is cloud (Voyage AI); fully-offline operation is platform-restricted (macOS ARM local model)
- Benchmark axis is retrieval quality (Hit@10 / MRR), not token economics — not directly comparable to jCodeMunch's 58–100× vs. raw file reads
- 70+ languages vs. 14 (incl. YAML / Ansible, Razor / Blazor, SQL / dbt, Erlang, Fortran, COBOL, Zig, PowerShell, MATLAB, Ada)
- 58–100× token reduction vs. raw agent file reads, published methodology + reproducible test harness
- 81 tools (Octocode ships a smaller surface focused on search / index / graph / structural patterns)
- Refactoring preflight:
check_rename_safe,check_delete_safe,find_similar_symbols,find_implementations— not in Octocode - Pure-AST dead-code detection with confidence scoring + cascading chains + entry-point heuristics
- Hotspots, churn, coupling metrics, tectonic plates, signal chains, PR risk profile (none of which Octocode offers)
- Runtime trace ingestion (OTel / SQL logs / stack traces) layered onto static signals — capability Octocode doesn't have
- Token-budgeted retrieval:
get_ranked_context+get_context_bundlepack results into an explicit token budget; Octocode has no budget API - Sister suites: jDocMunch for section-level doc retrieval (heading hierarchy, byte-precise offsets), jDataMunch for tabular CSV / Excel / Parquet
- Multi-process shared index (v1.106.0): two lock scopes (watcher + indexwrite), holder identity surfaced via
get_watch_status.watcher_holder - Claude Code hook integration (PreToolUse / PostToolUse auto-reindex);
jcm install <agent>auto-configures 5+ IDEs - Cross-repo dependency tracing (
get_cross_repo_map,get_group_contracts) with stability scoring
The typed knowledge graph with 11+ relationship types and importance weighting is a real differentiator — richer than what most code-MCP servers expose, and the Rust implementation means it's fast to query. Structural AST pattern search (find every
.unwrap(), every new instantiation) is a
genuinely useful capability that's rare in this space. The published 254-query
retrieval-quality benchmark with Hit@10 / MRR numbers is exactly the kind of rigour
we like to see: methodology in-repo, raw data preserved, reproducible. LanceDB
embedded means no Docker, no external services — the operational footprint
is genuinely small. Apache-2.0 is permissive. For teams who want a Rust-based
MCP server with strong graph relationships and don't need 70+ languages or
refactoring-preflight tooling, Octocode is a credible choice.
jCodeMunch's advantages are along different axes: 70+ languages vs. 14, token-savings benchmark (58–100× vs. raw file reads, methodology published), 81 tools including refactoring preflight (
check_rename_safe, check_delete_safe,
find_similar_symbols, find_implementations),
pure-AST dead-code detection, hotspots / churn / coupling metrics, PR risk
profile, runtime-trace ingestion, token-budgeted retrieval
(get_ranked_context), v1.106.0 multi-process shared-index
coordination, and the jDocMunch + jDataMunch sister suites for doc-section
retrieval and tabular data.
For teams that want the deepest analysis tooling across the broadest
language footprint with explicit token-budgeted retrieval and refactoring
preflight, jCodeMunch is the stronger choice. For teams on Rust / Python /
TS-heavy stacks who want a typed knowledge graph with structural AST search
and don't need the broader analysis surface, Octocode is worth
evaluating.
Repomix — by yamadashy
Repomix packs your entire repository into a single AI-friendly file (XML, Markdown,
or plain text) and hands it to the model in one shot. It is the most popular tool
in the “dump the codebase to the LLM” category — 24,609 stars,
JSNation Open Source Awards 2025 nominee (Powered by AI category), browser
extensions for Chrome and Firefox, a hosted website at repomix.com, a community
VS Code extension, an official three-plugin Claude Code marketplace
(repomix-mcp, repomix-commands, repomix-explorer),
and one-click MCP install URLs. v1.14.0 (April 2026) delivered a 2.4×
perf overhaul (3.3s → 1.4s on its own repo, ~58% pack-time reduction).
Its --compress mode uses tree-sitter to strip function bodies and keep
signatures; v1.14.0+ also ships --skill-generate for Claude Agent
Skills output, --include-logs / --include-diffs for git
history in the pack, and --stdin for piped file lists. The MCP server
now exposes 7 tools — including grep_repomix_output (regex
search inside the pack) and read_repomix_output with line-range
partial reads — meaningfully softening the “every prompt re-ships the
pack” criticism. Still pack-and-prompt at its core, but with selective retrieval
bolted on after the pack exists.
- →
npx repomixemits a single AI-friendly file containing the entire codebase (XML / Markdown / Plain Text) - →
--compressuses tree-sitter to strip bodies and keep signatures (~70–90% size reduction) - →
--include/--ignoreglobs; respects.gitignore+.repomixignore;--stdinaccepts piped file lists fromfind/fd/fzf/ripgrep - →
--include-logs/--include-diffsembed git history + working-tree diffs in the pack - →
--skill-generateemits Claude Agent Skills format under.claude/skills/<name>/; v1.14.0 adds monorepo-aware per-package tech-stack detection - →
--remote yamadashy/repo/ branch URL / commit SHA;--remote-trust-configopt-in for remote config execution (security fix in v1.13.0) - → Secretlint integration scrubs credentials before packing; v1.13.0 brought
npm auditto 0 vulnerabilities - → MCP server with 7 tools:
pack_codebase,pack_remote_repository,attach_packed_output(reuse existing pack),read_repomix_output(line-range partial reads),grep_repomix_output(regex search with context lines),file_system_read_file,file_system_read_directory - → Distribution polish: Chrome + Firefox extensions, VS Code Marketplace community extension (Repomix Runner), hosted web UI at repomix.com, official Claude Code plugin marketplace with 3 plugins (mcp / commands / explorer), one-click MCP install URLs, Discord community, DeepWiki
- → v1.14.0 perf: ~58% pack-time reduction via gpt-tokenizer (replaced WASM tiktoken), pipeline parallelization, lazy CLI dispatch
- ✗ No AST symbol graph — grep is regex over packed text, not symbol-aware (`find_references`, call hierarchy, blast radius all unavailable)
- ✗ The pack is the unit of work; selective retrieval is after-the-fact slicing, not a query-driven index
- ✗ No incremental index — re-running on a changed repo re-packs (mitigated by
attach_packed_outputif you can reuse a recent pack)
- ✓ AST-extracted symbols indexed once;
get_symbol_sourcereturns one function body per call — not the whole repo - ✓ SHA-256 incremental indexing;
index_filere-parses one file in milliseconds; multi-process shared index (v1.106.0) coordinates concurrent agents on the same repo - ✓
find_references,find_importers,get_blast_radius,get_call_hierarchy— symbol-aware graph tracing Repomix cannot do (regex on text doesn't know "imports" vs "references") - ✓ 70+ languages with custom parsers (Razor/Blazor, Erlang, Fortran, dbt SQL) where tree-sitter is incomplete
- ✓ 80+ MCP tools covering retrieval, architecture health, refactoring preflight (
check_rename_safe/check_delete_safe/find_similar_symbols), session analytics, runtime trace ingestion - ✓ Token-budgeted retrieval (
get_ranked_context,assemble_task_context) — agent says "top symbols within 4k tokens for this query" and the tool packs to fit - ✓ jDocMunch for section-level doc retrieval; jDataMunch for tabular CSV/Excel exploration
- ✓
jcm install <agent>(v1.105.1) one-click for Claude Code / Cursor / Windsurf / Continue / Claude Desktop; v1.107.0 adds--skillsto emit a Claude Agent Skill bundle (loaded on demand instead of always-on baseline policy) - ✓ v1.108.0 —
index_folder(paths=[...])— agent re-indexes exactly the files git just touched (or any explicit list / subdir set) without paying the cost of a full-tree walk.jcodemunch-mcp index . --paths-from -composes withgit diff --name-only/rg/fd - ✓ v1.108.0 — monorepo intelligence:
list_workspacesenumerates pnpm / yarn / npm / turborepo / lerna / rush / Go-workspaces / Cargo-workspaces members;get_project_intel(scope_path=...)answers "what is this package?" instead of repo-wide aggregates - ✗ No bulk “here is everything” pack — one-shot pack-and-prompt is a different operating mode
grep_repomix_output + read_repomix_output
let agents slice into an existing pack rather than re-shipping it, which is a real
improvement over older versions. But it's still slicing into a packed text file,
not querying a symbol-aware index — regex matches don't know which hits are
definitions, which are call sites, and which are unrelated comments. jCodeMunch
optimises for the agent loop: thousands of small symbol-aware retrievals across a
long session, with structural relationships (importers, references, blast radius)
that text grep cannot compute.
For multi-turn agent loops with thousands of small retrievals, jCodeMunch's symbol-aware index wins on substance: structural relationships (`find_references`, `find_importers`, `get_blast_radius`, `get_call_hierarchy`) that regex over packed text cannot compute, refactoring preflight (`check_rename_safe` / `check_delete_safe` / `find_similar_symbols`) that requires a graph not a grep, runtime trace ingestion that requires symbol identity, and the v1.106.0 multi-process shared index for parallel agents on the same repo. Use Repomix for one-and-done prompts and quick architectural reviews; use jCodeMunch for any multi-turn agent workflow that benefits from symbol-aware retrieval and graph relationships.
codebase-memory-mcp — by DeusData
codebase-memory-mcp is the closest peer to jCodeMunch in this comparison: an MCP
server that indexes a repo into a persistent knowledge graph, claims aggressive
token reduction, and ships as a one-command install. It compiles 155 vendored
tree-sitter grammars into a single static C binary, adds LSP-style hybrid type
resolution for Go, C, C++, and TypeScript, and exposes 14 MCP tools including
Cypher-like graph queries, dead-code detection, and HTTP route ↔ call-site linking.
A single install command auto-configures 11 coding agents.
- → 155 vendored tree-sitter grammars compiled into the binary; no runtime install
- → LSP-style hybrid type resolution for Go, C, C++, TS/JS/JSX/TSX (clean-room reimpl of tsserver / typescript-go)
- → CALLS, IMPORTS, IMPLEMENTS, INHERITS, DATA_FLOWS, SIMILAR_TO, SEMANTICALLY_RELATED edges
- → HTTP, gRPC, GraphQL, tRPC cross-service route linking; channel detection (Socket.IO, EventEmitter)
- → Bundled Nomic-embed-code embeddings (768d int8) compiled into the binary — semantic search with no API key
- → Cypher-like queries:
MATCH (f:Function)-[:CALLS]->(g) RETURN g.name - → 3D graph-visualisation UI (optional UI variant)
- →
installauto-configures Claude Code, Codex, Gemini, Zed, OpenCode, Aider, Antigravity, KiloCode, VS Code, OpenClaw, Kiro
- ✓ 70+ languages including ones tree-sitter does not cover natively (Razor/Blazor, Erlang, Fortran, dbt SQL with Jinja preprocessing, COBOL, Pascal, Ada)
- ✓
get_ranked_context— query-driven token-budgeted assembly (BM25 + PageRank + identity boost) - ✓
plan_refactoring— edit-ready rename/move/extract/signature-change plans - ✓
get_symbol_provenance— full git archaeology per symbol with semantic commit classification - ✓
get_pr_risk_profile— composite risk score fusing blast radius, complexity, churn, and test gaps - ✓
watch-claude/watch-all— auto-watch every Claude Code worktree; one-command login-service install - ✓ jDocMunch pairs natively for section-level doc retrieval (.md / .rst / .ipynb / HTML)
- ✓ Six-axis health radar +
get_pr_risk_profile+ observatory pipeline for cross-repo benchmarking - ✓ Production benchmarks: 58–100× token reduction vs raw file reads, replicated across Express, FastAPI, and Gin
arXiv:2603.27277, a paper number with a year-2603 prefix — arXiv
uses year-prefixed IDs, so the citation as written points to no real preprint.
The benchmark methodology in the README (31 repos, 83% answer quality, 10× tokens,
2.1× tool-call reduction) is plausible and well-described — treat the
arXiv pointer as a known typo, not a reason to discount the project.
CodeGraph — by colbymchenry
CodeGraph is a TypeScript MCP server that ships a pre-indexed knowledge graph to Claude Code — designed specifically to short-circuit the Explore-agent loop. It builds a SQLite + FTS5 graph of symbols, relationships, callers/callees, and framework-aware route nodes (13 frameworks: Django, Flask, FastAPI, Express, Laravel, Rails, Spring, Gin, Axum, ASP.NET, Vapor, React Router, SvelteKit). Its headline benchmark is striking: across 6 real-world codebases, Explore-agent sessions used 92% fewer tool calls and finished 71% faster with CodeGraph in the loop.
- → SQLite + FTS5 graph; filewatcher uses native OS events (FSEvents / inotify / ReadDirectoryChangesW) with debounced auto-sync
- →
codegraph_explorereturns entry points + related symbols + code snippets in one call — designed to replace Claude Code's Explore agent - →
codegraph_callers/codegraph_calleesfor impact analysis - → Framework-aware route nodes:
routenodes linked byreferencesedges to handler classes/functions across 13 web frameworks - → 19+ languages: TS, JS, Python, Go, Rust, Java, C#, PHP, Ruby, C, C++, Swift, Kotlin, Dart, Svelte, Liquid, Pascal/Delphi
- →
npx @colbymchenry/codegraph— interactive installer auto-configures Claude Code's MCP entry + auto-allow rules - ✗ Full-text only — no semantic / embedding search
- ✗ No doc section search
- ✓ Hybrid BM25 + semantic vector search (opt-in); local sentence-transformers, Gemini, or OpenAI embeddings
- ✓
get_ranked_context— query-driven token budget; BM25 + PageRank + identity boost - ✓
plan_refactoring— rename / move / extract / signature-change plans with edit blocks - ✓
get_pr_risk_profile— composite risk score for branch/PR review - ✓ jDocMunch for section-level doc retrieval;
get_project_intelfor Dockerfiles, CI, K8s, compose, .env templates - ✓ 70+ languages including dbt SQL (Jinja preprocessed), Razor/Blazor, Erlang, Fortran, COBOL, Pascal, Ada
- ✓ Multi-host: Claude Code, Cursor, Windsurf, Codex, Continue — not Claude-Code-specific
- ✓ Public observatory (jcodemunch-observatory) tracks 11 popular OSS repos weekly with six-axis health scores
SigMap — by manojmallick
SigMap takes a different angle: rather than expose retrieval tools to the agent,
it pre-computes a ranked file list for a query and writes compact function/class
signatures to a static .context file the agent reads at session start.
It uses TF-IDF over signatures — no embeddings, no graph — and ships a
reproducible benchmark suite (90 tasks, 18 public repos, archived on Zenodo) that
reports 80% hit@5 and 40–98% token reduction. The MCP server adds 9
on-demand tools, but the primary surface is the flat .context file.
.context file written for the agent- →
npx sigmap ask "Where is auth handled?"ranks files by TF-IDF and writes signatures to.context/query-context.md - →
sigmap validateconfirms the right files are in scope;sigmap judgescores answer groundedness;sigmap weightslearns from solved tasks - → Zero npm dependencies; standalone binaries (macOS arm64/x64, Linux x64, Windows x64) with SHA-256 checksums
- → Adapters write to host-specific files:
CLAUDE.md,.cursorrules,.windsurfrules,.github/copilot-instructions.md,AGENTS.md,.github/openai-context.md,.github/gemini-context.md - → IDE extensions: VS Code (Marketplace + Open VSX), JetBrains, Neovim
- → Fully reproducible benchmark on 90 tasks / 18 public repos, archived on Zenodo
- ✗ Signatures only — no body retrieval; agent still reads files for implementation
- ✗ TF-IDF only — no semantic embeddings, no graph, no call-tracing
- ✓
get_symbol_sourcereturns the exact body, not just the signature - ✓ Hybrid BM25 + semantic vector search (opt-in); semantic_weight tunable; local / Gemini / OpenAI embeddings
- ✓
find_references,find_importers,get_blast_radius— call-graph tracing SigMap does not have - ✓
get_ranked_context— query-driven, token-budgeted symbol assembly (not just file ranking) - ✓ 70+ languages including dbt SQL with Jinja preprocessing, Razor/Blazor, Erlang, Fortran, COBOL, Pascal, Ada
- ✓
plan_refactoring,get_pr_risk_profile,get_symbol_provenance— refactoring + review + archaeology features SigMap does not target - ✓ jDocMunch pairs for section-level doc retrieval (.md, .rst, .ipynb, HTML)
- ✗ No
judge/validate/weightstask-feedback loop — SigMap's adaptive ranking is genuinely interesting and unique to its approach
Read files for implementation.
jCodeMunch returns bodies directly via get_symbol_source, which is
where the bulk of the token savings come from.
judge / validate
/ weights feedback loop is unique — it scores answer groundedness
and learns ranking weights from successful tasks. jCodeMunch's tune_weights
learns from a ranking ledger but does not ask the agent for outcome feedback.
For teams that want a quantifiable "how often is the right file in context?" metric
with a published reproducible benchmark suite, SigMap's evaluation discipline is
best-in-class in this category.
trace-mcp
trace-mcp
(Nikolai Vysotskyi) is a TypeScript/Node MCP server — MIT, ~88 stars, AST-first via tree-sitter,
SQLite + FTS5 with optional bundled ONNX embeddings, read-only on source, no telemetry, index in
~/.trace-mcp/. It is the first alternative to compete on the same thesis jCodeMunch
is built on — that a structured, framework-aware graph beats blind file reads — rather than the
embedding-retrieval lane. Two standout ideas: (1) get_request_flow traces an HTTP request
route→middleware→controller→service→view, with cross-language bridges (e.g. Inertia::render('Users/Show')
linking PHP→Vue); and (2) decision-memory mining (mine_sessions / query_decisions)
pattern-scrapes agent session logs for architecture decisions and writes them into a graph that
auto-surfaces in get_change_impact. The cost of that ambition: a ~170-tool surface and a
per-framework plugin architecture (15+ framework plugins, 7 ORM adapters) extended stack-by-stack.
get_request_flowtraces route→middleware→controller→service→view — genuinely useful edges the raw call graph misses, with cross-language prop mapping- Coverage comes from 15+ framework plugins + 7 ORM adapters, each encoding one stack’s conventions — new frameworks need new plugins
- Decision-memory mining writes a persistent decision knowledge graph that auto-surfaces in
get_change_impact - ~170 MCP tools — broad, but a heavy tool surface that crowds the agent’s budget and trips tool-count caps
- TypeScript, MIT, read-only on source; tree-sitter AST + FTS5 + optional ONNX embeddings; very active (972 commits / 92 releases)
- Request flow:
get_signal_chains(v1.108.58) resolvesroute→handlerandrender→viewedges over the existing import graph — one language-agnostic resolver keyed on call shape, not a plugin per framework. Detects Djangopath()/re_path(), Express/Fastify/Koarouter.get(p, h), Flaskadd_url_rule, Railsto:— a new stack is a regex shape, not a new plugin (deeper middleware/service layers on the roadmap) - Decision memory:
get_blast_radius/get_impact_preview(v1.108.59, opt-ininclude_decisions) surface architecture-decision context — reverts, perf rewrites, refactors, root-cause fixes mined from the git commit record — with a volatility read, right where you ask “what breaks?” - Read-only by charter: trace-mcp scrapes agent session logs and writes a persistent decision graph; jCodeMunch reads the durable commit history and surfaces it then forgets — nothing persisted, no user file touched
- Tier-controlled tool surface (
set_tool_tier) keeps the agent’s tool budget lean instead of loading ~170 tools - 70+ languages, on-demand symbol retrieval, semantic search, dead-code detection, refactor planning, and a doc-side companion (jDocMunch)
RTK — Rust Token Killer
RTK is a Rust-based CLI proxy that intercepts terminal command output — pytest, cargo test, git diff — and compresses it before it reaches the AI's context. It claims ~89% average noise removal across 30+ development commands.
- Installs a PreToolUse hook — works transparently with any agent
- Excellent for test runners: pytest output drops from 756 to 24 tokens
- Excellent for git output: git diff drops from ~21,500 to ~1,259 tokens
- Written in Rust — single binary, <10ms overhead, zero dependencies
- MIT-licensed, free for individuals; $15/dev/mo cloud analytics tier
- Does not help with code reading — only with command output
- Answers "where is authenticate()?" without reading a single source file
- Symbol index persists across sessions — no re-reading on restart
- Structured MCP tool responses — agent gets typed results, not filtered text
- Import graph, reference tracing, file outlines all in one index
- jDocMunch handles the documentation side (RTK has no equivalent)
- Does not compress terminal output — that is RTK's lane
RTK cuts the noise from commands the agent runs (
git status, pytest, docker logs).
jCodeMunch cuts the noise from code the agent reads (get_symbol vs. reading 50 files).
A developer using both would eliminate the two biggest sources of context bloat in a typical coding session.
lean-ctx
lean-ctx is a Rust binary that acts as a token-compression layer between your
shell/editor and the LLM. It attacks the problem from two sides: a shell hook that
intercepts CLI output (git, npm, cargo, docker, k8s, and 30+ more) before it
reaches the model, and a 24-tool MCP server that serves files through seven
compression modes — map, signatures, diff,
aggressive (syntax-stripped), entropy-filtered, and range-limited
(lines:N-M). A published real-world session shows 89,800 tokens
compressed to ~10,620 — 88% reduction. It also ships three AI protocols: CEP
(adaptive communication), CCP (cross-session task/decision memory), and TDD
(token-dense shorthand). One-command agent integration:
lean-ctx init --agent claude-code.
- Shell hook: intercepts CLI output and strips noise before it enters context
- MCP file modes:
signaturesstrips bodies,aggressivestrips syntax,entropydrops low-information lines - ctx_delta, ctx_dedup, ctx_fill — cache-aware dedup and delta delivery
- Cross-session memory via ctx_session + ctx_knowledge (CCP protocol)
- Single Rust binary, zero dependencies, <10ms overhead, MIT-licensed
- Does not build a symbol index — it compresses files but can't answer "where is this function referenced?"
- One-time AST index — never reads the same function body twice
- Answers "where is
authenticate()used?" in one MCP call, no file reads - Blast radius, dead code, import graphs — structural queries lean-ctx has no equivalent for
- 70+ languages vs. lean-ctx's 14 (tree-sitter); YAML, SQL/dbt, Razor, Erlang included
- jDocMunch covers doc section retrieval; lean-ctx has no doc equivalent
- Does not compress terminal output — that is lean-ctx's lane (and RTK's)
lean-ctx compresses what flows into the context window on every tool call — file bytes, shell output, git diffs. jCodeMunch eliminates the need to make most of those file reads in the first place — index once, retrieve by symbol forever. Together they attack context bloat from both ends: lean-ctx cuts the fat from reads you do have to make; jCodeMunch eliminates the reads you don't.
ctx_read, ctx_smart_read, ctx_search) overlap superficially with jCodeMunch,
but the underlying approach is completely different: lean-ctx compresses file reads; jCodeMunch replaces them with indexed lookups.
lean-ctx wins on terminal output compression and file-read token density — it does things jCodeMunch doesn't try to do.
jCodeMunch wins on semantic code navigation — symbol search, reference tracing, blast radius, dead code — none of which lean-ctx provides.
A developer using both would eliminate context bloat at every layer.
Context Mode
Context Mode (github.com/mksglu/context-mode) is not a GitHub product — it's a
third-party MCP server by Mert Köseoğlu. Its tagline: "MCP is the protocol for tool
access. We're the virtualization layer for context." It tackles a real problem: every
tool call in a long agent session dumps raw output — bash commands, log files, web
fetches, GitHub API responses — directly into the context window. After 30 minutes
of work, 40%+ of your 200K token budget is consumed by noise. Context Mode installs
PreToolUse/PostToolUse hooks that intercept this output before it enters context,
routes anything over ~5 KB into a local SQLite FTS5 index, and exposes a
ctx_search tool so the model queries structured results instead of
receiving raw blobs. Sessions that previously hit limits in 30 minutes can run
for ~3 hours on the same budget.
- Intercepts bash, Read, WebFetch, Grep, Task calls via PreToolUse/PostToolUse hooks — output never enters context raw
- SQLite FTS5 index with BM25 ranking, Porter stemming, trigram fallback, and Levenshtein fuzzy correction
- PreCompact hook captures session state into a priority-tiered XML snapshot (≤2 KB) before auto-compaction fires
- SessionStart hook restores the snapshot — session continuity across context resets
- Hook-enforced: the agent cannot drift back to raw tool output even without explicit instructions
- Language-agnostic — works equally well on logs, web pages, git output, and source files
- Structured symbol extraction: the agent calls
search_symbols+get_symbol— raw file content never enters context - Published, reproducible benchmarks: 58–100× token efficiency on Express, FastAPI, and Gin production repos
- 70+ languages with AST-level understanding — not text search over raw bytes
search_symbols(fuzzy=true)— trigram Jaccard + Levenshtein fallback withmatch_type,fuzzy_similarity, andedit_distancefields; no FTS5 requiredfind_importers,find_references— structural code navigation, not BM25 approximation- jDocMunch for documentation — the same philosophy applied to .md/.rst/.ipynb/OpenAPI files
- PyPI package, Python ≥3.10, zero external binaries
OpenViking — by Volcengine (ByteDance)
OpenViking (github.com/volcengine/OpenViking) is an open-source context database for AI agents, built by ByteDance's Volcengine team. Its core idea: instead of dumping all agent memory into a flat vector database, organise it with a filesystem metaphor — hierarchical directories of memories, resources, and skills — with a three-tier loading model. L0 delivers one-sentence summaries (~100 tokens) so the agent decides whether to go deeper; L1 provides planning-level detail (~2 K tokens); L2 loads the full content on demand. The result is an agent that remembers across sessions, learns from past interactions, and avoids context explosion on long tasks.
- L0/L1/L2 tiered loading keeps long-running sessions from exhausting context on memory recall
- Filesystem directory metaphor organises memories, resources, and skills into navigable hierarchy
- Auto session management: compresses conversations and extracts durable long-term memories
- Multi-provider LLM support (Volcengine/Doubao, OpenAI, LiteLLM for Claude/Gemini/DeepSeek/Ollama)
- Embedding search via Volcengine, OpenAI, or Jina — semantic retrieval over stored context
- Retrieval trajectory visualization for debugging and optimisation
- Requires Python 3.10+, Go 1.22+, and a C++ compiler — non-trivial setup
- Depends on an external LLM provider; not offline-capable
- Structured symbol extraction: the agent queries
search_symbols+get_symbolrather than reading files - 70+ languages via tree-sitter AST — not text search, not LLM-driven; deterministic and reproducible
- No external LLM required; AI summaries are optional — core indexing and retrieval is pure local computation
- Zero runtime dependencies beyond Python 3.10+ and bundled tree-sitter grammars
- jDocMunch: section-level retrieval across .md, .rst, .adoc, .ipynb, HTML, OpenAPI, XML
- Published benchmarks: 58–100× token efficiency on real production repos (Express, FastAPI, Gin)
- Does not manage agent memory, learned facts, or cross-session agent state — that is OpenViking's lane
In multi-agent systems, OpenViking provides the persistent memory and skill library while jCodemunch + jDocMunch provide token-efficient access to the live code and documentation. They are complementary infrastructure at different layers — not alternatives to each other.
ClawMem — by yoloshii
ClawMem (github.com/yoloshii/ClawMem) is a local, on-device memory system and context engine for AI agents. It targets the same "agent amnesia" problem as OpenViking but takes a different approach: hybrid BM25 + vector search + cross-encoder reranking over a SQLite vault, all running on local GGUF models with no cloud dependency. It ships 28 MCP tools, Claude Code hooks (SessionStart, UserPromptSubmit, Stop, PreCompact), and — notably — a native OpenClaw ContextEngine plugin. Memories have typed lifecycles: decisions and knowledge hubs persist forever; progress notes decay after 45 days; handoffs after 30. Causal links between decisions are discovered automatically.
- Hybrid search: BM25 keyword + vector semantic matching + reciprocal rank fusion + cross-encoder reranking
- Self-evolving memory (A-MEM): automatic keyword extraction, tagging, and causal link discovery
- Typed content lifecycle: decisions/hubs = ∞, handoffs = 30 days, progress notes = 45 days
- Cross-session continuity via automatic handoff generation at session end
- PreCompact hook captures session state into a priority-tiered XML snapshot (≤2 KB) before context resets
- Native OpenClaw ContextEngine plugin — first-class integration, not a workaround
- Requires Bun v1.0+, 3 local GGUF models, 4–11 GB VRAM; WSL2 required on Windows
- Early-stage project (14 stars); API surface may evolve rapidly
- Answers structural questions: "Where is this function?" "What imports this module?" "What symbols changed?"
- Tree-sitter AST extraction across 70+ languages — deterministic, reproducible, no inference required
- No VRAM, no local model downloads, no Bun runtime — pip install and go
- Works on Windows natively (no WSL2 requirement)
- Published benchmarks: 58–100× token reduction on real production repos
- jDocMunch: section-level retrieval across .md, .rst, .adoc, .ipynb, HTML, OpenAPI
- Does not store agent decisions, session history, or cross-session memory — that is ClawMem's domain
mem0 — by mem0ai (YC S24)
mem0 (github.com/mem0ai/mem0) is the most widely adopted AI agent memory layer on GitHub, with 50K+ stars and Y Combinator S24 backing. It maintains multi-level memory — user preferences, session state, and agent-specific knowledge — that persists across interactions and adapts over time. Integrations exist for LangGraph, CrewAI, and other major agent frameworks. It ships as a self-hostable Python/TypeScript library and as a managed hosted platform. The library is open source under Apache 2.0; the hosted platform is a paid commercial product with undisclosed pricing.
- Multi-level memory: user-scoped preferences, session state, and agent-specific knowledge
- Adaptive personalization — memory evolves as the agent interacts, not just static storage
- Claims +26% accuracy, 91% faster responses, 90% fewer tokens vs. naive full-context approaches
- Python + TypeScript SDKs; integrates with LangGraph, CrewAI, and most major agent frameworks
- Self-hostable (Apache 2.0 library) or managed platform for production workloads
- Mandatory external LLM provider (defaults to OpenAI gpt-4.1-nano)
- Self-hosted production setup requires vector DB (Qdrant/Pinecone/Milvus), PostgreSQL, and LLM API keys
- Hosted platform pricing not publicly listed; requires signup or sales contact
- No external LLM required — tree-sitter AST parsing is pure local computation
- No vector database, no PostgreSQL, no infrastructure to manage beyond a pip install
- Published, reproducible benchmarks: 58–100× token efficiency on real production repos
- Works on Windows natively (no WSL2, no Docker, no managed service)
- 25+ programming languages via deterministic AST parsing, not probabilistic LLM memory extraction
- jDocMunch: section-level retrieval across .md, .rst, .adoc, .ipynb, HTML, OpenAPI
- Does not store user preferences, personalization data, or cross-session interaction history — that is mem0's domain
pip install mem0ai) is free under Apache 2.0.
What costs money is the managed hosted platform — automatic updates, analytics dashboards,
enterprise security, and operational overhead handed off to mem0ai's team.
For developers comfortable running their own infrastructure, self-hosted mem0 is free.
The real cost is the LLM API calls required for memory extraction and retrieval,
and the infrastructure burden of provisioning a vector store and database for production use.
LanceDB
LanceDB (github.com/lancedb/lancedb) is an open-source embedded vector database built on the Lance columnar format (Rust core). It handles multimodal data — text, images, video, point clouds, structured metadata — and delivers vector similarity search, full-text search, and SQL queries on the same table. It runs embedded (no server process) or as a managed cloud service. It is infrastructure: a high-performance storage and retrieval layer that other tools — mem0, OpenViking, RAG pipelines — might use as their backend.
- Embedded library — runs in-process, no server to manage; zero-copy architecture
- Vector similarity search + full-text search + SQL on the same table
- Multimodal: text, images, video, point clouds, structured metadata
- Automatic data versioning and schema evolution built in
- GPU-accelerated indexing; handles billions of vectors at petabyte scale
- Python, TypeScript, Rust SDKs; LangChain and LlamaIndex integrations
- Requires external embeddings — LanceDB stores and searches vectors but does not generate them
- No code understanding, no AST parsing, no symbol extraction — code is raw text
- Tree-sitter AST extraction — understands code structure, not just text similarity
- Zero mandatory embedding infrastructure — works out of the box with no vector DB, no cloud account, no embedding budget
- Optional hybrid semantic search via
search_symbols(semantic=true)— embeddings stored directly in the existing SQLite index; no separate vector store required - Symbol lookup is O(1) by name — deterministic exact retrieval, with optional semantic reranking when needed
- Structured results: function signatures, qualified names, parent/child hierarchy, import graphs
- jDocMunch preserves document heading hierarchy — sections are navigated structurally, not just by cosine distance
- One pip install; add
[semantic]extra only if you want embedding search — no Rust toolchain, no external DB - Not a general-purpose data store — purpose-built for code and documentation, nothing else
pip install jcodemunch-mcp[semantic]),
embeddings stored directly in SQLite alongside the existing index, and exact structural retrieval
as the default with no approximate-search false positives. The tools that use LanceDB as a backend (mem0, custom RAG
pipelines) sit at a higher layer than LanceDB itself and are closer comparisons to jCodeMunch.
QMD
QMD (github.com/tobi/qmd) is an on-device CLI search engine for markdown notes,
meeting transcripts, documentation, and knowledge bases. It combines BM25 full-text search,
vector semantic search, and LLM re-ranking — all running locally via node-llama-cpp and GGUF
models. Collections are indexed once; search runs with qmd search (fast BM25),
qmd vsearch (semantic), or qmd query (hybrid + reranking, best quality).
It also exposes a native MCP server with four tools — query, get,
multi_get, and status — making it suitable for agentic workflows.
A key feature is the context tree: hierarchical metadata attached to collections that gives
LLMs richer signals when selecting which documents to retrieve.
- Collections-based: index any folder of markdown files, meeting notes, or docs
- Three search modes: BM25 keyword (fast), vector semantic, hybrid + LLM reranking (best)
- Context tree: attach hierarchical metadata to collections for richer agent document selection
- Native MCP server: query, get, multi_get, status — designed for agentic flows
- All local: node-llama-cpp with GGUF models; no cloud calls; VRAM required for semantic modes
- CLI-first:
qmd search,qmd vsearch,qmd query,qmd get - Indexes unstructured prose — does not parse code structure, extract symbols, or understand imports
- Requires a one-time embed step; re-run after adding new documents
- Tree-sitter AST parsing — understands code structure, not just text similarity
- Symbol lookup is deterministic and O(1) by name — no approximate nearest-neighbor
- jDocMunch preserves document heading hierarchy — sections are navigated structurally, not by cosine distance
- No GGUF model, no VRAM required — works on any hardware; optional semantic search uses lightweight
sentence-transformersor a cloud API key, not a local inference server - Structured results: function signatures, qualified names, parent/child hierarchy, import graphs
- One pip install; no Node.js toolchain, no model download
- Not a general knowledge base tool — purpose-built for code repos and technical documentation
search_symbols(semantic=true)) uses lightweight sentence-transformers
or a cloud API key — no local inference server, no VRAM.
Obsidian
Obsidian is a personal knowledge management (PKM) application built on local plain-text
markdown vaults. Notes link to each other via [[wikilinks]], forming a
navigable graph of ideas. It runs entirely on your device, supports thousands of community
plugins, and optionally syncs across devices via Obsidian Sync. It is a human-facing writing
and thinking tool — not an indexing library or an MCP server. There is no official MCP
integration; community plugins can bridge the gap, but agent access to vault content is
not a first-class feature of Obsidian itself. Where jDocMunch fits is here: Obsidian vaults
are ordinary folders of .md files, and jDocMunch can index them directly —
making the vault's content searchable to AI agents at section granularity without any
Obsidian-specific tooling.
- Local markdown vault: plain
.mdfiles, no proprietary format lock-in - Bidirectional
[[wikilinks]]and graph view — navigate your knowledge visually - Canvas for infinite freeform brainstorming boards
- 1,000+ community plugins for tasks, spaced repetition, Dataview queries, diagrams, and more
- Obsidian Sync: E2E encrypted cross-device sync ($4/mo); Publish: instant web publishing ($8/mo)
- No native MCP server; community plugins provide partial agent access
- No indexing API for agents — content is authored via the GUI or filesystem writes
- Not a retrieval library; search is built for humans using the app, not for programmatic agent calls
- Points directly at an Obsidian vault folder — no format conversion, no plugin needed
- Section-level retrieval: returns the specific heading and its content, not the whole file
- Preserves document heading hierarchy — structural navigation, not approximate keyword match
- Native MCP server: agents call
search_sections,get_section,get_toc - No GUI, no sync, no visual graph — purely a retrieval layer for AI agents
- Incremental re-index: run again when vault files change; no continuous background process
- jCodeMunch indexes code repos in the same agent session — one MCP config covers both knowledge and code
.md
files, jDocMunch requires no Obsidian-specific knowledge — the vault is just a folder of markdown.
.md files in the vault are always plain text and fully portable.
chonkify
chonkify is an extractive document compression library aimed at fitting maximum signal into a token budget. Where jDocMunch indexes structured docs for on-demand section retrieval, chonkify compresses entire documents — particularly PDFs, which jDocMunch doesn't handle — before they reach an LLM. The two tools operate at different layers: chonkify is a preprocessing step; jDocMunch is a live retrieval layer.
- → Extractive compression — shrinks documents to fit a token budget
- → Supports .txt, .md, and .pdf (PDF is a genuine differentiator)
- → +59–84% better information recovery than LLMLingua in benchmarks
- ✗ Lossy — some content is discarded in the compression pass
- ✗ No MCP server — standalone library and CLI only
- ✗ Requires embedding model (~419 MB local or cloud API)
- ✗ Python 3.11 only — not available on 3.10 or 3.12+
- ✗ Proprietary license — evaluation-only; commercial use requires paid license
- ✗ Not on PyPI — wheel files only, distributed via GitHub
- ✓ Section-level indexing — AI retrieves only the relevant sections
- ✓ Lossless — returns exact source text, nothing discarded
- ✓ Native MCP server — works in Claude Code, Cursor, OpenCode, and any MCP client
- ✓ No embedding model needed — zero ML dependencies
- ✓ Python 3.10+ — broad compatibility
- ✓ .md, .rst, .adoc, .ipynb, .html, .txt, .yaml/.json (OpenAPI)
- ✓ Open source —
pip install jdocmunch-mcp - ✗ No PDF support — chonkify fills this gap
chonkify and jDocMunch are genuinely complementary. jDocMunch handles your structured documentation corpus (Markdown, RST, OpenAPI specs, notebooks) with zero token waste via live MCP retrieval. chonkify handles PDFs and long unstructured documents before they enter the context window. Together they cover the full document landscape — and chonkify's compressed output can itself be indexed by jDocMunch if you save it as Markdown.
chonkify launched this week. The proprietary license, the Python 3.11-only constraint, and the not-on-PyPI distribution model all add friction. The benchmark numbers are compelling but the test suite is small (5 documents, 2 token budgets). Worth watching — not yet worth building a production pipeline around.
Aegis
Aegis is a DAG-based Deterministic Context Compiler for AI coding agents. It stores your architecture documents in a SQLite knowledge base, maps them to file paths via dependency edges, and when an agent is about to edit code it returns exactly which guidelines apply — deterministically, with no search or RAG ranking. jCodeMunch answers “what does the code do”; Aegis answers “what rules must the code follow.” The two tools operate at different layers and pair naturally.
- → DAG of dependency edges maps architecture docs to file paths
- →
aegis_compile_contextreturns relevant guidelines before an edit - → Human-approval-gated knowledge base — agents cannot silently change rules
- → Observation layer learns from agent mistakes and PR merges over time
- → Optional SLM (llama.cpp) for intent tagging — off by default
- ✗ Knows nothing about live code structure — only the docs you feed it
- ✗ Requires manual population of the knowledge base to be useful
- ✗ TypeScript / npm only — no Python client
- ✓ Tree-sitter AST — live symbol extraction across 70+ languages
- ✓ Blast radius, dependency graph, class hierarchy, import tracing
- ✓ Zero setup —
index_folderonce, query immediately - ✓ 58–100× token reduction vs. raw file reads (real production benchmarks)
- ✓ No knowledge base to maintain — always reflects current code
- ✓
pip install jcodemunch-mcp— works in any MCP client - ✗ No architecture governance — Aegis fills this gap
Run both. Before an edit, call
aegis_compile_context to get the architectural constraints,
then get_blast_radius or get_context_bundle to understand the live code impact.
Aegis governs intent; jCodeMunch maps reality. Neither tool overlaps — together they give the agent
the full picture before a single line is written.
Caliber
Caliber is an AI tooling config manager. It scans your codebase, scores your existing AI setup
(deterministically, no LLM), and generates tailored CLAUDE.md, Cursor rules, AGENTS.md,
MCP server configs, and agent skills. It also detects config drift as your code evolves and updates
everything to match. jCodeMunch is one of the MCP servers Caliber discovers and configures —
the two tools operate at completely different layers.
- → Scans repo fingerprint (languages, frameworks, deps) and generates tailored configs
- → Deterministic config scoring — no LLM, no API key needed for
caliber score - → Auto-discovers and configures MCP servers (including jCodeMunch)
- → Session learning hooks capture agent corrections into
CALIBER_LEARNINGS.md - → Auto-refresh on git commit or session end keeps configs current
- → Supports Claude Code, Cursor, and Codex simultaneously
- ✗ Not a code exploration tool — no symbol extraction or AST parsing
- ✗ Generation requires an LLM (your existing seat or API key)
- ✓ Tree-sitter AST — live symbol extraction across 70+ languages
- ✓ 58–100× token reduction vs. raw file reads (real production benchmarks)
- ✓ Blast radius, dependency graph, class hierarchy, import tracing
- ✓ Zero LLM needed — pure deterministic AST parsing
- ✓ Native MCP server — plug into any MCP-compatible client
- ✓
pip install jcodemunch-mcp— no config scaffolding required - ✗ No config generation or setup management — Caliber fills this gap
Run
caliber init once to get a high-quality CLAUDE.md, MCP config, and skills scaffolded
for your project — including jCodeMunch auto-configured as your code exploration server. Then let
jCodeMunch handle every code query at runtime. Caliber sets the table; jCodeMunch does the work.
One tip: if you use Caliber's
CLAUDE.md regeneration, pin the jCodeMunch code
exploration policy block in CALIBER_LEARNINGS.md so it survives refreshes.
Citadel
Citadel is an agent orchestration harness for Claude Code. Its /do router classifies your
intent and dispatches it to the cheapest capable path — from a one-line fix to a multi-session
parallel campaign with persistence, quality gates, and a circuit breaker. jCodemunch is not an
orchestration tool; it is the retrieval layer those agents read through. The framing is simple:
Citadel tells Claude how to work; jCodeMunch tells Claude what the code is.
- →
/doroutes any task to the right tier automatically - → Campaign persistence — work survives session endings and restarts
- → Parallel agents in isolated git worktrees with discovery relay between waves
- → Circuit breaker: 3 failures → forced strategy change
- → 25 skills: review, test-gen, refactor, debug, research, QA, postmortem
- → 10 hooks: per-file typecheck, quality gate, pre-compaction save, external action gate
- ✗ No code retrieval — agents still read files via Read/Grep/Glob by default
- ✗ Claude Code only — not portable to Cursor or Codex
- ✓ Tree-sitter AST — exact symbols, not whole files
- ✓ 58–100× token reduction on code reads (real production benchmarks)
- ✓ Blast radius, dependency graph, class hierarchy — in one call
- ✓ Works in any MCP client — Claude Code, Cursor, Codex, Windsurf
- ✓ Zero workflow opinions — pure retrieval primitive
- ✓
pip install jcodemunch-mcp - ✗ No orchestration, routing, or campaign management — Citadel fills this gap
Citadel's most expensive skills —
/review, /refactor,
/systematic-debugging — involve reading large amounts of code. By default those reads
go through raw Read / Grep / Glob calls. Drop jCodeMunch into
your MCP config and those same skills consume a fraction of the tokens. Citadel handles the campaign;
jCodeMunch handles the reads. The combination stretches your Claude session limit further than either
tool can alone — especially relevant after Anthropic's March 2026 peak-hour throttle.
codesight — by Houseofmvps
codesight is a TypeScript MCP server that scans your project once per session and
compiles a high-level architectural map: routes, schemas, middleware chains, component
relationships, and import graphs. Its 8 tools answer questions like “what does this
service do?” and “where does this route flow?” — not “show me the implementation of
authenticate().” There is no persistent index; each session starts
from a fresh zero-dependency npx codesight scan.
A Reddit user summed up the distinction well: “codesight for orientation and
architecture, jCodeMunch for precise symbol retrieval.”
- → One-shot scan compiles routes, schemas, middleware chains, and import graphs per session
- →
codesight_get_routes,codesight_get_schema,codesight_get_wiki_articleanswer high-level structural questions fast - → Zero-install TypeScript CLI —
npx codesight, no setup - →
codesight_get_blast_radiustraces architectural-level dependency paths - ✗ No persistent index — re-scans from scratch each session
- ✗ No named symbol extraction or on-demand implementation retrieval
- ✗ No import-level call graph tracing or reference search
- ✗ No doc section search
- ✓ AST-extracted symbols —
search_symbols+get_symbol_sourcereturn exact implementations - ✓ Persistent SQLite index with SHA-256 freshness — zero re-scan cost per session
- ✓
find_importers,find_references,get_blast_radius— precision import-graph tracing - ✓ 70+ languages including YAML/Ansible, Razor/Blazor, SQL/dbt, Erlang, Fortran
- ✓ 58–100× token reduction vs. raw file reads (real production benchmarks)
- ✓ jDocMunch for section-level doc retrieval alongside code
- ✗ No architectural overview or wiki article generation — codesight fills this gap
codesight_get_overview
to build the mental map, then search_symbols + get_symbol_source
to retrieve the specific implementation you want to read or change.
Neither tool overlaps the other — they address different questions in the same workflow.
repowise
repowise is a Python MCP server that uses an LLM to generate and maintain a structured
wiki from your codebase — domain articles, architecture summaries, risk assessments,
and dependency paths. Its 8 tools answer natural-language questions about what the
codebase does at a conceptual level. The wiki is built once, stored in SQLite + LanceDB,
and can be refreshed incrementally. jCodeMunch answers “give me the implementation
of AuthMiddleware.handle”; repowise answers “explain what the
authentication flow does and why it was built this way.”
- →
get_overview,get_context,get_whyanswer conceptual questions via pre-generated wiki articles - →
get_risksurfaces architectural risk areas;get_architecture_diagramgenerates visual maps - →
search_codebaseruns semantic search over the generated wiki corpus - → SQLite + LanceDB persistent storage; web dashboard for browsing
- →
get_dependency_pathtraces high-level module relationships - ✗ Wiki content is LLM-generated — can drift from code reality between refreshes
- ✗ No on-demand symbol extraction; no call-graph tracing at the AST level
- ✗ AGPL-3.0 — hosted derivatives must be open-sourced
- ✓ AST-extracted, byte-offset–indexed symbols — always reflects current code, no LLM in the retrieval path
- ✓
get_symbol_sourcereturns the exact implementation, not a wiki approximation - ✓ SHA-256 incremental indexing — never stale; one-command re-index on change
- ✓
find_importers,find_references,get_blast_radius— AST-level import graph - ✓ 70+ languages; no LLM API key required for indexing or retrieval
- ✓ 58–100× token reduction vs. raw file reads (real production benchmarks)
- ✗ No natural-language “why was this built this way” answers — repowise fills this gap
get_overview for context, then let jCodeMunch handle
all the precise symbol lookups from there.
caveman — by JuliusBrussee
caveman compresses the wrong direction — on purpose. Where jCodeMunch shrinks
what an agent reads, caveman shrinks what the agent writes.
Installed as a Claude Code skill (or one of 30+ other agent hosts), it instructs
the model to reply in telegraphic English (“new object ref each render. Use
useMemo.”) instead of polite paragraphs. Reported output reduction:
~75% across 10 benchmark prompts, technical accuracy preserved. The two tools
are perfectly orthogonal.
- →
/caveman [lite|full|ultra|wenyan]— pick how aggressive the model's brevity is - →
/caveman-commit— Conventional Commit messages, ≤50-char subject; why over what - →
/caveman-review— one-line PR comments:L42: 🔴 bug: user null. Add guard. - →
/caveman-stats— lifetime token savings + USD; tweetable line via--share - →
/caveman-compress <file>— rewritesCLAUDE.mdinto caveman-speak (~46% input cut every session) - →
caveman-shrink— MCP middleware that compresses tool descriptions before they reach the model - →
cavecrew-*subagents — ~60% fewer tokens than vanilla subagents
- ✓
get_symbol_sourcereturns one function body instead ofRead-ing the whole file - ✓
get_ranked_context— token-budgeted symbol assembly for query-driven retrieval - ✓ AST-extracted symbol search across 70+ languages; bytes-precise retrieval
- ✓ jDocMunch pairs natively for section-level doc retrieval
- ✓ Production benchmark: 58–100× token reduction on retrieval vs raw file reads
caveman-shrink MCP middleware can even sit in front of jCodeMunch and
compress its tool descriptions on the way to the model.
Headroom — by Headroom Labs
Headroom is a prompt-stream compression layer that wraps any coding agent —
Claude Code, Codex, Cursor, Aider, Copilot CLI, OpenClaw — and compresses
the tool outputs, log lines, RAG chunks, and file contents flowing into the prompt.
The compression is reversible (CCR — the model can call headroom_retrieve
to get the original bytes back) and runs locally via the bundled
Kompress-base text
compressor, with public benchmarks showing accuracy preserved within ±0.000 on
GSM8K. It also bundles RTK for shell-output rewriting and learns cross-agent memory
from failed sessions.
- →
headroom wrap claude— one command per agent; runs locally - →
headroom proxy— OpenAI/Anthropic-compatible local proxy; zero-code drop-in for any LLM client - → CacheAligner → ContentRouter → CCR pipeline (SmartCrusher for JSON, CodeCompressor for AST, Kompress-base for prose)
- → Reversible compression —
headroom_retrievereturns the original bytes - →
headroom learnmines failed sessions, writes corrections toCLAUDE.md/AGENTS.md/GEMINI.md - → Cross-agent memory store: Claude Code saves a fact, Codex reads it back
- → Bundles RTK for shell-output rewriting
- → Reported workload savings: 92% (code-search 100 results), 92% (SRE incident debugging), 73% (GitHub issue triage), 47% (codebase exploration)
- ✓ AST-extracted symbol retrieval — the agent never reads whole files in the first place
- ✓
get_ranked_context— the agent specifies a token budget, jCodeMunch packs only the symbols that fit - ✓
find_references,find_importers, call-graph tracing — structural retrieval Headroom's compression cannot synthesise - ✓ jDocMunch + jDataMunch for documentation and tabular data with the same retrieval discipline
- ✓ Token-economy ledger (
jcodemunch-mcp receipt) reports modeled savings + USD avoided at Sonnet/Opus/Haiku rates
--code-graph wrap flag is even designed to coexist with code-intelligence
MCP servers like jCodeMunch.
distill — by samuelfaj
distill is a CLI utility that pipes long command output through an OpenAI-compatible LLM and returns only what you asked for. The pitch line — “Save up to 99% of tokens without losing the signal” — is well-supported by the sample diff in the README (7,648 tokens → 99 tokens, 98.7% saved). It speaks any OpenAI-compatible endpoint: LM Studio, Ollama, Jan, vLLM, llama.cpp, MLX, OpenAI, and others. distill is in the same complementary slot as RTK, lean-ctx, Context Mode, and tokf — it lives between your shell and your agent.
npm i -g @samuelfaj/distill- →
logs | distill "summarize errors"— LLM-summarised output, on demand - → Works with LM Studio, Ollama, Jan, vLLM, llama.cpp, MLX, OpenAI, Docker Model Runner
- → Persistable defaults via
distill config host / model / api-key - → Recommends global agent instructions: pipe every non-interactive shell command through distill
- → Pass-through detection for interactive prompts (
[y/N],password:) - ✗ Requires running an LLM endpoint — cost shifts to the local/hosted model rather than disappearing
- ✗ Per-call latency includes a model round-trip
- ✗ No LICENSE file in the repo at time of survey — commercial use ambiguous until clarified
- ✓ AST-extracted symbol retrieval — the agent never receives raw command output it has to summarise
- ✓
get_ranked_context— deterministic token budget, no LLM round-trip in the retrieval path - ✓ 70+ languages; offline, zero-API by default
- ✓ jDocMunch + jDataMunch round out the suite for prose docs and tabular data
- ✓ Apache-2.0 / commercial-friendly license — no ambiguity
npm test, terraform plan, or docker
build and the verbose output is what is bleeding the budget, distill is the
right shape. If the agent is calling Read on source files, jCodeMunch
is. They never overlap.
tokf — by mpecan
tokf is the rule-based answer to distill: a Rust binary that intercepts CLI output
and applies TOML filter rules — no LLM in the loop, no round-trip latency,
no hosted-model cost. It ships hooks for Claude Code, OpenCode, and Codex CLI;
a built-in test harness with safety checks for prompt injection / shell injection /
hidden Unicode; automatic make/just task-runner wrapping; and per-filter test
suites you can verify with tokf verify. The pitch is 60–90% reduction
on tools like cargo test, git push, and docker
build — reproducible because the rules are deterministic.
- →
tokf run cargo test— runs the command, applies a TOML filter, emits only what matters - →
tokf hook install --global— auto-wraps every command for Claude Code, OpenCode, Codex CLI - →
tokf verify --safety— runs prompt-injection / shell-injection / hidden-Unicode checks on filter rules - → Auto-wraps
makeandjustso each recipe line is filtered independently - → Filter rules live in plain TOML — project-local (
.tokf/filters/), user-level, or stdlib; sharable - → Pure Rust binary; no LLM dependency, no per-call cost, no latency
- → Per-filter test suites with
tokf verify— rules are versioned and verifiable
- ✓ Symbol-precise retrieval — the agent never reads raw build output via
ReadorBash cat - ✓ AST extraction across 70+ languages; deterministic, offline retrieval
- ✓ jDocMunch + jDataMunch handle docs and tabular data with the same retrieval discipline
- ✓
analyze_perf+get_pr_risk_profile— structured signals where tokf would compress raw verbose output
LangChain RAG
LangChain is an open-source Python/TypeScript framework for building LLM-powered applications. Its Retrieval-Augmented Generation (RAG) pattern is the most common approach developers reach for when they want an LLM to answer questions about a codebase: chunk the files, embed the chunks, store vectors in a database, then retrieve the closest chunks at query time. LangChain provides the glue — loaders, splitters, embedding wrappers, vector store integrations, and retrieval chains — that wires all of this together.
- Embeds raw file text into vectors — code is treated as prose
- Chunk boundaries are heuristic (character count, line count) — frequently split functions mid-body
- Retrieves the n nearest chunks by cosine similarity — approximate, not exact
- Requires an embedding model, a vector database, a chunking strategy, and a retrieval chain — real infrastructure overhead
- Index goes stale the moment a file changes; re-embedding is non-trivial at scale
- No understanding of code structure — a function and its docstring may land in separate chunks
- Rich ecosystem: 300+ integrations, chains, agents, and evaluation tools
- Great for semantic search over prose docs; less well-suited to precise code navigation
- Tree-sitter parses source files into an AST — functions, classes, and imports are atomic units, never split mid-body
search_symbols("authenticate")returns the exact implementation body, not the nearest chunk- Opt-in hybrid BM25 + vector search —
search_symbols(semantic=true)combines structural BM25 with cosine similarity;semantic_weightcontrols the blend; zero overhead when disabled (default) - Semantic embeddings are stored in the existing SQLite index — no separate vector DB, no pipeline to wire up
- Three embedding providers: local
sentence-transformers, Gemini, or OpenAI; pure-Python cosine similarity, no numpy required find_references/find_importerstrace call graphs precisely — RAG cannot do this at all- Token usage is deterministic and minimal — you get exactly the symbol you asked for, not the n nearest chunks
- jDocMunch handles documentation (section-level search across .md, .rst, .ipynb, HTML) with the same zero-infra model
- Works natively as an MCP server — Claude, Cursor, Windsurf, Codex call it directly; no chain wiring required
search_symbols(semantic=true) delivers hybrid BM25 + vector search
over AST-extracted symbols with no separate vector DB required
(pip install jcodemunch-mcp[semantic]).
The structural advantage remains decisive: jCodeMunch's embeddings are computed
over complete, syntactically valid symbols — never arbitrary text chunks —
so semantic similarity operates on meaningful code units rather than truncated fragments.
find_references and find_importers,
and deterministic token cost with no re-embedding pipeline to maintain.
A LangChain RAG pipeline that chunks your repo will cost more to set up, more to maintain,
more tokens per query, and still return semantically approximate results over
partial code fragments. jCodeMunch returns exact symbols — and now also ranks them
by semantic similarity when you want it.
For teams already running a LangChain stack, jCodeMunch MCP drops in alongside it;
use RAG for unstructured non-code corpora, jCodeMunch for all code and documentation lookups.
Ready to cut your token bill?
Free for non-commercial use. Paid licenses for commercial teams.