clutch-cli 0.2.0

GitHub tracks your work. Clutch tracks you.

⚡ clutch-cli

The CLI companion for Clutch — GitHub tracks your work. Clutch tracks you.

---

clutch-cli is the terminal companion for Clutch — an open-source AI-powered developer activity dashboard. Get your GitHub streaks, stats, coding patterns, and AI insights without leaving your terminal.

Installation

pip install clutch-cli

Quick Start

# 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:

export CLUTCH_API_URL=http://localhost:8000
clutch auth login

Links

• 🌐 Live Dashboard
• 📖 Full Documentation
• 🐛 Report a Bug

License

MIT © Lay Patel