clutch-cli 0.2.0__tar.gz

clutch_cli-0.2.0/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: clutch-cli
+Version: 0.2.0
+Summary: GitHub tracks your work. Clutch tracks you.
+Author-email: Lay Patel <lay.patel.1313@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/laypatel13/clutch
+Project-URL: Bug Tracker, https://github.com/laypatel13/clutch/issues
+Keywords: github,developer,activity,cli,dashboard,streak
+Classifier: Development Status :: 3 - Alpha
+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: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: typer>=0.12.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: rich>=13.0.0
+
+<div align="center">
+
+# ⚡ clutch-cli
+
+### *The CLI companion for Clutch — GitHub tracks your work. Clutch tracks you.*
+
+[![PyPI](https://img.shields.io/pypi/v/clutch-cli?style=for-the-badge&color=green)](https://pypi.org/project/clutch-cli)
+[![Python](https://img.shields.io/badge/Python-3.11+-3776AB?style=for-the-badge&logo=python&logoColor=white)](https://python.org)
+[![License](https://img.shields.io/badge/License-MIT-blue?style=for-the-badge)](https://github.com/laypatel13/clutch/blob/main/LICENSE)
+
+</div>
+
+---
+
+`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.
+
+## Installation
+
+```bash
+pip install clutch-cli
+```
+
+## Quick Start
+
+```bash
+# Login via GitHub (opens browser automatically, no copy-paste needed)
+clutch auth login
+
+# Check your streak
+clutch streak
+
+# View your stats
+clutch stats
+
+# Get your AI weekly insight
+clutch insight
+```
+
+## Commands
+
+| 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 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 |
+| `clutch repos` | Your most recently active repositories |
+| `clutch insight` | AI-generated weekly insight (powered by Groq Llama) |
+| `clutch patterns` | Coding patterns — best day, consistency score, day distribution |
+| `clutch status` | Login status and API health check |
+| `clutch --version` | Show installed version |
+
+## 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 auth login
+
+⚡ Clutch Login
+Opening GitHub in your browser...
+Waiting for GitHub authorization...
+
+✅ Logged in as @laypatel13
+Welcome to Clutch, Lay Patel!
+```
+
+After the first login, your token is saved in `~/.clutch/config.json` and all commands work silently.
+
+## Configuration
+
+By default the CLI talks to the hosted Clutch API. To point it at a local backend:
+
+```bash
+export CLUTCH_API_URL=http://localhost:8000
+clutch auth login
+```
+
+## Links
+
+- 🌐 [Live Dashboard](https://clutch-laypatel.netlify.app)
+- 📖 [Full Documentation](https://github.com/laypatel13/clutch)
+- 🐛 [Report a Bug](https://github.com/laypatel13/clutch/issues)
+
+## License
+
+MIT © [Lay Patel](https://github.com/laypatel13)

clutch_cli-0.2.0/README.md

@@ -0,0 +1,89 @@
+<div align="center">
+
+# ⚡ clutch-cli
+
+### *The CLI companion for Clutch — GitHub tracks your work. Clutch tracks you.*
+
+[![PyPI](https://img.shields.io/pypi/v/clutch-cli?style=for-the-badge&color=green)](https://pypi.org/project/clutch-cli)
+[![Python](https://img.shields.io/badge/Python-3.11+-3776AB?style=for-the-badge&logo=python&logoColor=white)](https://python.org)
+[![License](https://img.shields.io/badge/License-MIT-blue?style=for-the-badge)](https://github.com/laypatel13/clutch/blob/main/LICENSE)
+
+</div>
+
+---
+
+`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.
+
+## Installation
+
+```bash
+pip install clutch-cli
+```
+
+## Quick Start
+
+```bash
+# Login via GitHub (opens browser automatically, no copy-paste needed)
+clutch auth login
+
+# Check your streak
+clutch streak
+
+# View your stats
+clutch stats
+
+# Get your AI weekly insight
+clutch insight
+```
+
+## Commands
+
+| 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 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 |
+| `clutch repos` | Your most recently active repositories |
+| `clutch insight` | AI-generated weekly insight (powered by Groq Llama) |
+| `clutch patterns` | Coding patterns — best day, consistency score, day distribution |
+| `clutch status` | Login status and API health check |
+| `clutch --version` | Show installed version |
+
+## 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 auth login
+
+⚡ Clutch Login
+Opening GitHub in your browser...
+Waiting for GitHub authorization...
+
+✅ Logged in as @laypatel13
+Welcome to Clutch, Lay Patel!
+```
+
+After the first login, your token is saved in `~/.clutch/config.json` and all commands work silently.
+
+## Configuration
+
+By default the CLI talks to the hosted Clutch API. To point it at a local backend:
+
+```bash
+export CLUTCH_API_URL=http://localhost:8000
+clutch auth login
+```
+
+## Links
+
+- 🌐 [Live Dashboard](https://clutch-laypatel.netlify.app)
+- 📖 [Full Documentation](https://github.com/laypatel13/clutch)
+- 🐛 [Report a Bug](https://github.com/laypatel13/clutch/issues)
+
+## License
+
+MIT © [Lay Patel](https://github.com/laypatel13)

clutch_cli-0.2.0/clutch_cli/__init__.py

@@ -0,0 +1,3 @@
+from clutch_cli.main import __version__
+
+__all__ = ["__version__"]

clutch_cli-0.2.0/clutch_cli/api.py

@@ -0,0 +1,16 @@
+import httpx
+import typer
+from clutch_cli.config import get_token, API_BASE_URL
+
+
+def get_client() -> httpx.Client:
+    """Get authenticated HTTP client."""
+    token = get_token()
+    if not token:
+        typer.echo("❌ You are not logged in. Run: clutch auth login")
+        raise typer.Exit(1)
+    return httpx.Client(
+        base_url=API_BASE_URL,
+        headers={"Authorization": f"Bearer {token}"},
+        timeout=15,
+    )

clutch_cli-0.2.0/clutch_cli/auth.py

@@ -0,0 +1,132 @@
+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/config.py

@@ -0,0 +1,36 @@
+import json
+import os
+from pathlib import Path
+
+CONFIG_DIR = Path.home() / ".clutch"
+CONFIG_FILE = CONFIG_DIR / "config.json"
+API_BASE_URL = os.getenv("CLUTCH_API_URL", "https://clutch-api-7lw4.onrender.com")
+
+def save_token(token: str, username: str) -> None:
+    """Save auth token to local config file."""
+    CONFIG_DIR.mkdir(exist_ok=True)
+    config = {"token": token, "username": username}
+    CONFIG_FILE.write_text(json.dumps(config, indent=2))
+
+
+def load_config() -> dict:
+    """Load config from local file."""
+    if not CONFIG_FILE.exists():
+        return {}
+    return json.loads(CONFIG_FILE.read_text())
+
+
+def get_token() -> str | None:
+    """Get saved auth token."""
+    return load_config().get("token")
+
+
+def get_username() -> str | None:
+    """Get saved username."""
+    return load_config().get("username")
+
+
+def clear_config() -> None:
+    """Remove saved config."""
+    if CONFIG_FILE.exists():
+        CONFIG_FILE.unlink()

clutch_cli-0.2.0/clutch_cli/insight.py

@@ -0,0 +1,63 @@
+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()
+
+
+def insight():
+    """Get your AI-generated weekly insight."""
+    with get_client() as client:
+        try:
+            console.print()
+            console.print("[dim]Generating insight...[/dim]")
+
+            response = client.get("/insights/weekly")
+            if response.status_code != 200:
+                console.print("[red]Error: Failed to fetch insight.[/red]")
+                raise typer.Exit(1)
+
+            data = response.json()
+
+            if "message" in data:
+                console.print(f"[yellow]{data['message']}[/yellow]")
+                raise typer.Exit()
+
+            stats = data["stats"]
+            summary = data["ai_summary"]
+
+            console.print()
+            console.rule("[bold blue]⚡ CLUTCH — WEEKLY INSIGHT[/bold blue]")
+            console.print()
+
+            # AI summary block
+            console.print(f"[dim]Week of[/dim] [white]{data['week_start']}[/white]")
+            console.print()
+            console.print(Text(summary, style="white"), soft_wrap=True)
+            console.print()
+            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("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("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]")
+
+            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/main.py

@@ -0,0 +1,43 @@
+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/patterns.py

@@ -0,0 +1,92 @@
+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 patterns():
+    """Show your coding patterns and habits."""
+    with get_client() as client:
+        try:
+            console.print()
+            console.print("[dim]Analyzing patterns...[/dim]")
+
+            response = client.get("/insights/patterns")
+            if response.status_code != 200:
+                console.print("[red]Error: Failed to fetch patterns.[/red]")
+                raise typer.Exit(1)
+
+            data = response.json()
+
+            if "message" in data:
+                console.print(f"[yellow]{data['message']}[/yellow]")
+                raise typer.Exit()
+
+            console.print()
+            console.rule("[bold blue]⚡ CLUTCH — CODING PATTERNS[/bold blue]")
+            console.print()
+
+            # Summary table
+            score = data["consistency_score"]
+            score_color = "green" if score >= 70 else "yellow" if score >= 40 else "red"
+
+            summary = Table(box=box.SIMPLE, show_header=False, pad_edge=False)
+            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("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}]",
+            )
+
+            console.print(summary)
+            console.print()
+            console.rule("[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("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))
+
+            console.print(day_table)
+
+            # Top repos
+            if data.get("top_repos"):
+                console.print()
+                console.rule("[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)
+
+                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()
+
+        except Exception:
+            console.print("[red]Error: Could not connect to Clutch API.[/red]")
+            raise typer.Exit(1)

clutch_cli-0.2.0/clutch_cli/repos.py

@@ -0,0 +1,67 @@
+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",
+}
+
+
+def repos():
+    """Show your most recently active repositories."""
+    with get_client() as client:
+        try:
+            response = client.get("/github/repos")
+            if response.status_code != 200:
+                console.print("[red]Error: Failed to fetch repositories.[/red]")
+                raise typer.Exit(1)
+
+            repos_data = response.json()
+
+            console.print()
+            console.rule("[bold blue]⚡ CLUTCH — REPOSITORIES[/bold blue]")
+            console.print()
+
+            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)
+
+            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]",
+                    repo["updated_at"][:10],
+                )
+
+            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/stats.py

@@ -0,0 +1,55 @@
+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 stats(days: int = typer.Option(30, help="Number of days to look back.")):
+    """Show your GitHub activity stats."""
+    with get_client() as client:
+        try:
+            response = client.get(f"/github/activity?days={days}")
+            if response.status_code != 200:
+                console.print("[red]Error: Failed to fetch activity data.[/red]")
+                raise typer.Exit(1)
+
+            data = response.json()
+            commits = data["total_commits"]
+            prs = data["total_prs"]
+            issues = data["total_issues"]
+            active = data["active_days"]
+
+            console.print()
+            console.rule(f"[bold blue]⚡ CLUTCH — STATS · LAST {days} DAYS[/bold blue]")
+            console.print()
+
+            table = Table(box=box.SIMPLE, show_header=True, pad_edge=False)
+            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"
+
+            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))
+
+            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/status.py

@@ -0,0 +1,54 @@
+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

@@ -0,0 +1,80 @@
+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/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: clutch-cli
+Version: 0.2.0
+Summary: GitHub tracks your work. Clutch tracks you.
+Author-email: Lay Patel <lay.patel.1313@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/laypatel13/clutch
+Project-URL: Bug Tracker, https://github.com/laypatel13/clutch/issues
+Keywords: github,developer,activity,cli,dashboard,streak
+Classifier: Development Status :: 3 - Alpha
+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: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: typer>=0.12.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: rich>=13.0.0
+
+<div align="center">
+
+# ⚡ clutch-cli
+
+### *The CLI companion for Clutch — GitHub tracks your work. Clutch tracks you.*
+
+[![PyPI](https://img.shields.io/pypi/v/clutch-cli?style=for-the-badge&color=green)](https://pypi.org/project/clutch-cli)
+[![Python](https://img.shields.io/badge/Python-3.11+-3776AB?style=for-the-badge&logo=python&logoColor=white)](https://python.org)
+[![License](https://img.shields.io/badge/License-MIT-blue?style=for-the-badge)](https://github.com/laypatel13/clutch/blob/main/LICENSE)
+
+</div>
+
+---
+
+`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.
+
+## Installation
+
+```bash
+pip install clutch-cli
+```
+
+## Quick Start
+
+```bash
+# Login via GitHub (opens browser automatically, no copy-paste needed)
+clutch auth login
+
+# Check your streak
+clutch streak
+
+# View your stats
+clutch stats
+
+# Get your AI weekly insight
+clutch insight
+```
+
+## Commands
+
+| 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 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 |
+| `clutch repos` | Your most recently active repositories |
+| `clutch insight` | AI-generated weekly insight (powered by Groq Llama) |
+| `clutch patterns` | Coding patterns — best day, consistency score, day distribution |
+| `clutch status` | Login status and API health check |
+| `clutch --version` | Show installed version |
+
+## 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 auth login
+
+⚡ Clutch Login
+Opening GitHub in your browser...
+Waiting for GitHub authorization...
+
+✅ Logged in as @laypatel13
+Welcome to Clutch, Lay Patel!
+```
+
+After the first login, your token is saved in `~/.clutch/config.json` and all commands work silently.
+
+## Configuration
+
+By default the CLI talks to the hosted Clutch API. To point it at a local backend:
+
+```bash
+export CLUTCH_API_URL=http://localhost:8000
+clutch auth login
+```
+
+## Links
+
+- 🌐 [Live Dashboard](https://clutch-laypatel.netlify.app)
+- 📖 [Full Documentation](https://github.com/laypatel13/clutch)
+- 🐛 [Report a Bug](https://github.com/laypatel13/clutch/issues)
+
+## License
+
+MIT © [Lay Patel](https://github.com/laypatel13)

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

@@ -0,0 +1,19 @@
+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

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,2 @@
+[console_scripts]
+clutch = clutch_cli.main:app

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

@@ -0,0 +1,3 @@
+typer>=0.12.0
+httpx>=0.27.0
+rich>=13.0.0

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

@@ -0,0 +1 @@
+clutch_cli

clutch_cli-0.2.0/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "clutch-cli"
+version = "0.2.0"
+description = "GitHub tracks your work. Clutch tracks you."
+readme = "README.md"
+license = { text = "MIT" }
+authors = [{ name = "Lay Patel", email = "lay.patel.1313@gmail.com" }]
+requires-python = ">=3.11"
+keywords = ["github", "developer", "activity", "cli", "dashboard", "streak"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Version Control :: Git",
+]
+dependencies = [
+    "typer>=0.12.0",
+    "httpx>=0.27.0",
+    "rich>=13.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/laypatel13/clutch"
+"Bug Tracker" = "https://github.com/laypatel13/clutch/issues"
+
+[project.scripts]
+clutch = "clutch_cli.main:app"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["clutch_cli*"]

clutch_cli-0.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+