PyPI - kodelens-cli - Versions diffs - 0.1.1__tar.gz - Mend

kodelens-cli 0.1.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

kodelens_cli-0.1.1/.gitignore +18 -0
kodelens_cli-0.1.1/Makefile +30 -0
kodelens_cli-0.1.1/PKG-INFO +8 -0
kodelens_cli-0.1.1/README.md +0 -0
kodelens_cli-0.1.1/pyproject.toml +23 -0
kodelens_cli-0.1.1/src/kodelens_cli/__init__.py +1 -0
kodelens_cli-0.1.1/src/kodelens_cli/__main__.py +9 -0
kodelens_cli-0.1.1/src/kodelens_cli/auth.py +152 -0
kodelens_cli-0.1.1/src/kodelens_cli/cli.py +420 -0
kodelens_cli-0.1.1/src/kodelens_cli/client.py +115 -0
kodelens_cli-0.1.1/src/kodelens_cli/config.py +65 -0
kodelens_cli-0.1.1/uv.lock +161 -0

kodelens_cli-0.1.1/.gitignore ADDED Viewed

@@ -0,0 +1,18 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+data/
+dist/
+wheels/
+*.egg-info
+db.sqlite3
+test.db.sqlite3
+# Virtual environments
+.venv
+.env

kodelens_cli-0.1.1/Makefile ADDED Viewed

@@ -0,0 +1,30 @@
+.PHONY: help build publish publish-minor publish-major version
+help:  ## Show this help
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}'
+version:  ## Show current package version
+	@grep '^version = ' pyproject.toml | sed 's/version = "\(.*\)"/\1/'
+build:  ## Build wheel + sdist
+	rm -rf dist
+	uv build
+publish:  ## Bump patch version, build, and publish to PyPI
+	uvx hatch version patch
+	rm -rf dist
+	uv build
+	uv publish
+	@echo "Published $$(grep '^version = ' pyproject.toml | sed 's/version = \"\(.*\)\"/\1/')"
+publish-minor:  ## Bump minor version, build, and publish to PyPI
+	uvx hatch version minor
+	rm -rf dist
+	uv build
+	uv publish
+publish-major:  ## Bump major version, build, and publish to PyPI
+	uvx hatch version major
+	rm -rf dist
+	uv build
+	uv publish

kodelens_cli-0.1.1/PKG-INFO ADDED Viewed

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: kodelens-cli
+Version: 0.1.1
+Summary: CLI for KodeLens — surface code health issues in your terminal and AI coding tools
+Requires-Python: >=3.11
+Requires-Dist: click>=8.1
+Requires-Dist: httpx>=0.27
+Requires-Dist: rich>=13.0

kodelens_cli-0.1.1/README.md ADDED Viewed

File without changes

kodelens_cli-0.1.1/pyproject.toml ADDED Viewed

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+[project]
+name = "kodelens-cli"
+dynamic = ["version"]
+description = "CLI for KodeLens — surface code health issues in your terminal and AI coding tools"
+requires-python = ">=3.11"
+dependencies = [
+    "click>=8.1",
+    "httpx>=0.27",
+    "rich>=13.0",
+]
+[project.scripts]
+kodelens = "kodelens_cli.__main__:main"
+[tool.hatch.version]
+path = "src/kodelens_cli/__init__.py"
+[tool.hatch.build.targets.wheel]
+packages = ["src/kodelens_cli"]

kodelens_cli-0.1.1/src/kodelens_cli/__init__.py ADDED Viewed

	@@ -0,0 +1 @@
1	+ __version__ = "0.1.1"

kodelens_cli-0.1.1/src/kodelens_cli/__main__.py ADDED Viewed

@@ -0,0 +1,9 @@
+from kodelens_cli.cli import cli
+def main():
+    cli()
+if __name__ == "__main__":
+    main()

kodelens_cli-0.1.1/src/kodelens_cli/auth.py ADDED Viewed

