StoplettingyourAIreadblind.
One small file. Total codebase context for any agent.
Cut tokens by ~90%, kill repo re-reads, ship faster.
$npm i -g reporoseMostAItoolsarereadingyourrepo allwrong.
Either passing too little context (hallucinations), or shoveling the entire repo into the prompt (token bonfire). Here's what that actually looks like, three turns deep.
Your agent opens the repo blind.
It has no idea what's a route, a service, a model, or a config. Every file looks equally important.
It reads. And re-reads. And re-reads.
Every prompt re-discovers the same files. The same imports. The same circular dependencies it already missed last time.
It still gets it wrong.
Without architectural awareness, it duplicates utilities, breaks circular boundaries, and confidently writes code that already exists.
What if your AI already knew before it asked?
Onefile.
Totalcontext.
map.jsondescribes every file: its role, exports, dependencies, and a one-line AI-generated summary. Drop it into your agent's system context. That's it.
Fourmoves.
Onecoherentmap.
AST-based scanning
Parses every JS/TS/JSX/TSX file with ts-morph. Extracts each function, import, export, and re-export with surgical precision.
Circular dependency detection
Tarjan's strongly-connected-components catches every direct and indirect cycle automatically.
AI summaries
Plug in Ollama, Anthropic, Groq, or OpenAI. Each file gets a one-line description that actually means something.
3D codebase view
Interactive force-directed graph. See your architecture, find hotspots, navigate by clicking.
Threecommands.
Underaminute.
Install once.
Globally on your machine. No config, no API keys required for the default local mode.
↳ Adds the `reporose` binary to your PATH. ~12 MB.
$npm i -g reporoseRun it on your repo.
Parses every JS/TS file, generates AI summaries, builds the dependency graph, writes one map.json.
↳ Done in seconds for most repos. Use --provider to pick your LLM.
$reporose analyzeDrop into your agent.
Paste map.json into context, or run `reporose serve` for the interactive 3D view at localhost:8689.
↳ Spins up the 3D codebase explorer for navigation and review.
$reporose serve100%free.
Alwayswillbe.
RepoRose isn't a freemium SaaS waiting to upsell you. It's an open-source CLI built for the developers who use AI agents every day. No paywalls. No quota. No catch.
GPL v3 licensed
Use it commercially, fork it, modify it, ship it. No strings.
Local-first
Your code never leaves your machine. Default mode runs on Ollama.
No telemetry
No accounts, no tracking, no analytics phoning home.
No vendor lock-in
Open output format. The map.json is yours to do anything with.
GiveyourAI
themap.
One install. One file. Infinite focus.
$npm i -g reporose