repolens-cli 0.1.0__tar.gz

repolens_cli-0.1.0/.env.example

@@ -0,0 +1,34 @@
+# RepoLens — AI provider configuration
+# Copy this file to .env and fill in your key.
+# Only ONE provider needs to be configured.
+
+# ── Gemini (Google) ─────────────────────────────────────────────────────────
+GEMINI_API_KEY=your_gemini_key_here
+# REPOLENS_AI_PROVIDER=gemini          # auto-detected from GEMINI_API_KEY
+# REPOLENS_AI_MODEL=gemini-2.5-flash   # default (1M context window)
+
+# ── OpenAI ───────────────────────────────────────────────────────────────────
+# OPENAI_API_KEY=your_openai_key_here
+# REPOLENS_AI_PROVIDER=openai
+# REPOLENS_AI_MODEL=gpt-4o             # default
+
+# ── Groq (fast open-source models) ───────────────────────────────────────────
+# GROQ_API_KEY=your_groq_key_here
+# REPOLENS_AI_PROVIDER=groq
+# REPOLENS_AI_MODEL=llama-3.3-70b-versatile   # default
+
+# ── Ollama (local, no key needed) ────────────────────────────────────────────
+# REPOLENS_AI_PROVIDER=ollama
+# REPOLENS_AI_BASE_URL=http://localhost:11434/v1
+# REPOLENS_AI_MODEL=llama3.2
+
+# ── Anthropic ────────────────────────────────────────────────────────────────
+# ANTHROPIC_API_KEY=your_anthropic_key_here
+# REPOLENS_AI_PROVIDER=anthropic
+# REPOLENS_AI_MODEL=claude-sonnet-4-6
+
+# ── Any other OpenAI-compatible provider ─────────────────────────────────────
+# REPOLENS_AI_PROVIDER=custom
+# REPOLENS_AI_API_KEY=your_key
+# REPOLENS_AI_BASE_URL=https://your-provider.com/v1
+# REPOLENS_AI_MODEL=your-model-name

repolens_cli-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,26 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  publish:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v3
+        with:
+          version: "latest"
+
+      - name: Build
+        run: uv build
+
+      - name: Publish to PyPI
+        run: uv publish
+        env:
+          UV_PUBLISH_TOKEN: ${{ secrets.PYPI_TOKEN }}

repolens_cli-0.1.0/.gitignore

@@ -0,0 +1,16 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Environment / secrets
+.env
+
+# uv
+.python-version

repolens_cli-0.1.0/Formula/repolens.rb