@@ -0,0 +1,152 @@
+"""
+Login flow: PKCE browser-based auth.
+1. Generate code_verifier + code_challenge
+2. Start local HTTP server on ephemeral port
+3. Open browser to {KODELENS_URL}/cli/auth?code_challenge=...&redirect_uri=...
+4. KodeLens authenticates user, creates ApiKey, redirects to localhost callback
+5. Extract token from callback, save to credentials file
+"""
+from __future__ import annotations
+import base64
+import hashlib
+import http.server
+import secrets
+import threading
+import urllib.parse
+import webbrowser
+from typing import Optional
+from kodelens_cli.config import clear_credentials, get_url, save_credentials
+_AUTH_SUCCESS_HTML = b"""<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>KodeLens \xe2\x80\x94 Authenticated</title>
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <link href="https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@300;400;500;600;700&family=Roboto:wght@300;400&display=swap" rel="stylesheet">
+  <style>
+    *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+    html, body {
+      height: 100%;
+      background-color: #181925;
+      color: #ffffff;
+      font-family: "Roboto", sans-serif;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+    }
+    .container {
+      text-align: center;
+      padding: 2rem;
+      max-width: 560px;
+    }
+    .check {
+      width: 56px;
+      height: 56px;
+      border-radius: 50%;
+      background: rgba(70, 223, 150, 0.12);
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      margin: 0 auto 2rem;
+    }
+    .check svg {
+      width: 28px;
+      height: 28px;
+      stroke: #46df96;
+      stroke-width: 2.5;
+      fill: none;
+      stroke-linecap: round;
+      stroke-linejoin: round;
+    }
+    h1 {
+      font-family: "Space Grotesk", sans-serif;
+      font-size: 2.5rem;
+      font-weight: 600;
+      color: #46df96;
+      letter-spacing: -0.02em;
+      margin-bottom: 1rem;
+    }
+    p {
+      font-size: 1.05rem;
+      font-weight: 300;
+      color: rgba(255, 255, 255, 0.6);
+      line-height: 1.6;
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <div class="check">
+      <svg viewBox="0 0 24 24"><polyline points="20 6 9 17 4 12"/></svg>
+    </div>
+    <h1>You&rsquo;re all set.</h1>
+    <p>KodeLens CLI is authenticated.<br>You can close this tab and return to the terminal.</p>
+  </div>
+</body>
+</html>"""
+def _generate_pkce() -> tuple[str, str]:
+    verifier = secrets.token_urlsafe(64)
+    challenge = (
+        base64.urlsafe_b64encode(hashlib.sha256(verifier.encode()).digest())
+        .rstrip(b"=")
+        .decode()
+    )
+    return verifier, challenge
+def login() -> str:
+    """Opens browser for KodeLens login, waits for callback, returns API key."""
+    _, challenge = _generate_pkce()
+    token_holder: dict[str, Optional[str]] = {"token": None}
+    done = threading.Event()
+    class CallbackHandler(http.server.BaseHTTPRequestHandler):
+        def do_GET(self):
+            parsed = urllib.parse.urlparse(self.path)
+            params = urllib.parse.parse_qs(parsed.query)
+            token_holder["token"] = (params.get("token") or [None])[0]
+            self.send_response(200)
+            self.send_header("Content-Type", "text/html")
+            self.end_headers()
+            self.wfile.write(_AUTH_SUCCESS_HTML)
+            done.set()
+        def log_message(self, *args):
+            pass
+    server = http.server.HTTPServer(("127.0.0.1", 0), CallbackHandler)
+    port = server.server_address[1]
+    redirect_uri = f"http://127.0.0.1:{port}/callback"
+    auth_url = (
+        f"{get_url()}/cli/auth/"
+        f"?code_challenge={challenge}&redirect_uri={urllib.parse.quote(redirect_uri)}"
+    )
+    thread = threading.Thread(target=lambda: server.handle_request(), daemon=True)
+    thread.start()
+    webbrowser.open(auth_url)
+    done.wait(timeout=120)
+    server.server_close()
+    token = token_holder["token"]
+    if not token:
+        raise TimeoutError("Login timed out. Please try again.")
+    save_credentials(token)
+    return token
+def logout() -> None:
+    clear_credentials()

kodelens_cli-0.1.1/src/kodelens_cli/cli.py ADDED Viewed

