RepoLens

    ██████╗ ███████╗██████╗  ██████╗ ██╗     ███████╗███╗   ██╗███████╗

██╔══██╗██╔════╝██╔══██╗██╔═══██╗██║ ██╔════╝████╗ ██║██╔════╝ ██████╔╝█████╗ ██████╔╝██║ ██║██║ █████╗ ██╔██╗ ██║███████╗ ██╔══██╗██╔══╝ ██╔═══╝ ██║ ██║██║ ██╔══╝ ██║╚██╗██║╚════██║ ██║ ██║███████╗██║ ╚██████╔╝███████╗███████╗██║ ╚████║███████║ ╚═╝ ╚═╝╚══════╝╚═╝ ╚═════╝ ╚══════╝╚══════╝╚═╝ ╚═══╝╚══════╝ Repository Intelligence CLI

Links: Gallery · npm · MCP Registry · MCP Rush · VS Code extension · GitHub Action

Your architecture docs are already outdated. RepoLens fixes that.

RepoLens scans your repository, generates living architecture documentation, and publishes it to Notion, Confluence, GitHub Wiki, Obsidian, or Markdown — automatically on every push. Engineers get technical docs. Stakeholders get readable system overviews. Nobody writes a word.

Stable as of v1.0 — API guarantees · Security hardened · version from package.json

🎬 Demo

Try it now — no installation required. npx @chappibunny/repolens demo previews the repository you point it at. It detects common languages (Python, Go, Rust, Java, JavaScript/TypeScript, and others). If the scan matches no source files, demo exits 2 and does not write empty docs. Code health scores JavaScript/TypeScript, Python, and Go.

[See it on real repos](https://chapibunny.github.io/repolens/) — architecture pages RepoLens generated for Express, FastAPI, Django, Gin, mdBook, and other public projects. Deterministic mode, no API keys.

🎬 [Watch Demo Video](https://www.loom.com/share/8e077624e69f41319fd93acbbe03871e) — See RepoLens generate docs in 60 seconds

Notion Confluence

🔍 Supported Languages (16 auto-detected)

JavaScript TypeScript Python Go Rust Java C C++ C# Ruby PHP Swift Kotlin Scala Shell SQL

Plus framework detection: Django · FastAPI · Flask · Gin · Echo · Fiber · Actix · Rocket — and all major JS frameworks (React, Next.js, Vue, Angular, Express, NestJS, Svelte, etc.)

🚀 Quick Start (60 seconds)

Step 1: Install (Node.js 18+)

npm install @chappibunny/repolens

Step 2: Initialize (creates config + GitHub Actions workflow)

npx @chappibunny/repolens init

Step 3: Configure Publishing (optional, skip if using Markdown only)

For Notion:

# Edit .env and add:

NOTION_TOKEN=secret_xxx NOTION_PARENT_PAGE_ID=xxx

For Confluence:

# Edit .env and add:

CONFLUENCE_URL=https://your-company.atlassian.net/wiki CONFLUENCE_EMAIL=your-email@example.com CONFLUENCE_API_TOKEN=your-token CONFLUENCE_SPACE_KEY=DOCS

Step 4: Publish

npx @chappibunny/repolens publish

Done! Numbered notes and the Markdown publisher’s files are in .repolens/. Notion, Confluence, GitHub Wiki, and Obsidian publish only when you configure them. Obsidian needs obsidian.vault in .repolens.yml and does not use an API key.

🔄 Upgrading from v0.3.0 or earlier? Run npx @chappibunny/repolens migrate to automatically update your workflow files. See MIGRATION.md for details.

📋 What It Generates

17 document types for three audiences — no manual writing required. Route Map and GraphQL Schema are skipped when the repository has no routes or GraphQL schema:

Two modes: Deterministic (free, fast, always works) or AI-Enhanced (optional — GitHub Models, OpenAI, Anthropic, Google, Azure, Ollama).

✨ Why RepoLens

📦 Installation

npm install @chappibunny/repolens

Or try instantly without installing: npx @chappibunny/repolens demo

For alternative methods, see INSTALLATION.md.

🎨 VS Code Extension

View your architecture directly in VS Code — browse modules, visualize dependencies, and explore your codebase structure without leaving the editor.

Install from Marketplace:

ext install repolensdox.repolensdox

→ Get it on Visual Studio Marketplace

Features:

• 🏗️ Architecture Explorer — Tree view of your system structure
• 📊 Dependency Visualizer — Interactive dependency graphs
• 📁 Module Browser — Navigate modules by domain and function
• 🔍 Command Palette — Quick access to architecture insights
• 📈 System Metrics — Real-time architecture health indicators

The extension reads your .repolens.yml configuration and provides an interactive UI for exploring the documentation that RepoLens generates.

🎓 Onboarding Guide

Step-by-step setup for publishers, AI features, Notion, Confluence, GitHub Wiki, Obsidian, Discord, and CI/CD automation.

[→ Full Onboarding Guide](docs/ONBOARDING.md)

🎮 Commands

Note: If you installed globally with npm install -g @chappibunny/repolens, you can use the shorter repolens form. Init's next-steps text uses that shorter form when the command on your PATH is the global install.

Warning: Do not run bare npx repolens — there is an unrelated repolens@0.0.1 placeholder package on npm. Always use the scoped name @chappibunny/repolens.

Exit codes

--target must already exist. A missing path exits 2 with Target directory not found: before any scan. repolens --help prints that command's flags. The ASCII banner is omitted when stdout is not a terminal or CI is set.

MCP server

Cursor, Cline, Claude Desktop, Claude Code, and VS Code Copilot can call RepoLens over stdio. The server is read-only except for generate_docs, which writes Markdown inside the workspace. Deterministic mode does not use the network. Paths cannot leave the workspace root.