@onamsharma/repolens

The AI-powered documentation and codebase intelligence platform.

npx @onamsharma/repolens            # scan the current repo
npx @onamsharma/repolens build      # generate README.md + docs/
npx @onamsharma/repolens security   # deterministic security & code-health report
npx @onamsharma/repolens ask "how does auth work?"
npx @onamsharma/repolens search "payment logic"

Understands TypeScript, JavaScript, Python and Go. Produces a knowledge graph of your repo and renders documentation, Mermaid diagrams, dependency maps, a security report and an AI chat over it — from one understanding.

Commands

| Command | What it does | | --- | --- | | scan [path] | Print an intelligence summary (stack, symbols, findings) | | analyze [path] --out graph.json | Write the full RepoGraph as JSON | | build [path] --out . | Generate README.md + docs/ (offline) | | security [path] --min high | Security & code-health report (CI-friendly exit code) | | ask "<question>" [path] | Answer a question via retrieval over the repo | | search "<query>" [path] | Hybrid semantic + lexical search |

AI is optional and local-first

Everything works offline with no API key. ask uses local Ollama by default; set OPENAI_API_KEY, ANTHROPIC_API_KEY, GEMINI_API_KEY or OPENROUTER_API_KEY to use a cloud provider instead. Retrieval is always deterministic — the model only narrates.

License

MIT