@@ -0,0 +1,420 @@
+from __future__ import annotations
+import json
+import subprocess
+import sys
+from pathlib import Path
+import click
+from rich.console import Console
+from rich.panel import Panel
+from rich.syntax import Syntax
+from rich.table import Table
+from rich.text import Text
+from kodelens_cli.auth import login, logout
+from kodelens_cli.client import ApiError, AuthError, KodeLensClient, NotFoundError
+from kodelens_cli.config import detect_remote_url, get_api_key, get_repo_id_override
+console = Console()
+err_console = Console(stderr=True)
+SEVERITY_COLOURS = {
+    "critical": "bold red",
+    "high": "red",
+    "medium": "yellow",
+    "low": "blue",
+    "info": "dim",
+}
+def _make_client() -> KodeLensClient:
+    if not get_api_key():
+        err_console.print(
+            "[red]Not authenticated.[/red] Run [bold]kodelens login[/bold] "
+            "or set [bold]KODELENS_API_KEY[/bold]."
+        )
+        sys.exit(1)
+    return KodeLensClient()
+def _resolve_repo(client: KodeLensClient, debug: bool = False) -> dict:
+    repo_id = get_repo_id_override()
+    if repo_id:
+        if debug:
+            err_console.print(f"[dim]Using KODELENS_REPO_ID={repo_id}[/dim]")
+        return client.find_repository(repo_id=repo_id)
+    remote_url = detect_remote_url()
+    if debug:
+        err_console.print(f"[dim]Detected remote URL: {remote_url}[/dim]")
+    if remote_url:
+        return client.find_repository(remote_url=remote_url)
+    err_console.print(
+        "[red]Could not detect repository.[/red] "
+        "Set [bold]KODELENS_REPO_ID[/bold] or run from inside a git repository."
+    )
+    sys.exit(1)
+def _get_current_commit() -> str | None:
+    try:
+        result = subprocess.run(
+            ["git", "rev-parse", "HEAD"],
+            capture_output=True,
+            text=True,
+            timeout=5,
+        )
+        return result.stdout.strip() if result.returncode == 0 else None
+    except Exception:
+        return None
+def _warn_if_stale(repo: dict) -> None:
+    latest = repo.get("latestCommitSha")
+    current = _get_current_commit()
+    if not latest or not current:
+        return
+    if not current.startswith(latest[:12]) and not latest.startswith(current[:12]):
+        err_console.print(
+            f"[yellow]Note: latest scan was on {latest[:8]}, "
+            f"current HEAD is {current[:8]} — results may be outdated.[/yellow]"
+        )
+def _lang_from_path(file_path: str | None) -> str:
+    if not file_path:
+        return "text"
+    ext = file_path.rsplit(".", 1)[-1].lower() if "." in file_path else ""
+    return {
+        "py": "python",
+        "js": "javascript",
+        "ts": "typescript",
+        "tsx": "tsx",
+        "jsx": "jsx",
+        "rb": "ruby",
+        "go": "go",
+        "java": "java",
+        "cs": "csharp",
+        "rs": "rust",
+        "php": "php",
+        "kt": "kotlin",
+        "swift": "swift",
+    }.get(ext, "text")
+@click.group()
+def cli():
+    """KodeLens CLI — surface code health issues in your terminal."""
+@cli.command(name="login")
+def login_cmd():
+    """Authenticate with KodeLens via browser."""
+    console.print("Opening browser for authentication...")
+    try:
+        login()
+        console.print("[green]Authenticated successfully.[/green]")
+    except TimeoutError as e:
+        err_console.print(f"[red]{e}[/red]")
+        sys.exit(1)
+@cli.command(name="logout")
+def logout_cmd():
+    """Clear stored credentials."""
+    logout()
+    console.print("Logged out.")
+@cli.group()
+def issues():
+    """Commands for browsing and inspecting code issues."""
+@issues.command(name="list")
+@click.option(
+    "--file", "file_path", default=None, help="Filter to a specific file path."
+)
+@click.option(
+    "--severity",
+    default="high,critical",
+    show_default=True,
+    help="Comma-separated severities, or 'all'.",
+)
+@click.option(
+    "--type",
+    "obs_type",
+    default=None,
+    help="Filter by type: security, complexity, etc.",
+)
+@click.option("--limit", default=50, show_default=True)
+@click.option("--json", "as_json", is_flag=True, help="Output raw JSON.")
+@click.option("--debug", is_flag=True, hidden=True)
+def issues_list(file_path, severity, obs_type, limit, as_json, debug):
+    """List active issues for the current repository."""
+    client = _make_client()
+    try:
+        repo = _resolve_repo(client, debug=debug)
+        sev_param = None if severity == "all" else severity
+        data = client.repository_observations(
+            repo["id"],
+            severity=sev_param,
+            obs_type=obs_type,
+            file_path=file_path,
+            per_page=limit,
+        )
+    except (AuthError, NotFoundError, ApiError) as e:
+        err_console.print(f"[red]{e}[/red]")
+        sys.exit(1)
+    if as_json:
+        console.print_json(json.dumps(data))
+        return
+    _warn_if_stale(repo)
+    results = data.get("results", [])
+    _print_table(results, data.get("total", 0))
+@issues.command(name="detail")
+@click.option("--id", "observation_id", required=True, type=int, help="Issue ID.")
+@click.option("--json", "as_json", is_flag=True, help="Output raw JSON.")
+def issues_detail(observation_id, as_json):
+    """Show full detail for a single issue."""
+    client = _make_client()
+    try:
+        data = client.observation_detail(observation_id)
+    except (AuthError, NotFoundError, ApiError) as e:
+        err_console.print(f"[red]{e}[/red]")
+        sys.exit(1)
+    if as_json:
+        console.print_json(json.dumps(data))
+        return
+    _print_issue_detail(data)
+@issues.command(name="dismiss")
+@click.option("--id", "observation_id", required=True, type=int, help="Issue ID.")
+@click.option("--message", required=True, help="Reason for dismissal.")
+def issues_dismiss(observation_id, message):
+    """Dismiss an issue with a required reason."""
+    console.print(f"Dismissing issue [bold]#{observation_id}[/bold]")
+    console.print(f"Reason: [dim]{message}[/dim]")
+    if not click.confirm(f"Confirm dismiss issue #{observation_id}?", default=False):
+        console.print("[dim]Cancelled.[/dim]")
+        return
+    client = _make_client()
+    try:
+        client.dismiss_observation(observation_id, reason=message)
+    except (AuthError, NotFoundError, ApiError) as e:
+        err_console.print(f"[red]{e}[/red]")
+        sys.exit(1)
+    console.print(f"[green]Issue #{observation_id} dismissed.[/green]")
+def _print_table(results: list, total: int) -> None:
+    if not results:
+        console.print("[green]No issues found.[/green]")
+        return
+    table = Table(show_header=True, header_style="bold", show_lines=False)
+    table.add_column("ID", justify="right", width=6)
+    table.add_column("Severity", width=10)
+    table.add_column("Type", width=12)
+    table.add_column("File", overflow="fold")
+    table.add_column("Line", justify="right", width=6)
+    table.add_column("Title")
+    for obs in results:
+        sev = obs["severity"].lower()
+        colour = SEVERITY_COLOURS.get(sev, "")
+        sev_str = (
+            f"[{colour}]{obs['severity']}[/{colour}]" if colour else obs["severity"]
+        )
+        file_str = obs.get("filePath") or ""
+        sl = obs.get("startLine")
+        line_str = str(sl) if sl is not None else ""
+        table.add_row(
+            str(obs["id"]),
+            sev_str,
+            obs.get("type", ""),
+            file_str,
+            line_str,
+            obs.get("title", ""),
+        )
+    console.print(table)
+    if total > len(results):
+        console.print(
+            f"[dim]Showing {len(results)} of {total}. Use --limit to see more.[/dim]"
+        )
+def _print_issue_detail(data: dict) -> None:
+    sev = data.get("severity", "").lower()
+    colour = SEVERITY_COLOURS.get(sev, "white")
+    obs_type = data.get("type", "")
+    issue_id = data.get("id", "")
+    header = Text()
+    header.append(f"Issue #{issue_id}", style="bold")
+    header.append("  ·  ")
+    header.append(data.get("severity", ""), style=colour)
+    header.append("  ·  ")
+    header.append(obs_type)
+    repo_name = (data.get("repository") or {}).get("name", "")
+    file_path = data.get("filePath") or ""
+    start_line = data.get("startLine")
+    end_line = data.get("endLine")
+    start_col = data.get("startColumn")
+    end_col = data.get("endColumn")
+    lines_str = (
+        f"{start_line}–{end_line}"
+        if start_line is not None and end_line is not None
+        else (str(start_line) if start_line is not None else "")
+    )
+    cols_str = (
+        f"{start_col}–{end_col}"
+        if start_col is not None and end_col is not None and (start_col or end_col)
+        else ""
+    )
+    meta_lines = []
+    if repo_name:
+        meta_lines.append(f"[dim]Repo   [/dim] {repo_name}")
+    if file_path:
+        meta_lines.append(f"[dim]File   [/dim] {file_path}")
+    if lines_str:
+        meta_lines.append(f"[dim]Lines  [/dim] {lines_str}")
+    if cols_str:
+        meta_lines.append(f"[dim]Cols   [/dim] {cols_str}")
+    panel_content = Text.from_markup("\n".join(meta_lines))
+    console.print(Panel(panel_content, title=header, title_align="left"))
+    title = data.get("title", "")
+    description = data.get("description", "")
+    if title:
+        console.print(f"\n[bold]{title}[/bold]")
+    if description and description != title:
+        console.print(f"\n{description}")
+    code_snippet = data.get("codeSnippet")
+    if code_snippet:
+        console.print("\n[bold]Code[/bold]")
+        lang = _lang_from_path(file_path)
+        console.print(Syntax(code_snippet, lang, theme="monokai", line_numbers=False))
+    remediation = data.get("remediation", "")
+    if remediation:
+        console.print("\n[bold]Remediation[/bold]")
+        console.print(f"  {remediation}")
+    metadata = data.get("metadata")
+    if metadata:
+        console.print("\n[bold]Metadata[/bold]")
+        console.print_json(json.dumps(metadata))
+_CLAUDE_SKILL_CONTENT = """\
+---
+description: Check the repository or a specific file for KodeLens code quality issues
+---
+Check for active KodeLens code quality issues.
+1. Run `kodelens issues list $ARGUMENTS` (pass e.g. `--file src/auth.py` or leave empty for all issues)
+2. For any high/critical issues run `kodelens issues detail --id=<id>` to get full context: file path, line range, description, and remediation steps
+3. Summarise findings and suggest fixes where appropriate
+To dismiss an issue, ask the user for a reason, then run:
+`kodelens issues dismiss --id=<id> --message="<reason>"`
+Confirm the dismissal when prompted (y/N).
+"""
+_CLAUDE_MD_SECTION = """\
+## Code quality (KodeLens)
+Use `kodelens issues list` to check for active security and complexity issues (default: high+critical).
+Use `kodelens issues list --file <path>` before modifying a file.
+Use `kodelens issues detail --id=<id>` for full context on a specific issue (file, lines, remediation).
+Use `kodelens issues dismiss --id=<id> --message="<reason>"` to dismiss a false positive — always ask the user to confirm the reason first.
+Use `/kodelens [--file <path>]` as a slash command shortcut.
+"""
+_COPILOT_SECTION = """\
+## Code quality (KodeLens)
+This project uses KodeLens for code quality analysis.
+- `kodelens issues list` — list active issues (default: high+critical severity)
+- `kodelens issues list --file <path>` — check a specific file before editing it
+- `kodelens issues detail --id=<id>` — full context: file, line range, and remediation
+- `kodelens issues dismiss --id=<id> --message="<reason>"` — dismiss a false positive with a reason
+Run `kodelens issues list --file <path>` before modifying any file to check for pre-existing issues.
+"""
+def _configure_claude_code() -> None:
+    commands_dir = Path(".claude") / "commands"
+    commands_dir.mkdir(parents=True, exist_ok=True)
+    skill_file = commands_dir / "kodelens.md"
+    if skill_file.exists():
+        console.print(f"[dim]Already configured: {skill_file}[/dim]")
+    else:
+        skill_file.write_text(_CLAUDE_SKILL_CONTENT)
+        console.print(f"[green]Created[/green] {skill_file}")
+    claude_md = Path("CLAUDE.md")
+    existing = claude_md.read_text() if claude_md.exists() else ""
+    if "KodeLens" in existing:
+        console.print(f"[dim]Already configured: CLAUDE.md[/dim]")
+    else:
+        with claude_md.open("a") as f:
+            f.write(_CLAUDE_MD_SECTION)
+        action = "Updated" if existing else "Created"
+        console.print(f"[green]{action}[/green] CLAUDE.md")
+def _configure_github_copilot() -> None:
+    github_dir = Path(".github")
+    github_dir.mkdir(parents=True, exist_ok=True)
+    instructions_file = github_dir / "copilot-instructions.md"
+    existing = instructions_file.read_text() if instructions_file.exists() else ""
+    if "KodeLens" in existing:
+        console.print(f"[dim]Already configured: {instructions_file}[/dim]")
+    else:
+        with instructions_file.open("a") as f:
+            if existing and not existing.endswith("\n"):
+                f.write("\n")
+            f.write(_COPILOT_SECTION)
+        action = "Updated" if existing else "Created"
+        console.print(f"[green]{action}[/green] {instructions_file}")
+@cli.command()
+@click.option(
+    "--claude-code", is_flag=True, help="Set up Claude Code skill and CLAUDE.md."
+)
+@click.option(
+    "--github-copilot", is_flag=True, help="Set up GitHub Copilot instructions."
+)
+def configure(claude_code, github_copilot):
+    """Write AI tool integration files for the current project."""
+    if not claude_code and not github_copilot:
+        raise click.UsageError(
+            "Specify at least one tool: --claude-code or --github-copilot"
+        )
+    if claude_code:
+        _configure_claude_code()
+    if github_copilot:
+        _configure_github_copilot()