@@ -0,0 +1,157 @@
+class Repolens < Formula
+  include Language::Python::Virtualenv
+
+  desc "Instant clarity on any codebase — navigate imports, trace functions, and get AI answers in one terminal view"
+  homepage "https://github.com/Satyam12singh/repolens"
+  url "https://files.pythonhosted.org/packages/source/r/repolens/repolens-0.1.0.tar.gz"
+  sha256 "FILL_IN_AFTER_PYPI_PUBLISH"
+  license "MIT"
+
+  depends_on "python@3.12"
+
+  # Run this once after publishing to PyPI to auto-generate these resource blocks:
+  #   pip install homebrew-pypi-poet
+  #   poet repolens
+  resource "annotated-types" do
+    url "https://files.pythonhosted.org/packages/source/a/annotated_types/annotated_types-0.7.0.tar.gz"
+    sha256 "FILL_IN"
+  end
+
+  resource "anyio" do
+    url "https://files.pythonhosted.org/packages/source/a/anyio/anyio-4.9.0.tar.gz"
+    sha256 "FILL_IN"
+  end
+
+  resource "certifi" do
+    url "https://files.pythonhosted.org/packages/source/c/certifi/certifi-2025.1.31.tar.gz"
+    sha256 "FILL_IN"
+  end
+
+  resource "charset-normalizer" do
+    url "https://files.pythonhosted.org/packages/source/c/charset_normalizer/charset_normalizer-3.4.1.tar.gz"
+    sha256 "FILL_IN"
+  end
+
+  resource "distro" do
+    url "https://files.pythonhosted.org/packages/source/d/distro/distro-1.9.0.tar.gz"
+    sha256 "FILL_IN"
+  end
+
+  resource "h11" do
+    url "https://files.pythonhosted.org/packages/source/h/h11/h11-0.14.0.tar.gz"
+    sha256 "FILL_IN"
+  end
+
+  resource "httpcore" do
+    url "https://files.pythonhosted.org/packages/source/h/httpcore/httpcore-1.0.7.tar.gz"
+    sha256 "FILL_IN"
+  end
+
+  resource "httpx" do
+    url "https://files.pythonhosted.org/packages/source/h/httpx/httpx-0.28.1.tar.gz"
+    sha256 "FILL_IN"
+  end
+
+  resource "idna" do
+    url "https://files.pythonhosted.org/packages/source/i/idna/idna-3.10.tar.gz"
+    sha256 "FILL_IN"
+  end
+
+  resource "jiter" do
+    url "https://files.pythonhosted.org/packages/source/j/jiter/jiter-0.8.2.tar.gz"
+    sha256 "FILL_IN"
+  end
+
+  resource "linkify-it-py" do
+    url "https://files.pythonhosted.org/packages/source/l/linkify_it_py/linkify_it_py-2.0.3.tar.gz"
+    sha256 "FILL_IN"
+  end
+
+  resource "markdown-it-py" do
+    url "https://files.pythonhosted.org/packages/source/m/markdown_it_py/markdown_it_py-3.0.0.tar.gz"
+    sha256 "FILL_IN"
+  end
+
+  resource "mdit-py-plugins" do
+    url "https://files.pythonhosted.org/packages/source/m/mdit_py_plugins/mdit_py_plugins-0.4.2.tar.gz"
+    sha256 "FILL_IN"
+  end
+
+  resource "mdurl" do
+    url "https://files.pythonhosted.org/packages/source/m/mdurl/mdurl-0.1.2.tar.gz"
+    sha256 "FILL_IN"
+  end
+
+  resource "openai" do
+    url "https://files.pythonhosted.org/packages/source/o/openai/openai-1.59.9.tar.gz"
+    sha256 "FILL_IN"
+  end
+
+  resource "pydantic" do
+    url "https://files.pythonhosted.org/packages/source/p/pydantic/pydantic-2.10.5.tar.gz"
+    sha256 "FILL_IN"
+  end
+
+  resource "pydantic-core" do
+    url "https://files.pythonhosted.org/packages/source/p/pydantic_core/pydantic_core-2.27.2.tar.gz"
+    sha256 "FILL_IN"
+  end
+
+  resource "pygments" do
+    url "https://files.pythonhosted.org/packages/source/p/pygments/pygments-2.19.1.tar.gz"
+    sha256 "FILL_IN"
+  end
+
+  resource "python-dotenv" do
+    url "https://files.pythonhosted.org/packages/source/p/python_dotenv/python_dotenv-1.0.1.tar.gz"
+    sha256 "FILL_IN"
+  end
+
+  resource "requests" do
+    url "https://files.pythonhosted.org/packages/source/r/requests/requests-2.32.3.tar.gz"
+    sha256 "FILL_IN"
+  end
+
+  resource "rich" do
+    url "https://files.pythonhosted.org/packages/source/r/rich/rich-13.9.4.tar.gz"
+    sha256 "FILL_IN"
+  end
+
+  resource "sniffio" do
+    url "https://files.pythonhosted.org/packages/source/s/sniffio/sniffio-1.3.1.tar.gz"
+    sha256 "FILL_IN"
+  end
+
+  resource "textual" do
+    url "https://files.pythonhosted.org/packages/source/t/textual/textual-2.1.2.tar.gz"
+    sha256 "FILL_IN"
+  end
+
+  resource "tqdm" do
+    url "https://files.pythonhosted.org/packages/source/t/tqdm/tqdm-4.67.1.tar.gz"
+    sha256 "FILL_IN"
+  end
+
+  resource "typing-extensions" do
+    url "https://files.pythonhosted.org/packages/source/t/typing_extensions/typing_extensions-4.12.2.tar.gz"
+    sha256 "FILL_IN"
+  end
+
+  resource "uc-micro-py" do
+    url "https://files.pythonhosted.org/packages/source/u/uc_micro_py/uc_micro_py-1.0.3.tar.gz"
+    sha256 "FILL_IN"
+  end
+
+  resource "urllib3" do
+    url "https://files.pythonhosted.org/packages/source/u/urllib3/urllib3-2.3.0.tar.gz"
+    sha256 "FILL_IN"
+  end
+
+  def install
+    virtualenv_install_with_resources
+  end
+
+  test do
+    assert_match "RepoLens", shell_output("#{bin}/repolens --help")
+  end
+end

repolens_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Satyam Singh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

repolens_cli-0.1.0/PKG-INFO

@@ -0,0 +1,88 @@
+Metadata-Version: 2.4
+Name: repolens-cli
+Version: 0.1.0
+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
+
+```bash
+brew tap satyam12singh/tap
+brew install repolens
+```
+
+## 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 .   # custom endpoint
+```
+
+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

repolens_cli-0.1.0/README.md

@@ -0,0 +1,60 @@
+# RepoLens
+
+Instant clarity on any codebase. Navigate imports, trace functions, and get AI answers — all in one terminal view.
+
+## Install
+
+```bash
+brew tap satyam12singh/tap
+brew install repolens
+```
+
+## 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 .   # custom endpoint
+```
+
+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

