clutch-cli 0.2.0__tar.gz → 0.3.0__tar.gz

{clutch_cli-0.2.0 → clutch_cli-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clutch-cli
-Version: 0.2.0
+Version: 0.3.0
 Summary: GitHub tracks your work. Clutch tracks you.
 Author-email: Lay Patel <lay.patel.1313@gmail.com>
 License: MIT
@@ -35,7 +35,7 @@ Requires-Dist: rich>=13.0.0
 
 ---
 
-`clutch-cli` is the terminal companion for [Clutch](https://clutch-laypatel.netlify.app) — an open-source AI-powered developer activity dashboard. Get your GitHub streaks, stats, coding patterns, and AI insights without leaving your terminal.
+`clutch-cli` is the terminal companion for [Clutch](https://clutch-woad.vercel.app) — an open-source AI-powered developer activity dashboard. Get your GitHub streaks, stats, coding patterns, and AI insights without leaving your terminal.
 
 ## Installation
 
@@ -47,7 +47,7 @@ pip install clutch-cli
 
 ```bash
 # Login via GitHub (opens browser automatically, no copy-paste needed)
-clutch auth login
+clutch login
 
 # Check your streak
 clutch streak
@@ -63,9 +63,9 @@ clutch insight
 
 | Command | Description |
 |---|---|
-| `clutch auth login` | Login via GitHub OAuth (fully automatic) |
-| `clutch auth logout` | Logout and clear saved credentials |
-| `clutch auth whoami` | Show currently logged-in user |
+| `clutch login` | Login via GitHub OAuth (fully automatic) |
+| `clutch logout` | Logout and clear saved credentials |
+| `clutch whoami` | Show currently logged-in user |
 | `clutch streak` | Current and longest commit streak |
 | `clutch stats` | Activity stats — commits, PRs, issues, active days |
 | `clutch stats --days 7` | Stats for a custom time range |
@@ -77,10 +77,10 @@ clutch insight
 
 ## How Login Works
 
-`clutch auth login` spins up a temporary local server on port `9876`, opens GitHub OAuth in your browser, and automatically captures the token when GitHub redirects back. No copy-pasting required.
+`clutch login` spins up a temporary local server on port `9876`, opens GitHub OAuth in your browser, and automatically captures the token when GitHub redirects back. No copy-pasting required.
 
 ```
-$ clutch auth login
+$ clutch login
 
 ⚡ Clutch Login
 Opening GitHub in your browser...
@@ -98,12 +98,12 @@ By default the CLI talks to the hosted Clutch API. To point it at a local backen
 
 ```bash
 export CLUTCH_API_URL=http://localhost:8000
-clutch auth login
+clutch login
 ```
 
 ## Links
 
-- 🌐 [Live Dashboard](https://clutch-laypatel.netlify.app)
+- 🌐 [Live Dashboard](https://clutch-woad.vercel.app)
 - 📖 [Full Documentation](https://github.com/laypatel13/clutch)
 - 🐛 [Report a Bug](https://github.com/laypatel13/clutch/issues)
 

{clutch_cli-0.2.0 → clutch_cli-0.3.0}/README.md

@@ -12,7 +12,7 @@
 
 ---
 
-`clutch-cli` is the terminal companion for [Clutch](https://clutch-laypatel.netlify.app) — an open-source AI-powered developer activity dashboard. Get your GitHub streaks, stats, coding patterns, and AI insights without leaving your terminal.
+`clutch-cli` is the terminal companion for [Clutch](https://clutch-woad.vercel.app) — an open-source AI-powered developer activity dashboard. Get your GitHub streaks, stats, coding patterns, and AI insights without leaving your terminal.
 
 ## Installation
 
@@ -24,7 +24,7 @@ pip install clutch-cli
 
 ```bash
 # Login via GitHub (opens browser automatically, no copy-paste needed)
-clutch auth login
+clutch login
 
 # Check your streak
 clutch streak
@@ -40,9 +40,9 @@ clutch insight
 
 | Command | Description |
 |---|---|
-| `clutch auth login` | Login via GitHub OAuth (fully automatic) |
-| `clutch auth logout` | Logout and clear saved credentials |
-| `clutch auth whoami` | Show currently logged-in user |
+| `clutch login` | Login via GitHub OAuth (fully automatic) |
+| `clutch logout` | Logout and clear saved credentials |
+| `clutch whoami` | Show currently logged-in user |
 | `clutch streak` | Current and longest commit streak |
 | `clutch stats` | Activity stats — commits, PRs, issues, active days |
 | `clutch stats --days 7` | Stats for a custom time range |
@@ -54,10 +54,10 @@ clutch insight
 
 ## How Login Works
 
-`clutch auth login` spins up a temporary local server on port `9876`, opens GitHub OAuth in your browser, and automatically captures the token when GitHub redirects back. No copy-pasting required.
+`clutch login` spins up a temporary local server on port `9876`, opens GitHub OAuth in your browser, and automatically captures the token when GitHub redirects back. No copy-pasting required.
 
 ```
-$ clutch auth login
+$ clutch login
 
 ⚡ Clutch Login
 Opening GitHub in your browser...
@@ -75,12 +75,12 @@ By default the CLI talks to the hosted Clutch API. To point it at a local backen
 
 ```bash
 export CLUTCH_API_URL=http://localhost:8000
-clutch auth login
+clutch login
 ```
 
 ## Links
 
-- 🌐 [Live Dashboard](https://clutch-laypatel.netlify.app)
+- 🌐 [Live Dashboard](https://clutch-woad.vercel.app)
 - 📖 [Full Documentation](https://github.com/laypatel13/clutch)
 - 🐛 [Report a Bug](https://github.com/laypatel13/clutch/issues)
 

{clutch_cli-0.2.0/clutch_cli → clutch_cli-0.3.0/clutch_cli/activity}/patterns.py

@@ -1,10 +1,8 @@
 import typer
-from rich.console import Console
 from rich.table import Table
 from rich import box
 from clutch_cli.api import get_client
-
-console = Console()
+from clutch_cli.theme import console, ACCENT, DIM, SUCCESS, WARNING, ERROR, header, footer, bar
 
 
 def patterns():
@@ -12,81 +10,68 @@ def patterns():
     with get_client() as client:
         try:
             console.print()
-            console.print("[dim]Analyzing patterns...[/dim]")
+            console.print(f"[{DIM}]Analyzing patterns...[/{DIM}]")
 
             response = client.get("/insights/patterns")
             if response.status_code != 200:
-                console.print("[red]Error: Failed to fetch patterns.[/red]")
+                console.print("[bold red]Error: Failed to fetch patterns.[/bold red]")
                 raise typer.Exit(1)
 
             data = response.json()
 
             if "message" in data:
-                console.print(f"[yellow]{data['message']}[/yellow]")
+                console.print(f"[{WARNING}]{data['message']}[/{WARNING}]")
                 raise typer.Exit()
 
-            console.print()
-            console.rule("[bold blue]⚡ CLUTCH — CODING PATTERNS[/bold blue]")
-            console.print()
+            header("CODING PATTERNS")
 
-            # Summary table
             score = data["consistency_score"]
-            score_color = "green" if score >= 70 else "yellow" if score >= 40 else "red"
+            score_style = SUCCESS if score >= 70 else WARNING if score >= 40 else ERROR
 
             summary = Table(box=box.SIMPLE, show_header=False, pad_edge=False)
-            summary.add_column("Label", style="dim", width=22)
+            summary.add_column("Label", style=DIM, width=22)
             summary.add_column("Value", style="bold white")
 
-            summary.add_row("Best Day", f"[green]{data['best_day']}[/green]")
-            summary.add_row("Worst Day", f"[dim]{data['worst_day']}[/dim]")
+            summary.add_row("Best Day", f"[{ACCENT}]{data['best_day']}[/{ACCENT}]")
+            summary.add_row("Worst Day", f"[{DIM}]{data['worst_day']}[/{DIM}]")
             summary.add_row("Avg Daily Commits", str(data["avg_daily_commits"]))
             summary.add_row("Total Active Days", str(data["total_active_days"]))
-            summary.add_row(
-                "Consistency Score",
-                f"[{score_color}]{score}%[/{score_color}]",
-            )
+            summary.add_row("Consistency Score", f"[{score_style}]{score}%[/{score_style}]")
 
             console.print(summary)
             console.print()
-            console.rule("[dim]Activity by Day[/dim]", style="dim")
+            console.rule(f"[{DIM}]Activity by Day[/{DIM}]", style=DIM)
             console.print()
 
-            # Day distribution bar chart
             day_table = Table(box=box.SIMPLE, show_header=False, pad_edge=False)
-            day_table.add_column("Day", style="dim", width=12)
+            day_table.add_column("Day", style=DIM, width=12)
             day_table.add_column("Bar", width=32)
             day_table.add_column("Count", justify="right", style="bold white", width=6)
 
             max_commits = max(data["day_distribution"].values()) or 1
             for day, commits in data["day_distribution"].items():
-                filled = int((commits / max_commits) * 28)
                 is_best = day == data["best_day"]
-                bar_color = "blue" if is_best else "white"
-                bar = f"[{bar_color}]{'█' * filled}[/{bar_color}][dim]{'░' * (28 - filled)}[/dim]"
-                day_label = f"[blue]{day}[/blue]" if is_best else day
-                day_table.add_row(day_label, bar, str(commits))
+                day_label = f"[{ACCENT}]{day}[/{ACCENT}]" if is_best else day
+                day_table.add_row(day_label, bar(commits, max_commits), str(commits))
 
             console.print(day_table)
 
-            # Top repos
             if data.get("top_repos"):
                 console.print()
-                console.rule("[dim]Most Active Repos[/dim]", style="dim")
+                console.rule(f"[{DIM}]Most Active Repos[/{DIM}]", style=DIM)
                 console.print()
 
                 repo_table = Table(box=box.SIMPLE, show_header=False, pad_edge=False)
                 repo_table.add_column("Repo", style="bold white", width=30)
-                repo_table.add_column("Active Days", justify="right", style="dim", width=12)
+                repo_table.add_column("Active Days", justify="right", style=DIM, width=12)
 
                 for repo in data["top_repos"]:
                     repo_table.add_row(repo["repo"], str(repo["days_active"]))
 
                 console.print(repo_table)
 
-            console.print()
-            console.rule(style="dim")
-            console.print()
+            footer()
 
         except Exception:
-            console.print("[red]Error: Could not connect to Clutch API.[/red]")
+            console.print("[bold red]Error: Could not connect to Clutch API.[/bold red]")
             raise typer.Exit(1)

{clutch_cli-0.2.0/clutch_cli → clutch_cli-0.3.0/clutch_cli/activity}/stats.py

@@ -1,10 +1,8 @@
 import typer
-from rich.console import Console
 from rich.table import Table
 from rich import box
 from clutch_cli.api import get_client
-
-console = Console()
+from clutch_cli.theme import console, ACCENT, DIM, SUCCESS, header, footer, bar
 
 
 def stats(days: int = typer.Option(30, help="Number of days to look back.")):
@@ -13,7 +11,7 @@ def stats(days: int = typer.Option(30, help="Number of days to look back.")):
         try:
             response = client.get(f"/github/activity?days={days}")
             if response.status_code != 200:
-                console.print("[red]Error: Failed to fetch activity data.[/red]")
+                console.print("[bold red]Error: Failed to fetch activity data.[/bold red]")
                 raise typer.Exit(1)
 
             data = response.json()
@@ -22,34 +20,26 @@ def stats(days: int = typer.Option(30, help="Number of days to look back.")):
             issues = data["total_issues"]
             active = data["active_days"]
 
-            console.print()
-            console.rule(f"[bold blue]⚡ CLUTCH — STATS · LAST {days} DAYS[/bold blue]")
-            console.print()
+            header(f"STATS · LAST {days} DAYS")
 
             table = Table(box=box.SIMPLE, show_header=True, pad_edge=False)
-            table.add_column("Metric", style="dim", width=22)
+            table.add_column("Metric", style=DIM, width=22)
             table.add_column("Count", justify="right", style="bold white", width=10)
             table.add_column("Bar", width=32)
 
             max_val = max(commits, prs, issues, active, 1)
 
-            def bar(val):
-                filled = int((val / max_val) * 28)
-                return f"[blue]{'█' * filled}[/blue][dim]{'░' * (28 - filled)}[/dim]"
-
             def color(val):
-                return "bold green" if val > 0 else "dim"
+                return SUCCESS if val > 0 else DIM
 
-            table.add_row("Commits", f"[{color(commits)}]{commits}[/{color(commits)}]", bar(commits))
-            table.add_row("Pull Requests", f"[{color(prs)}]{prs}[/{color(prs)}]", bar(prs))
-            table.add_row("Issues", f"[{color(issues)}]{issues}[/{color(issues)}]", bar(issues))
-            table.add_row("Active Days", f"[{color(active)}]{active}[/{color(active)}]", bar(active))
+            table.add_row("Commits", f"[{color(commits)}]{commits}[/{color(commits)}]", bar(commits, max_val))
+            table.add_row("Pull Requests", f"[{color(prs)}]{prs}[/{color(prs)}]", bar(prs, max_val))
+            table.add_row("Issues", f"[{color(issues)}]{issues}[/{color(issues)}]", bar(issues, max_val))
+            table.add_row("Active Days", f"[{color(active)}]{active}[/{color(active)}]", bar(active, max_val))
 
             console.print(table)
-            console.print()
-            console.rule(style="dim")
-            console.print()
+            footer()
 
         except Exception:
-            console.print("[red]Error: Could not connect to Clutch API.[/red]")
+            console.print("[bold red]Error: Could not connect to Clutch API.[/bold red]")
             raise typer.Exit(1)

clutch_cli-0.3.0/clutch_cli/activity/streak.py

@@ -0,0 +1,54 @@
+import typer
+from rich.table import Table
+from rich import box
+from clutch_cli.api import get_client
+from clutch_cli.theme import console, ACCENT, DIM, SUCCESS, WARNING, header, footer, bar
+
+
+def streak():
+    """Show your current and longest commit streak."""
+    with get_client() as client:
+        try:
+            response = client.get("/github/streak")
+            if response.status_code != 200:
+                console.print("[bold red]Error: Failed to fetch streak data.[/bold red]")
+                raise typer.Exit(1)
+
+            data = response.json()
+            current = data["current_streak"]
+            longest = data["longest_streak"]
+            total_active = data["total_active_days"]
+
+            if current >= 14:
+                status = "STRONG"
+                status_style = SUCCESS
+            elif current >= 7:
+                status = "BUILDING"
+                status_style = ACCENT
+            elif current > 0:
+                status = "ACTIVE"
+                status_style = WARNING
+            else:
+                status = "INACTIVE"
+                status_style = DIM
+
+            header("STREAK")
+
+            table = Table(box=box.SIMPLE, show_header=False, pad_edge=False)
+            table.add_column("Label", style=DIM, width=22)
+            table.add_column("Value", style="bold white")
+            table.add_column("Badge", justify="right")
+
+            table.add_row("Current Streak", f"[{ACCENT}]{current} days[/{ACCENT}]", f"[{status_style}]{status}[/{status_style}]")
+            table.add_row("Longest Streak", f"{longest} days", "")
+            table.add_row("Total Active Days", f"{total_active} days", "")
+
+            console.print(table)
+            if longest > 0:
+                console.print(f"  [{DIM}]Progress to longest[/{DIM}]  {bar(current, longest)}  [{DIM}]{current}/{longest}[/{DIM}]")
+
+            footer()
+
+        except Exception:
+            console.print("[bold red]Error: Could not connect to Clutch API.[/bold red]")
+            raise typer.Exit(1)

clutch_cli-0.3.0/clutch_cli/authentication/login.py

@@ -0,0 +1,110 @@
+import webbrowser
+from http.server import BaseHTTPRequestHandler, HTTPServer
+from urllib.parse import parse_qs, urlparse
+
+import httpx
+from clutch_cli.config import API_BASE_URL, save_token
+from clutch_cli.theme import console, ACCENT, ERROR, DIM, SUCCESS
+
+CLI_CALLBACK_PORT = 9876
+_captured_token: dict = {}
+
+
+class _CallbackHandler(BaseHTTPRequestHandler):
+    def do_GET(self):
+        parsed = urlparse(self.path)
+        if parsed.path == "/callback":
+            params = parse_qs(parsed.query)
+            token = params.get("token", [None])[0]
+            if token:
+                _captured_token["value"] = token
+                self._respond(200, _success_page())
+            else:
+                self._respond(400, _error_page("No token received."))
+        else:
+            self._respond(404, b"Not found")
+
+    def _respond(self, status: int, body: bytes) -> None:
+        self.send_response(status)
+        self.send_header("Content-Type", "text/html; charset=utf-8")
+        self.end_headers()
+        self.wfile.write(body)
+
+    def log_message(self, *args):
+        pass
+
+
+def _success_page() -> bytes:
+    return """<!DOCTYPE html>
+<html>
+<head>
+  <title>Clutch</title>
+  <link rel="icon" href="data:image/svg+xml,<svg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 100 100%22><text y=%22.9em%22 font-size=%2290%22>&#9881;&#65039;</text></svg>" />
+</head>
+<body style="font-family:-apple-system,sans-serif;text-align:center;padding:80px;background:#0a0a0a;color:#ffffff">
+  <h1 style="font-weight:800;letter-spacing:1px">CLUTCH</h1>
+  <p style="color:#ffffff;font-size:1.1rem;opacity:0.9">&#10003; Login successful &mdash; you can close this tab.</p>
+</body>
+</html>""".encode()
+
+
+def _error_page(msg: str) -> bytes:
+    return f"""<!DOCTYPE html>
+<html>
+<head>
+  <title>Clutch</title>
+  <link rel="icon" href="data:image/svg+xml,<svg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 100 100%22><text y=%22.9em%22 font-size=%2290%22>&#9881;&#65039;</text></svg>" />
+</head>
+<body style="font-family:-apple-system,sans-serif;text-align:center;padding:80px;background:#0a0a0a;color:#ffffff">
+  <h1 style="font-weight:800;letter-spacing:1px">CLUTCH</h1>
+  <p style="opacity:0.8">Login failed: {msg}</p>
+</body>
+</html>""".encode()
+
+
+def login():
+    """Login to Clutch via GitHub OAuth (browser-based, fully automatic)."""
+    console.print()
+    console.rule(f"[{ACCENT}]⚡ CLUTCH — LOGIN[/{ACCENT}]")
+    console.print(f"[{DIM}]Starting local callback listener...[/{DIM}]")
+
+    _captured_token.clear()
+    server = HTTPServer(("localhost", CLI_CALLBACK_PORT), _CallbackHandler)
+
+    login_url = f"{API_BASE_URL}/auth/github?cli=true"
+    console.print(f"[{DIM}]Opening GitHub in your browser...[/{DIM}]\n")
+    webbrowser.open(login_url)
+
+    console.print(f"[{ACCENT}]Waiting for GitHub authorization...[/{ACCENT}]")
+    console.print(f"[{DIM}](If your browser didn't open, visit:)[/{DIM}]")
+    console.print(f"[{DIM}]{login_url}[/{DIM}]\n")
+
+    server.handle_request()
+    server.server_close()
+
+    token = _captured_token.get("value")
+    if not token:
+        console.print(f"[{ERROR}]Login failed — no token received.[/{ERROR}]")
+        raise SystemExit(1)
+
+    try:
+        response = httpx.get(
+            f"{API_BASE_URL}/users/me",
+            headers={"Authorization": f"Bearer {token}"},
+            timeout=10,
+        )
+        if response.status_code != 200:
+            console.print(f"[{ERROR}]Token validation failed.[/{ERROR}]")
+            raise SystemExit(1)
+
+        user = response.json()
+        save_token(token, user["username"])
+        console.print(f"[{SUCCESS}]Logged in as @{user['username']}[/{SUCCESS}]")
+        console.print(f"[{DIM}]Welcome to Clutch, {user.get('name') or user['username']}.[/{DIM}]")
+        console.print()
+        console.rule(style=DIM)
+        console.print()
+
+    except httpx.RequestError:
+        console.print(f"[{ERROR}]Could not connect to Clutch API.[/{ERROR}]")
+        raise SystemExit(1)

clutch_cli-0.3.0/clutch_cli/authentication/logout.py

@@ -0,0 +1,13 @@
+from clutch_cli.config import clear_config, get_username
+from clutch_cli.theme import console, DIM, SUCCESS, WARNING
+
+
+def logout():
+    """Logout from Clutch."""
+    username = get_username()
+    if not username:
+        console.print(f"[{WARNING}]You are not logged in.[/{WARNING}]")
+        raise SystemExit()
+
+    clear_config()
+    console.print(f"[{SUCCESS}]Logged out successfully.[/{SUCCESS}]")

clutch_cli-0.3.0/clutch_cli/authentication/whoami.py

@@ -0,0 +1,11 @@
+from clutch_cli.config import get_username
+from clutch_cli.theme import console, ACCENT, WARNING
+
+
+def whoami():
+    """Show the currently logged-in user."""
+    username = get_username()
+    if not username:
+        console.print(f"[{WARNING}]Not logged in. Run: clutch login[/{WARNING}]")
+        raise SystemExit()
+    console.print(f"[{ACCENT}]Logged in as @{username}[/{ACCENT}]")

clutch_cli-0.2.0/clutch_cli/insight.py → clutch_cli-0.3.0/clutch_cli/insights/weekly.py

@@ -1,11 +1,9 @@
 import typer
-from rich.console import Console
 from rich.table import Table
 from rich.text import Text
 from rich import box
 from clutch_cli.api import get_client
-
-console = Console()
+from clutch_cli.theme import console, DIM, SUCCESS, WARNING, header, footer
 
 
 def insight():
@@ -13,51 +11,45 @@ def insight():
     with get_client() as client:
         try:
             console.print()
-            console.print("[dim]Generating insight...[/dim]")
+            console.print(f"[{DIM}]Generating insight...[/{DIM}]")
 
             response = client.get("/insights/weekly")
             if response.status_code != 200:
-                console.print("[red]Error: Failed to fetch insight.[/red]")
+                console.print("[bold red]Error: Failed to fetch insight.[/bold red]")
                 raise typer.Exit(1)
 
             data = response.json()
 
             if "message" in data:
-                console.print(f"[yellow]{data['message']}[/yellow]")
+                console.print(f"[{WARNING}]{data['message']}[/{WARNING}]")
                 raise typer.Exit()
 
             stats = data["stats"]
             summary = data["ai_summary"]
 
-            console.print()
-            console.rule("[bold blue]⚡ CLUTCH — WEEKLY INSIGHT[/bold blue]")
-            console.print()
+            header("WEEKLY INSIGHT")
 
-            # AI summary block
-            console.print(f"[dim]Week of[/dim] [white]{data['week_start']}[/white]")
+            console.print(f"[{DIM}]Week of[/{DIM}] [bold white]{data['week_start']}[/bold white]")
             console.print()
             console.print(Text(summary, style="white"), soft_wrap=True)
             console.print()
-            console.rule(style="dim")
+            console.rule(style=DIM)
             console.print()
 
-            # Stats row
             table = Table(box=box.SIMPLE, show_header=False, pad_edge=False)
-            table.add_column("Label", style="dim", width=22)
+            table.add_column("Label", style=DIM, width=22)
             table.add_column("Value", style="bold white")
 
-            table.add_row("Commits", f"[green]{stats['total_commits']}[/green]")
-            table.add_row("Active Days", f"[green]{stats['active_days']}[/green]")
+            table.add_row("Commits", f"[{SUCCESS}]{stats['total_commits']}[/{SUCCESS}]")
+            table.add_row("Active Days", f"[{SUCCESS}]{stats['active_days']}[/{SUCCESS}]")
             table.add_row("Pull Requests", str(stats["total_prs"]))
             table.add_row("Issues", str(stats["total_issues"]))
             table.add_row("Best Day", str(stats["best_day"]))
-            table.add_row("Generated by", f"[dim]{data['generated_by']}[/dim]")
+            table.add_row("Generated by", f"[{DIM}]{data['generated_by']}[/{DIM}]")
 
             console.print(table)
-            console.print()
-            console.rule(style="dim")
-            console.print()
+            footer()
 
         except Exception:
-            console.print("[red]Error: Could not connect to Clutch API.[/red]")
+            console.print("[bold red]Error: Could not connect to Clutch API.[/bold red]")
             raise typer.Exit(1)

clutch_cli-0.3.0/clutch_cli/main.py

@@ -0,0 +1,59 @@
+import typer
+
+from clutch_cli.authentication import login, logout, whoami
+from clutch_cli.activity import streak, stats, patterns
+from clutch_cli.repositories import list as repositories_list
+from clutch_cli.insights import weekly
+from clutch_cli.system import status
+
+__version__ = "0.3.0"
+
+app = typer.Typer(
+    name="clutch",
+    help="GitHub tracks your work. Clutch tracks you.",
+    no_args_is_help=True,
+)
+
+
+def _version_callback(value: bool):
+    if value:
+        typer.echo(f"clutch v{__version__}")
+        raise typer.Exit()
+
+
+@app.callback()
+def main(
+    version: bool = typer.Option(
+        None,
+        "--version",
+        "-v",
+        help="Show version and exit.",
+        callback=_version_callback,
+        is_eager=True,
+    ),
+):
+    pass
+
+
+# Authentication
+app.command(name="login")(login.login)
+app.command(name="logout")(logout.logout)
+app.command(name="whoami")(whoami.whoami)
+
+# Activity
+app.command(name="streak")(streak.streak)
+app.command(name="stats")(stats.stats)
+app.command(name="patterns")(patterns.patterns)
+
+# Repositories
+app.command(name="repos")(repositories_list.repos)
+
+# Insights
+app.command(name="insight")(weekly.insight)
+
+# System
+app.command(name="status")(status.status)
+
+
+if __name__ == "__main__":
+    app()

clutch_cli-0.2.0/clutch_cli/repos.py → clutch_cli-0.3.0/clutch_cli/repositories/list.py

@@ -1,24 +1,8 @@
 import typer
-from rich.console import Console
 from rich.table import Table
 from rich import box
 from clutch_cli.api import get_client
-
-console = Console()
-
-LANG_COLORS = {
-    "Python": "blue",
-    "TypeScript": "cyan",
-    "JavaScript": "yellow",
-    "Go": "cyan",
-    "Rust": "red",
-    "Java": "red",
-    "C++": "blue",
-    "C": "blue",
-    "Shell": "green",
-    "HTML": "red",
-    "CSS": "blue",
-}
+from clutch_cli.theme import console, ACCENT, DIM, WARNING, header, footer
 
 
 def repos():
@@ -27,41 +11,36 @@ def repos():
         try:
             response = client.get("/github/repos")
             if response.status_code != 200:
-                console.print("[red]Error: Failed to fetch repositories.[/red]")
+                console.print("[bold red]Error: Failed to fetch repositories.[/bold red]")
                 raise typer.Exit(1)
 
             repos_data = response.json()
 
-            console.print()
-            console.rule("[bold blue]⚡ CLUTCH — REPOSITORIES[/bold blue]")
-            console.print()
+            header("REPOSITORIES")
 
             table = Table(box=box.SIMPLE, show_header=True, pad_edge=False)
             table.add_column("Repository", style="bold white", width=28)
             table.add_column("Language", width=14)
             table.add_column("Stars", justify="right", width=7)
             table.add_column("Forks", justify="right", width=7)
-            table.add_column("Updated", style="dim", width=12)
+            table.add_column("Updated", style=DIM, width=12)
 
             for repo in repos_data[:10]:
                 lang = repo.get("language") or "—"
-                lang_color = LANG_COLORS.get(lang, "white")
                 stars = repo.get("stargazers_count", 0)
                 forks = repo.get("forks_count", 0)
 
                 table.add_row(
                     repo["name"],
-                    f"[{lang_color}]{lang}[/{lang_color}]",
-                    f"[yellow]{stars}[/yellow]" if stars > 0 else "[dim]0[/dim]",
-                    str(forks) if forks > 0 else "[dim]0[/dim]",
+                    lang,
+                    f"[{WARNING}]{stars}[/{WARNING}]" if stars > 0 else f"[{DIM}]0[/{DIM}]",
+                    str(forks) if forks > 0 else f"[{DIM}]0[/{DIM}]",
                     repo["updated_at"][:10],
                 )
 
             console.print(table)
-            console.print()
-            console.rule(style="dim")
-            console.print()
+            footer()
 
         except Exception:
-            console.print("[red]Error: Could not connect to Clutch API.[/red]")
+            console.print("[bold red]Error: Could not connect to Clutch API.[/bold red]")
             raise typer.Exit(1)

clutch_cli-0.3.0/clutch_cli/system/status.py

@@ -0,0 +1,45 @@
+import httpx
+from rich.table import Table
+from rich import box
+from clutch_cli.config import API_BASE_URL, get_token, get_username
+from clutch_cli.theme import console, ACCENT, DIM, SUCCESS, ERROR, WARNING, header, footer
+
+
+def status():
+    """Show login status and API health."""
+    username = get_username()
+    token = get_token()
+
+    header("STATUS")
+
+    table = Table(box=box.SIMPLE, show_header=False, pad_edge=False)
+    table.add_column("Check", style=DIM, width=18)
+    table.add_column("Result", style="bold white")
+
+    if not username or not token:
+        table.add_row("Auth", f"[{ERROR}]Not logged in[/{ERROR}]")
+        table.add_row("Hint", f"[{DIM}]Run: clutch login[/{DIM}]")
+        console.print(table)
+        footer()
+        raise SystemExit()
+
+    table.add_row("User", f"[{ACCENT}]@{username}[/{ACCENT}]")
+
+    try:
+        response = httpx.get(
+            f"{API_BASE_URL}/users/me",
+            headers={"Authorization": f"Bearer {token}"},
+            timeout=8,
+        )
+        if response.status_code == 200:
+            table.add_row("Token", f"[{SUCCESS}]Valid[/{SUCCESS}]")
+            table.add_row("API", f"[{SUCCESS}]Reachable[/{SUCCESS}]  [{DIM}]{API_BASE_URL}[/{DIM}]")
+        else:
+            table.add_row("Token", f"[{WARNING}]Expired ({response.status_code})[/{WARNING}]")
+            table.add_row("Hint", f"[{DIM}]Run: clutch login[/{DIM}]")
+    except httpx.RequestError:
+        table.add_row("Token", f"[{SUCCESS}]Saved[/{SUCCESS}]")
+        table.add_row("API", f"[{ERROR}]Unreachable[/{ERROR}]")
+
+    console.print(table)
+    footer()

clutch_cli-0.3.0/clutch_cli/theme.py

@@ -0,0 +1,42 @@
+"""Shared visual theme for all Clutch CLI output.
+
+One bold, monochrome accent system — no rainbow, no gradients.
+Primary: bold white. Accent: bold (terminal default bright). Dim: grey.
+Status: green (positive only), red (errors only), yellow (warnings only).
+"""
+
+from rich.console import Console
+
+console = Console()
+
+# Text styles
+PRIMARY = "bold white"
+ACCENT = "bold"          # bright/bold default terminal color — reads as black/white bold
+DIM = "dim"
+SUCCESS = "bold green"
+ERROR = "bold red"
+WARNING = "bold yellow"
+
+BRAND = "⚡ CLUTCH"
+
+
+def header(title: str) -> None:
+    """Print the standard Clutch section header."""
+    console.print()
+    console.rule(f"[{ACCENT}]{BRAND} — {title.upper()}[/{ACCENT}]")
+    console.print()
+
+
+def footer() -> None:
+    """Print the standard Clutch section footer."""
+    console.print()
+    console.rule(style=DIM)
+    console.print()
+
+
+def bar(value: float, max_value: float, width: int = 28) -> str:
+    """Render a solid/empty block bar, bold white filled + dim empty."""
+    max_value = max_value or 1
+    filled = int((value / max_value) * width)
+    filled = max(0, min(width, filled))
+    return f"[{ACCENT}]{'█' * filled}[/{ACCENT}][{DIM}]{'░' * (width - filled)}[/{DIM}]"

{clutch_cli-0.2.0 → clutch_cli-0.3.0}/clutch_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clutch-cli
-Version: 0.2.0
+Version: 0.3.0
 Summary: GitHub tracks your work. Clutch tracks you.
 Author-email: Lay Patel <lay.patel.1313@gmail.com>
 License: MIT
@@ -35,7 +35,7 @@ Requires-Dist: rich>=13.0.0
 
 ---
 
-`clutch-cli` is the terminal companion for [Clutch](https://clutch-laypatel.netlify.app) — an open-source AI-powered developer activity dashboard. Get your GitHub streaks, stats, coding patterns, and AI insights without leaving your terminal.
+`clutch-cli` is the terminal companion for [Clutch](https://clutch-woad.vercel.app) — an open-source AI-powered developer activity dashboard. Get your GitHub streaks, stats, coding patterns, and AI insights without leaving your terminal.
 
 ## Installation
 
@@ -47,7 +47,7 @@ pip install clutch-cli
 
 ```bash
 # Login via GitHub (opens browser automatically, no copy-paste needed)
-clutch auth login
+clutch login
 
 # Check your streak
 clutch streak
@@ -63,9 +63,9 @@ clutch insight
 
 | Command | Description |
 |---|---|
-| `clutch auth login` | Login via GitHub OAuth (fully automatic) |
-| `clutch auth logout` | Logout and clear saved credentials |
-| `clutch auth whoami` | Show currently logged-in user |
+| `clutch login` | Login via GitHub OAuth (fully automatic) |
+| `clutch logout` | Logout and clear saved credentials |
+| `clutch whoami` | Show currently logged-in user |
 | `clutch streak` | Current and longest commit streak |
 | `clutch stats` | Activity stats — commits, PRs, issues, active days |
 | `clutch stats --days 7` | Stats for a custom time range |
@@ -77,10 +77,10 @@ clutch insight
 
 ## How Login Works
 
-`clutch auth login` spins up a temporary local server on port `9876`, opens GitHub OAuth in your browser, and automatically captures the token when GitHub redirects back. No copy-pasting required.
+`clutch login` spins up a temporary local server on port `9876`, opens GitHub OAuth in your browser, and automatically captures the token when GitHub redirects back. No copy-pasting required.
 
 ```
-$ clutch auth login
+$ clutch login
 
 ⚡ Clutch Login
 Opening GitHub in your browser...
@@ -98,12 +98,12 @@ By default the CLI talks to the hosted Clutch API. To point it at a local backen
 
 ```bash
 export CLUTCH_API_URL=http://localhost:8000
-clutch auth login
+clutch login
 ```
 
 ## Links
 
-- 🌐 [Live Dashboard](https://clutch-laypatel.netlify.app)
+- 🌐 [Live Dashboard](https://clutch-woad.vercel.app)
 - 📖 [Full Documentation](https://github.com/laypatel13/clutch)
 - 🐛 [Report a Bug](https://github.com/laypatel13/clutch/issues)
 

clutch_cli-0.3.0/clutch_cli.egg-info/SOURCES.txt

@@ -0,0 +1,27 @@
+README.md
+pyproject.toml
+clutch_cli/__init__.py
+clutch_cli/api.py
+clutch_cli/config.py
+clutch_cli/main.py
+clutch_cli/theme.py
+clutch_cli.egg-info/PKG-INFO
+clutch_cli.egg-info/SOURCES.txt
+clutch_cli.egg-info/dependency_links.txt
+clutch_cli.egg-info/entry_points.txt
+clutch_cli.egg-info/requires.txt
+clutch_cli.egg-info/top_level.txt
+clutch_cli/activity/__init__.py
+clutch_cli/activity/patterns.py
+clutch_cli/activity/stats.py
+clutch_cli/activity/streak.py
+clutch_cli/authentication/__init__.py
+clutch_cli/authentication/login.py
+clutch_cli/authentication/logout.py
+clutch_cli/authentication/whoami.py
+clutch_cli/insights/__init__.py
+clutch_cli/insights/weekly.py
+clutch_cli/repositories/__init__.py
+clutch_cli/repositories/list.py
+clutch_cli/system/__init__.py
+clutch_cli/system/status.py

{clutch_cli-0.2.0 → clutch_cli-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "clutch-cli"
-version = "0.2.0"
+version = "0.3.0"
 description = "GitHub tracks your work. Clutch tracks you."
 readme = "README.md"
 license = { text = "MIT" }

clutch_cli-0.2.0/clutch_cli/auth.py

@@ -1,132 +0,0 @@
-import webbrowser
-from http.server import BaseHTTPRequestHandler, HTTPServer
-from urllib.parse import parse_qs, urlparse
-
-import httpx
-import typer
-from rich.console import Console
-
-from clutch_cli.config import API_BASE_URL, clear_config, get_username, save_token
-
-app = typer.Typer(help="Authentication commands.")
-console = Console()
-
-CLI_CALLBACK_PORT = 9876
-_captured_token: dict = {}
-
-
-class _CallbackHandler(BaseHTTPRequestHandler):
-    """Minimal HTTP handler that captures the JWT from the OAuth redirect."""
-
-    def do_GET(self):
-        parsed = urlparse(self.path)
-        if parsed.path == "/callback":
-            params = parse_qs(parsed.query)
-            token = params.get("token", [None])[0]
-            if token:
-                _captured_token["value"] = token
-                self._respond(200, _success_page())
-            else:
-                self._respond(400, _error_page("No token received."))
-        else:
-            self._respond(404, b"Not found")
-
-    def _respond(self, status: int, body: bytes) -> None:
-        self.send_response(status)
-        self.send_header("Content-Type", "text/html; charset=utf-8")
-        self.end_headers()
-        self.wfile.write(body)
-
-    def log_message(self, *args):
-        pass  # silence default request logging
-
-
-def _success_page() -> bytes:
-    return b"""<!DOCTYPE html>
-<html>
-<head><title>Clutch Login</title></head>
-<body style="font-family:sans-serif;text-align:center;padding:60px;background:#0d1117;color:#58a6ff">
-  <h1>&#9889; Clutch</h1>
-  <p style="color:#3fb950;font-size:1.2rem">&#10003; Login successful! You can close this tab.</p>
-</body>
-</html>"""
-
-
-def _error_page(msg: str) -> bytes:
-    return f"""<!DOCTYPE html>
-<html>
-<head><title>Clutch Login Error</title></head>
-<body style="font-family:sans-serif;text-align:center;padding:60px;background:#0d1117;color:#f85149">
-  <h1>&#9889; Clutch</h1>
-  <p>Login failed: {msg}</p>
-</body>
-</html>""".encode()
-
-
-@app.command()
-def login():
-    """Login to Clutch via GitHub OAuth (browser-based, fully automatic)."""
-    console.print("\n[bold green]⚡ Clutch Login[/bold green]")
-    console.print("[dim]Starting local callback listener...[/dim]")
-
-    _captured_token.clear()
-    server = HTTPServer(("localhost", CLI_CALLBACK_PORT), _CallbackHandler)
-
-    login_url = f"{API_BASE_URL}/auth/github?cli=true"
-    console.print("[dim]Opening GitHub in your browser...[/dim]\n")
-    webbrowser.open(login_url)
-
-    console.print("[yellow]Waiting for GitHub authorization...[/yellow]")
-    console.print("[dim](If your browser didn't open, visit:)[/dim]")
-    console.print(f"[dim]{login_url}[/dim]\n")
-
-    # Block on main thread until the OAuth callback hits localhost:9876/callback
-    server.handle_request()
-    server.server_close()
-
-    token = _captured_token.get("value")
-    if not token:
-        console.print("[red]❌ Login failed — no token received.[/red]")
-        raise typer.Exit(1)
-
-    # Verify token and fetch user info
-    try:
-        response = httpx.get(
-            f"{API_BASE_URL}/users/me",
-            headers={"Authorization": f"Bearer {token}"},
-            timeout=10,
-        )
-        if response.status_code != 200:
-            console.print("[red]❌ Token validation failed.[/red]")
-            raise typer.Exit(1)
-
-        user = response.json()
-        save_token(token, user["username"])
-        console.print(f"[bold green]✅ Logged in as @{user['username']}[/bold green]")
-        console.print(f"[dim]Welcome to Clutch, {user.get('name') or user['username']}![/dim]\n")
-
-    except httpx.RequestError:
-        console.print("[red]❌ Could not connect to Clutch API.[/red]")
-        raise typer.Exit(1)
-
-
-@app.command()
-def logout():
-    """Logout from Clutch."""
-    username = get_username()
-    if not username:
-        console.print("[yellow]You are not logged in.[/yellow]")
-        raise typer.Exit()
-
-    clear_config()
-    console.print("[bold green]✅ Logged out successfully.[/bold green]")
-
-
-@app.command()
-def whoami():
-    """Show the currently logged-in user."""
-    username = get_username()
-    if not username:
-        console.print("[yellow]Not logged in. Run: clutch auth login[/yellow]")
-        raise typer.Exit()
-    console.print(f"[bold green]Logged in as @{username}[/bold green]")

clutch_cli-0.2.0/clutch_cli/main.py

@@ -1,43 +0,0 @@
-import typer
-from clutch_cli import auth, streak, stats, insight, repos, patterns, status
-
-__version__ = "0.2.0"
-
-app = typer.Typer(
-    name="clutch",
-    help="GitHub tracks your work. Clutch tracks you.",
-    no_args_is_help=True,
-)
-
-
-def _version_callback(value: bool):
-    if value:
-        typer.echo(f"clutch v{__version__}")
-        raise typer.Exit()
-
-
-@app.callback()
-def main(
-    version: bool = typer.Option(
-        None,
-        "--version",
-        "-v",
-        help="Show version and exit.",
-        callback=_version_callback,
-        is_eager=True,
-    ),
-):
-    pass
-
-
-app.add_typer(auth.app, name="auth")
-app.command()(streak.streak)
-app.command()(stats.stats)
-app.command()(insight.insight)
-app.command()(repos.repos)
-app.command()(patterns.patterns)
-app.command()(status.status)
-
-
-if __name__ == "__main__":
-    app()

clutch_cli-0.2.0/clutch_cli/status.py

@@ -1,54 +0,0 @@
-import httpx
-import typer
-from rich.console import Console
-from rich.table import Table
-from rich import box
-from clutch_cli.config import API_BASE_URL, get_token, get_username
-
-console = Console()
-
-
-def status():
-    """Show login status and API health."""
-    username = get_username()
-    token = get_token()
-
-    console.print()
-    console.rule("[bold blue]⚡ CLUTCH — STATUS[/bold blue]")
-    console.print()
-
-    table = Table(box=box.SIMPLE, show_header=False, pad_edge=False)
-    table.add_column("Check", style="dim", width=18)
-    table.add_column("Result", style="bold white")
-
-    if not username or not token:
-        table.add_row("Auth", "[red]Not logged in[/red]")
-        table.add_row("Hint", "[dim]Run: clutch auth login[/dim]")
-        console.print(table)
-        console.print()
-        console.rule(style="dim")
-        console.print()
-        raise typer.Exit()
-
-    table.add_row("User", f"[blue]@{username}[/blue]")
-
-    try:
-        response = httpx.get(
-            f"{API_BASE_URL}/users/me",
-            headers={"Authorization": f"Bearer {token}"},
-            timeout=8,
-        )
-        if response.status_code == 200:
-            table.add_row("Token", "[green]Valid[/green]")
-            table.add_row("API", f"[green]Reachable[/green]  [dim]{API_BASE_URL}[/dim]")
-        else:
-            table.add_row("Token", f"[yellow]Expired ({response.status_code})[/yellow]")
-            table.add_row("Hint", "[dim]Run: clutch auth login[/dim]")
-    except httpx.RequestError:
-        table.add_row("Token", "[green]Saved[/green]")
-        table.add_row("API", "[red]Unreachable[/red]")
-
-    console.print(table)
-    console.print()
-    console.rule(style="dim")
-    console.print()

clutch_cli-0.2.0/clutch_cli/streak.py

@@ -1,80 +0,0 @@
-import typer
-from rich.console import Console
-from rich.table import Table
-from rich import box
-from clutch_cli.api import get_client
-
-console = Console()
-
-
-def streak():
-    """Show your current and longest commit streak."""
-    with get_client() as client:
-        try:
-            response = client.get("/github/streak")
-            if response.status_code != 200:
-                console.print("[red]Error: Failed to fetch streak data.[/red]")
-                raise typer.Exit(1)
-
-            data = response.json()
-            current = data["current_streak"]
-            longest = data["longest_streak"]
-            total_active = data["total_active_days"]
-
-            if current >= 30:
-                streak_color = "bold green"
-                status = "ON FIRE"
-            elif current >= 14:
-                streak_color = "bold green"
-                status = "STRONG"
-            elif current >= 7:
-                streak_color = "bold blue"
-                status = "BUILDING"
-            elif current > 0:
-                streak_color = "bold yellow"
-                status = "ACTIVE"
-            else:
-                streak_color = "dim"
-                status = "INACTIVE"
-
-            console.print()
-            console.rule("[bold blue]⚡ CLUTCH — STREAK[/bold blue]")
-            console.print()
-
-            table = Table(box=box.SIMPLE, show_header=False, pad_edge=False)
-            table.add_column("Label", style="dim", width=22)
-            table.add_column("Value", style="bold white")
-            table.add_column("Badge", justify="right")
-
-            table.add_row(
-                "Current Streak",
-                f"[{streak_color}]{current} DAY'S[/{streak_color}]",
-                f"[blue]{status}[/blue]",
-            )
-            table.add_row(
-                "Longest Streak",
-                f"{longest} DAY'S",
-                "",
-            )
-            table.add_row(
-                "Total Active Days",
-                f"{total_active} DAY'S",
-                "",
-            )
-
-            # Visual bar: current vs longest
-            if longest > 0:
-                filled = int((current / longest) * 30)
-                bar = "█" * filled + "░" * (30 - filled)
-                console.print(table)
-                console.print(f"  [dim]Progress to longest[/dim]  [blue]{bar}[/blue]  [dim]{current}/{longest}[/dim]")
-            else:
-                console.print(table)
-
-            console.print()
-            console.rule(style="dim")
-            console.print()
-
-        except Exception:
-            console.print("[red]Error: Could not connect to Clutch API.[/red]")
-            raise typer.Exit(1)

clutch_cli-0.2.0/clutch_cli.egg-info/SOURCES.txt

@@ -1,19 +0,0 @@
-README.md
-pyproject.toml
-clutch_cli/__init__.py
-clutch_cli/api.py
-clutch_cli/auth.py
-clutch_cli/config.py
-clutch_cli/insight.py
-clutch_cli/main.py
-clutch_cli/patterns.py
-clutch_cli/repos.py
-clutch_cli/stats.py
-clutch_cli/status.py
-clutch_cli/streak.py
-clutch_cli.egg-info/PKG-INFO
-clutch_cli.egg-info/SOURCES.txt
-clutch_cli.egg-info/dependency_links.txt
-clutch_cli.egg-info/entry_points.txt
-clutch_cli.egg-info/requires.txt
-clutch_cli.egg-info/top_level.txt