kodelens_cli-0.1.1/src/kodelens_cli/client.py ADDED Viewed

@@ -0,0 +1,115 @@
+from __future__ import annotations
+import httpx
+from kodelens_cli.config import get_api_key, get_url
+class KodeLensClient:
+    def __init__(self, api_key: str | None = None, base_url: str | None = None):
+        self._base_url = (base_url or get_url()).rstrip("/")
+        self._api_key = api_key or get_api_key()
+    def _headers(self) -> dict:
+        headers = {"Accept": "application/json"}
+        if self._api_key:
+            headers["X-Api-Key"] = self._api_key
+        return headers
+    def _get(self, path: str, params: dict | None = None) -> dict:
+        url = f"{self._base_url}{path}"
+        with httpx.Client(timeout=30) as client:
+            resp = client.get(url, params=params, headers=self._headers())
+        self._raise(resp)
+        return resp.json()
+    def _post(self, path: str, data: dict) -> dict:
+        url = f"{self._base_url}{path}"
+        with httpx.Client(timeout=30) as client:
+            resp = client.post(url, json=data, headers=self._headers())
+        self._raise(resp)
+        return resp.json()
+    def _patch(self, path: str, data: dict) -> dict:
+        url = f"{self._base_url}{path}"
+        with httpx.Client(timeout=30) as client:
+            resp = client.patch(url, json=data, headers=self._headers())
+        self._raise(resp)
+        return resp.json()
+    def _raise(self, resp: httpx.Response) -> None:
+        if resp.status_code == 401:
+            raise AuthError(
+                "Not authenticated. Run `kodelens login` or set KODELENS_API_KEY."
+            )
+        if resp.status_code == 404:
+            raise NotFoundError("Resource not found.")
+        if not resp.is_success:
+            try:
+                detail = resp.json().get("error") or resp.text
+            except Exception:
+                detail = resp.text
+            raise ApiError(f"API error {resp.status_code}: {detail}")
+    def find_repository(
+        self, *, remote_url: str | None = None, repo_id: int | None = None
+    ) -> dict:
+        params = {}
+        if repo_id:
+            params["repo_id"] = repo_id
+        elif remote_url:
+            params["remote_url"] = remote_url
+        else:
+            raise ValueError("Provide remote_url or repo_id.")
+        return self._get("/api/cli/repository/", params=params)
+    def repository_summary(self, repo_id: int) -> dict:
+        return self._get(f"/api/cli/repositories/{repo_id}/summary/")
+    def repository_observations(
+        self,
+        repo_id: int,
+        *,
+        severity: str | None = None,
+        obs_type: str | None = None,
+        file_path: str | None = None,
+        page: int = 1,
+        per_page: int = 50,
+    ) -> dict:
+        params: dict = {"page": page, "per_page": per_page}
+        if severity:
+            params["severity"] = severity
+        if obs_type:
+            params["type"] = obs_type
+        if file_path:
+            params["file_path"] = file_path
+        return self._get(
+            f"/api/cli/repositories/{repo_id}/observations/", params=params
+        )
+    def create_branch(self, repo_id: int, branch_name: str, from_branch: str) -> dict:
+        return self._post(
+            f"/api/cli/repositories/{repo_id}/branches/",
+            {"branch_name": branch_name, "from_branch": from_branch},
+        )
+    def observation_detail(self, observation_id: int) -> dict:
+        return self._get(f"/api/cli/observations/{observation_id}/")
+    def dismiss_observation(self, observation_id: int, reason: str) -> dict:
+        return self._patch(
+            f"/api/cli/observations/{observation_id}/",
+            {"is_dismissed": True, "dismissal_reason": reason},
+        )
+class AuthError(Exception):
+    pass
+class NotFoundError(Exception):
+    pass
+class ApiError(Exception):
+    pass

