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
License
MIT © Lay Patel
1 maintainer
Metadata
1 maintainer
Release files for clutch-cli 0.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| clutch_cli-0.3.0.tar.gz | 10.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| clutch_cli-0.3.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 25.3 kB
Release files / clutch_cli-0.3.0.tar.gz
| Download URL | clutch_cli-0.3.0.tar.gz |
|---|---|
| Size | 10.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
bde5a0bb64df1e927426dcef019cfd44fdd5e1200e0e1db43c54c214c527ea07
|
|
BLAKE2b-256 checksum How to use checksums |
d554dec69cc06ae6eb167aec2cdb44ead4731f88c403b4b925bba1bb00a8c7e8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.2
|
Release files / clutch_cli-0.3.0-py3-none-any.whl
| Download URL | clutch_cli-0.3.0-py3-none-any.whl |
|---|---|
| Size | 14.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b5a5ebe2a454662a63e4b8bac1be895fdeeb1b4ed30f2effc3d3be40a25e2408
|
|
BLAKE2b-256 checksum How to use checksums |
a550c41a3626cf2a57f62895c16c6b5fe26b62f287fa64975f9116cac6c4a121
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.2
|
