Each tool is scoped — routes by prefix, schema by model, env vars filtered to required — so orientation costs a small answer rather than a directory walk. Blast radius is the one to reach for before an edit: it names what depends on the file you are about to change.
A project scanner that hands an assistant the map instead of the files. It detects the stack across 30+ frameworks, parses ORMs for the data model, and exposes the results as 14 tools so a question about routes or a data model costs one small call rather than a directory crawl. TypeScript projects are read with AST precision; the other languages fall back to regex detection over the same frameworks.
- A full project scan, and a compact overview when the full one is more than the question needs
- Routes filtered by prefix, tag or method, and the schema filtered to one model
- Blast radius for a file — what breaks if you change it — read before the edit rather than after
- Environment variables collected, narrowed to the ones that are actually required
- The most-imported files, which is the fastest read on where a codebase's weight sits
- Background work found and named: BullMQ queues, Celery tasks, Kafka topics, Redis pub/sub and EventEmitter
- A test coverage map of which routes and models have test files at all
- A generated wiki over the project — a small index to read at session start, then one article at a time — with a lint pass over it
- A knowledge map of decisions, open questions and themes, when the project has been scanned in that mode
- Results cached per session, so the first call scans and the rest answer immediately, with a forced re-scan when the code has moved on
Node.js 18 or newer and nothing else — no configuration, no API keys, and zero dependencies. Started with npx codesight --mcp over stdio, or from a global install, which starts noticeably faster. On Codex the first npx run can exceed the default startup timeout, so raise it or install globally. It reads the project it is run in; languages covered include TypeScript, JavaScript, Python, Go, Ruby, Elixir, Java, Kotlin, Rust, PHP, Dart, Swift, C# and BrighterScript.
One command — npx codesight --mcp