Instant clarity on any codebase. Navigate imports, trace functions, and get AI answers — all in one terminal view.
Project description
RepoLens
Instant clarity on any codebase. Navigate imports, trace functions, and get AI answers — all in one terminal view.
Install
Homebrew — macOS & Linux
brew tap satyam12singh/tap
brew install repolens-cli
uv / pipx / pip — any platform with Python
uv tool install repolens-cli
pipx install repolens-cli
pip install repolens-cli
Direct binary — no Python required
macOS and Linux:
curl -fsSL https://raw.githubusercontent.com/Satyam12singh/repolens/master/scripts/install.sh | sh
Windows — download the latest .exe from GitHub Releases.
Usage
repolens . # scan current directory
repolens ~/my-repo # scan any directory
AI Configuration
RepoLens supports multiple AI providers. Set one of the following in your environment (or in a .env file in the directory you're scanning):
| Provider | Environment Variable | Default Model |
|---|---|---|
| Gemini (Google) | GEMINI_API_KEY |
gemini-2.5-flash |
| OpenAI | OPENAI_API_KEY |
gpt-4o |
| Groq | GROQ_API_KEY |
llama-3.3-70b-versatile |
| Anthropic | ANTHROPIC_API_KEY |
claude-sonnet-4-6 |
| Ollama (local) | REPOLENS_AI_PROVIDER=ollama |
llama3.2 |
Override any default with:
REPOLENS_AI_MODEL=gemini-2.5-pro repolens .
REPOLENS_AI_BASE_URL=http://localhost:11434/v1 repolens .
If no key is set, the file tree and dependency graphs still work — only the AI features (Ask AI, Onboard) are disabled.
Key Bindings
| Key | Action |
|---|---|
1 |
Dependencies tab |
2 |
Call graph tab |
3 |
Full graph tab |
a |
Ask AI a question about the codebase |
o |
Generate onboarding guide |
f |
Toggle focus between file tree and content |
[ / ] |
Resize sidebar |
j / k |
Scroll |
q |
Quit |
Supported Languages
Python, JavaScript, TypeScript, Go, Rust
License
MIT
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file repolens_cli-0.1.1.tar.gz.
File metadata
- Download URL: repolens_cli-0.1.1.tar.gz
- Upload date:
- Size: 45.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ca07e9c25a62613154d4121922c3d93b573bf04df8c9182f63e717dfc6245688
|
|
| MD5 |
f969379f715069f1a25ebf72f8bf23a2
|
|
| BLAKE2b-256 |
9f7b7b73c449cfd89e2d289ba58747801c3d00dfe034620eff9ef3a204a3bf78
|
File details
Details for the file repolens_cli-0.1.1-py3-none-any.whl.
File metadata
- Download URL: repolens_cli-0.1.1-py3-none-any.whl
- Upload date:
- Size: 23.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6a665d87972755ad55da9c0da829af9643118d5750c1c299ec838b56fd55171c
|
|
| MD5 |
e64e1f6ccce490f88dfec75320a20aa5
|
|
| BLAKE2b-256 |
b20e338625cbba7428dfef450b6082660beca44813b667e4e220d626d8f709db
|
