Metadata-Version: 2.4
Name: repolens-cli
Version: 0.1.1
Summary: Instant clarity on any codebase. Navigate imports, trace functions, and get AI answers — all in one terminal view.
Project-URL: Homepage, https://github.com/Satyam12singh/repolens
Project-URL: Repository, https://github.com/Satyam12singh/repolens
Project-URL: Issues, https://github.com/Satyam12singh/repolens/issues
Author-email: Satyam Singh <satyam.singh@whyminds.ai>
License: MIT
License-File: LICENSE
Keywords: ai,cli,codebase,developer-tools,terminal,tui
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development
Classifier: Topic :: Utilities
Requires-Python: >=3.11
Requires-Dist: openai>=1.30.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: requests>=2.31.0
Requires-Dist: textual>=0.47.0
Description-Content-Type: text/markdown

# RepoLens

Instant clarity on any codebase. Navigate imports, trace functions, and get AI answers — all in one terminal view.

## Install

### Homebrew — macOS & Linux
```bash
brew tap satyam12singh/tap
brew install repolens-cli
```

### uv / pipx / pip — any platform with Python
```bash
uv tool install repolens-cli
pipx install repolens-cli
pip install repolens-cli
```

### Direct binary — no Python required
macOS and Linux:
```bash
curl -fsSL https://raw.githubusercontent.com/Satyam12singh/repolens/master/scripts/install.sh | sh
```

Windows — download the latest `.exe` from [GitHub Releases](https://github.com/Satyam12singh/repolens/releases/latest).

## Usage

```bash
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:

```bash
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