kodelens_cli-0.1.1/src/kodelens_cli/config.py ADDED Viewed

@@ -0,0 +1,65 @@
+"""
+Config resolution — priority:
+1. KODELENS_REPO_ID env var
+2. Auto-detect from .git/config remote URL → /api/cli/repository/?remote_url=
+3. KODELENS_API_KEY env var
+4. ~/.config/kodelens/credentials.json (from `kodelens login`)
+5. KODELENS_URL env var (default: https://app.kodelens.io)
+"""
+from __future__ import annotations
+import json
+import os
+import subprocess
+from pathlib import Path
+CREDENTIALS_FILE = Path.home() / ".config" / "kodelens" / "credentials.json"
+DEFAULT_URL = "https://kodelens.kodestack.io"
+def get_url() -> str:
+    return os.environ.get("KODELENS_URL", DEFAULT_URL).rstrip("/")
+def get_api_key() -> str | None:
+    if key := os.environ.get("KODELENS_API_KEY"):
+        return key
+    if CREDENTIALS_FILE.exists():
+        try:
+            data = json.loads(CREDENTIALS_FILE.read_text())
+            return data.get("api_key")
+        except Exception:
+            pass
+    return None
+def save_credentials(api_key: str) -> None:
+    CREDENTIALS_FILE.parent.mkdir(parents=True, exist_ok=True)
+    CREDENTIALS_FILE.write_text(json.dumps({"api_key": api_key}))
+def clear_credentials() -> None:
+    if CREDENTIALS_FILE.exists():
+        CREDENTIALS_FILE.unlink()
+def get_repo_id_override() -> int | None:
+    value = os.environ.get("KODELENS_REPO_ID")
+    return int(value) if value else None
+def detect_remote_url() -> str | None:
+    """Use git to find the origin remote URL of the current repository."""
+    try:
+        result = subprocess.run(
+            ["git", "remote", "get-url", "origin"],
+            capture_output=True,
+            text=True,
+            timeout=5,
+        )
+        if result.returncode == 0:
+            return result.stdout.strip()
+    except Exception:
+        pass
+    return None

