codesage-tools

CodeSage

CodeSage is a code intelligence engine for AI coding agents. It combines structural graph queries (symbols, references, dependencies) and semantic search (embedding retrieval with cross-encoder reranking) in a single Rust binary, usable as a CLI or over MCP. Nine languages today (PHP, Python, C, C++, Java, Rust, JavaScript, TypeScript, Go). On the semble retrieval corpus, codesage search scores recall@10 = 0.932 / NDCG@10 = 0.788 across 602 queries on the 8 supported-language repos (see External-corpus benchmark below).

🔍 What you can do with it

• Find code by natural-language query: "where does auth happen?", "error handling in the GC".
• Look up symbol definitions by name across a codebase.
• Trace imports, calls, and inheritance for any symbol.
• Map import and include relationships between files.
• Estimate which files a change breaks (change impact analysis).
• Build curated code bundles for LLM consumption in JSON, markdown, or flat-text (gitingest-style) form.
• Read per-file git history: churn, fix ratio, historical co-change, risk score.
• Browse the project as behavior-keyed feature slices: each slice bundles an entrypoint + owned files + context files + tests + crossed trust boundaries, mapped deterministically from build manifests and framework routing (Cargo bins, Laravel routes, Flask/FastAPI/Django routes, Express/Fastify/Hono routes, php-src ext/*, Next.js app/**, CMake/CUDA targets, Python __main__, Go cmd/*, etc.).
• Inspect trust boundaries per file (network, filesystem, process-exec, secrets, database, user-input, external-api, serialization, auth, concurrency) derived from imports/includes/calls; same signal folds into assess_risk and surfaces as security-review notes when ≥3 boundaries are crossed.
• Expose all of the above over MCP so Claude Code, Codex, or Cursor can call them.

Capability summary

Concrete answers to the questions a code-intelligence tool earns its keep on. The axes are the ones the broader ecosystem (GitNexus, SocratiCode, code-review-graph, claude-context, repowise) converges on; the right-hand column is what CodeSage actually ships.