repolens_cli-0.1.0/main.py

@@ -0,0 +1,124 @@
+#!/usr/bin/env python3
+"""RepoLens CLI — `repolens [path]`"""
+from __future__ import annotations
+
+import argparse
+import sys
+from pathlib import Path
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(
+        prog="repolens",
+        description="RepoLens — AI-native codebase intelligence",
+    )
+    parser.add_argument(
+        "path",
+        nargs="?",
+        default=".",
+        help="Directory to analyse (default: current directory)",
+    )
+    parser.add_argument(
+        "--no-ai",
+        action="store_true",
+        help="Skip AI features (no ANTHROPIC_API_KEY needed)",
+    )
+    parser.add_argument(
+        "--max-files",
+        type=int,
+        default=2000,
+        help="Max source files to scan (default: 2000)",
+    )
+    parser.add_argument(
+        "--json",
+        action="store_true",
+        help="Output analysis as JSON instead of launching TUI",
+    )
+    args = parser.parse_args()
+
+    root = Path(args.path).resolve()
+    if not root.is_dir():
+        print(f"Error: {root} is not a directory.", file=sys.stderr)
+        sys.exit(1)
+
+    print(f"RepoLens  scanning {root} …")
+
+    # Load .env if present
+    try:
+        from dotenv import load_dotenv
+        load_dotenv()
+    except ImportError:
+        pass
+
+    from repolens.scanner import scan
+    from repolens.analyzer import analyze_all
+    from repolens.graph import build_graph
+    from repolens.models import RepoAnalysis
+
+    print("  Walking directory tree…")
+    files = scan(str(root), max_files=args.max_files)
+    print(f"  Found {len(files)} source files.")
+
+    print("  Analysing imports and functions…")
+    file_analyses = analyze_all(files)
+    print(f"  Analysed {len(file_analyses)} files.")
+
+    print("  Building dependency and call graphs…")
+    stats = build_graph(file_analyses)
+
+    analysis = RepoAnalysis(
+        root=str(root),
+        files=files,
+        file_analyses=file_analyses,
+        stats=stats,
+    )
+
+    n_cycles = len(stats.circular_deps)
+    print(f"  Done. {len(stats.functions)} functions  ·  {n_cycles} circular dep(s)")
+
+    if args.json:
+        _print_json(analysis)
+        return
+
+    if args.no_ai:
+        import os
+        os.environ.setdefault("ANTHROPIC_API_KEY", "")
+
+    print("  Launching TUI…\n")
+    from repolens.tui.app import RepoLensApp
+    app = RepoLensApp(analysis)
+    app.run()
+
+
+def _print_json(analysis: "RepoAnalysis") -> None:
+    import json
+
+    stats = analysis.stats
+    output = {
+        "root": analysis.root,
+        "total_files": len(analysis.files),
+        "files": [
+            {"path": f.path, "language": f.language, "size": f.size}
+            for f in analysis.files
+        ],
+        "import_graph": {k: v for k, v in stats.import_edges.items() if v},
+        "circular_deps": stats.circular_deps,
+        "hub_files": [{"path": p, "in_degree": d} for p, d in stats.hub_files],
+        "entry_points": stats.entry_points,
+        "functions": [
+            {
+                "id": fid,
+                "name": fn.name,
+                "file": fn.file_path,
+                "line": fn.line_start,
+                "calls": fn.calls,
+                "callers": fn.callers,
+            }
+            for fid, fn in stats.functions.items()
+        ],
+    }
+    print(json.dumps(output, indent=2))
+
+
+if __name__ == "__main__":
+    main()

repolens_cli-0.1.0/pyproject.toml

@@ -0,0 +1,42 @@
+[project]
+name = "repolens-cli"
+version = "0.1.0"
+description = "Instant clarity on any codebase. Navigate imports, trace functions, and get AI answers — all in one terminal view."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.11"
+authors = [{ name = "Satyam Singh", email = "satyam.singh@whyminds.ai" }]
+keywords = ["codebase", "tui", "developer-tools", "ai", "terminal", "cli"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "textual>=0.47.0",
+    "openai>=1.30.0",
+    "python-dotenv>=1.0.0",
+    "requests>=2.31.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/Satyam12singh/repolens"
+Repository = "https://github.com/Satyam12singh/repolens"
+Issues = "https://github.com/Satyam12singh/repolens/issues"
+
+[project.scripts]
+repolens = "repolens.cli:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["repolens"]

repolens_cli-0.1.0/repolens/__init__.py

@@ -0,0 +1 @@
+"""RepoLens — AI-native codebase intelligence."""