kodelens_cli-0.1.1/uv.lock ADDED Viewed

@@ -0,0 +1,161 @@
+version = 1
+revision = 2
+requires-python = ">=3.11"
+[[package]]
+name = "anyio"
+version = "4.13.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "idna" },
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/19/14/2c5dd9f512b66549ae92767a9c7b330ae88e1932ca57876909410251fe13/anyio-4.13.0.tar.gz", hash = "sha256:334b70e641fd2221c1505b3890c69882fe4a2df910cba14d97019b90b24439dc", size = 231622, upload-time = "2026-03-24T12:59:09.671Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/da/42/e921fccf5015463e32a3cf6ee7f980a6ed0f395ceeaa45060b61d86486c2/anyio-4.13.0-py3-none-any.whl", hash = "sha256:08b310f9e24a9594186fd75b4f73f4a4152069e3853f1ed8bfbf58369f4ad708", size = 114353, upload-time = "2026-03-24T12:59:08.246Z" },
+]
+[[package]]
+name = "certifi"
+version = "2026.4.22"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/25/ee/6caf7a40c36a1220410afe15a1cc64993a1f864871f698c0f93acb72842a/certifi-2026.4.22.tar.gz", hash = "sha256:8d455352a37b71bf76a79caa83a3d6c25afee4a385d632127b6afb3963f1c580", size = 137077, upload-time = "2026-04-22T11:26:11.191Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/22/30/7cd8fdcdfbc5b869528b079bfb76dcdf6056b1a2097a662e5e8c04f42965/certifi-2026.4.22-py3-none-any.whl", hash = "sha256:3cb2210c8f88ba2318d29b0388d1023c8492ff72ecdde4ebdaddbb13a31b1c4a", size = 135707, upload-time = "2026-04-22T11:26:09.372Z" },
+]
+[[package]]
+name = "click"
+version = "8.3.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/bb/63/f9e1ea081ce35720d8b92acde70daaedace594dc93b693c869e0d5910718/click-8.3.3.tar.gz", hash = "sha256:398329ad4837b2ff7cbe1dd166a4c0f8900c3ca3a218de04466f38f6497f18a2", size = 328061, upload-time = "2026-04-22T15:11:27.506Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/ae/44/c1221527f6a71a01ec6fbad7fa78f1d50dfa02217385cf0fa3eec7087d59/click-8.3.3-py3-none-any.whl", hash = "sha256:a2bf429bb3033c89fa4936ffb35d5cb471e3719e1f3c8a7c3fff0b8314305613", size = 110502, upload-time = "2026-04-22T15:11:25.044Z" },
+]
+[[package]]
+name = "colorama"
+version = "0.4.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
+]
+[[package]]
+name = "h11"
+version = "0.16.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/01/ee/02a2c011bdab74c6fb3c75474d40b3052059d95df7e73351460c8588d963/h11-0.16.0.tar.gz", hash = "sha256:4e35b956cf45792e4caa5885e69fba00bdbc6ffafbfa020300e549b208ee5ff1", size = 101250, upload-time = "2025-04-24T03:35:25.427Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/04/4b/29cac41a4d98d144bf5f6d33995617b185d14b22401f75ca86f384e87ff1/h11-0.16.0-py3-none-any.whl", hash = "sha256:63cf8bbe7522de3bf65932fda1d9c2772064ffb3dae62d55932da54b31cb6c86", size = 37515, upload-time = "2025-04-24T03:35:24.344Z" },
+]
+[[package]]
+name = "httpcore"
+version = "1.0.9"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "certifi" },
+    { name = "h11" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/06/94/82699a10bca87a5556c9c59b5963f2d039dbd239f25bc2a63907a05a14cb/httpcore-1.0.9.tar.gz", hash = "sha256:6e34463af53fd2ab5d807f399a9b45ea31c3dfa2276f15a2c3f00afff6e176e8", size = 85484, upload-time = "2025-04-24T22:06:22.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7e/f5/f66802a942d491edb555dd61e3a9961140fd64c90bce1eafd741609d334d/httpcore-1.0.9-py3-none-any.whl", hash = "sha256:2d400746a40668fc9dec9810239072b40b4484b640a8c38fd654a024c7a1bf55", size = 78784, upload-time = "2025-04-24T22:06:20.566Z" },
+]
+[[package]]
+name = "httpx"
+version = "0.28.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "anyio" },
+    { name = "certifi" },
+    { name = "httpcore" },
+    { name = "idna" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b1/df/48c586a5fe32a0f01324ee087459e112ebb7224f646c0b5023f5e79e9956/httpx-0.28.1.tar.gz", hash = "sha256:75e98c5f16b0f35b567856f597f06ff2270a374470a5c2392242528e3e3e42fc", size = 141406, upload-time = "2024-12-06T15:37:23.222Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2a/39/e50c7c3a983047577ee07d2a9e53faf5a69493943ec3f6a384bdc792deb2/httpx-0.28.1-py3-none-any.whl", hash = "sha256:d909fcccc110f8c7faf814ca82a9a4d816bc5a6dbfea25d6591d6985b8ba59ad", size = 73517, upload-time = "2024-12-06T15:37:21.509Z" },
+]
+[[package]]
+name = "idna"
+version = "3.13"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/ce/cc/762dfb036166873f0059f3b7de4565e1b5bc3d6f28a414c13da27e442f99/idna-3.13.tar.gz", hash = "sha256:585ea8fe5d69b9181ec1afba340451fba6ba764af97026f92a91d4eef164a242", size = 194210, upload-time = "2026-04-22T16:42:42.314Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/5d/13/ad7d7ca3808a898b4612b6fe93cde56b53f3034dcde235acb1f0e1df24c6/idna-3.13-py3-none-any.whl", hash = "sha256:892ea0cde124a99ce773decba204c5552b69c3c67ffd5f232eb7696135bc8bb3", size = 68629, upload-time = "2026-04-22T16:42:40.909Z" },
+]
+[[package]]
+name = "kodelens"
+version = "0.1.0"
+source = { editable = "." }
+dependencies = [
+    { name = "click" },
+    { name = "httpx" },
+    { name = "rich" },
+]
+[package.metadata]
+requires-dist = [
+    { name = "click", specifier = ">=8.1" },
+    { name = "httpx", specifier = ">=0.27" },
+    { name = "rich", specifier = ">=13.0" },
+]
+[[package]]
+name = "markdown-it-py"
+version = "4.0.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "mdurl" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/5b/f5/4ec618ed16cc4f8fb3b701563655a69816155e79e24a17b651541804721d/markdown_it_py-4.0.0.tar.gz", hash = "sha256:cb0a2b4aa34f932c007117b194e945bd74e0ec24133ceb5bac59009cda1cb9f3", size = 73070, upload-time = "2025-08-11T12:57:52.854Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/94/54/e7d793b573f298e1c9013b8c4dade17d481164aa517d1d7148619c2cedbf/markdown_it_py-4.0.0-py3-none-any.whl", hash = "sha256:87327c59b172c5011896038353a81343b6754500a08cd7a4973bb48c6d578147", size = 87321, upload-time = "2025-08-11T12:57:51.923Z" },
+]
+[[package]]
+name = "mdurl"
+version = "0.1.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d6/54/cfe61301667036ec958cb99bd3efefba235e65cdeb9c84d24a8293ba1d90/mdurl-0.1.2.tar.gz", hash = "sha256:bb413d29f5eea38f31dd4754dd7377d4465116fb207585f97bf925588687c1ba", size = 8729, upload-time = "2022-08-14T12:40:10.846Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b3/38/89ba8ad64ae25be8de66a6d463314cf1eb366222074cfda9ee839c56a4b4/mdurl-0.1.2-py3-none-any.whl", hash = "sha256:84008a41e51615a49fc9966191ff91509e3c40b939176e643fd50a5c2196b8f8", size = 9979, upload-time = "2022-08-14T12:40:09.779Z" },
+]
+[[package]]
+name = "pygments"
+version = "2.20.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/c3/b2/bc9c9196916376152d655522fdcebac55e66de6603a76a02bca1b6414f6c/pygments-2.20.0.tar.gz", hash = "sha256:6757cd03768053ff99f3039c1a36d6c0aa0b263438fcab17520b30a303a82b5f", size = 4955991, upload-time = "2026-03-29T13:29:33.898Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f4/7e/a72dd26f3b0f4f2bf1dd8923c85f7ceb43172af56d63c7383eb62b332364/pygments-2.20.0-py3-none-any.whl", hash = "sha256:81a9e26dd42fd28a23a2d169d86d7ac03b46e2f8b59ed4698fb4785f946d0176", size = 1231151, upload-time = "2026-03-29T13:29:30.038Z" },
+]
+[[package]]
+name = "rich"
+version = "15.0.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "markdown-it-py" },
+    { name = "pygments" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/c0/8f/0722ca900cc807c13a6a0c696dacf35430f72e0ec571c4275d2371fca3e9/rich-15.0.0.tar.gz", hash = "sha256:edd07a4824c6b40189fb7ac9bc4c52536e9780fbbfbddf6f1e2502c31b068c36", size = 230680, upload-time = "2026-04-12T08:24:00.75Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/82/3b/64d4899d73f91ba49a8c18a8ff3f0ea8f1c1d75481760df8c68ef5235bf5/rich-15.0.0-py3-none-any.whl", hash = "sha256:33bd4ef74232fb73fe9279a257718407f169c09b78a87ad3d296f548e27de0bb", size = 310654, upload-time = "2026-04-12T08:24:02.83Z" },
+]
+[[package]]
+name = "typing-extensions"
+version = "4.15.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/94/1a15dd82efb362ac84269196e94cf00f187f7ed21c242792a923cdb1c61f/typing_extensions-4.15.0.tar.gz", hash = "sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466", size = 109391, upload-time = "2025-08-25T13:49:26.313Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl", hash = "sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548", size = 44614, upload-time = "2025-08-25T13:49:24.86Z" },
+]