clutch-cli 0.3.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 login

# Check your streak
clutch streak

# View your stats
clutch stats

# Get your AI weekly insight
clutch insight

Commands

Command	Description
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
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 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

⚡ 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 login

Links

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

License

MIT © Lay Patel