Getting Started

Install (load unpacked)

RepoLens has no build step — it runs as-is.

1. Clone or download the repo.
2. Open chrome://extensions.
3. Toggle Developer mode (top right).
4. Click Load unpacked and select the project folder.

The 🔭 icon appears in your toolbar.

Your first scan

1. Open any repo page — e.g. a project on github.com.
2. Click the RepoLens icon.
3. A loading tab opens immediately, then RepoLens checks cache/provider setup while it fetches the repo. When the scan finishes, it lands on the Verdict — fit call, bottom line, measured facts, structured risks, learning path, and the top things worth noting.

The first scan needs an AI provider connected. If you haven't yet, RepoLens points you to Options to add one — paste an API key from any provider, sign in with OAuth (Claude, ChatGPT/OpenAI, Grok, OpenRouter), or run a local Ollama with no key at all. For Gemini, OpenRouter, and Nous, Settings loads the live model list from your connected account. Slow provider calls keep going while the background scan heartbeat is alive, so a long scan should not falsely fail at 90 seconds. See Models.

Want it your way? Options → Appearance has 21 themes (light, dark, Mono Ink, Liquid Glass, DESIGN.md-inspired themes, and more), and Voice changes the writing tone of the analysis — it's text, not audio, anywhere from blunt-and-technical to friendly-and-plain.

Develop

For contributors — if you just want to use RepoLens, you're done after the steps above.

npm install      # installs vitest
npm test         # the unit suite
npm run test:watch

Pure ES modules, no bundler. Edit a file, reload the extension at chrome://extensions, scan again.