myclutch 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 myclutch
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 heatmap |
Contribution heatmap for last 12 weeks |
clutch heatmap --weeks N |
Contribution heatmap for 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
Release files for myclutch 0.4.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 | |
|---|---|---|---|
| myclutch-0.4.0.tar.gz | 13.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| myclutch-0.4.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 32.4 kB
Release files / myclutch-0.4.0.tar.gz
| Download URL | myclutch-0.4.0.tar.gz |
|---|---|
| Size | 13.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9788a9929a9f16820dd7cb1814d90e13514ced3dc58c9a7386c3bafe8a0a850d
|
|
BLAKE2b-256 checksum How to use checksums |
f9ec4efe575b48ac2033d2954a95ee8b35cc3312b85d49aacf771a645ce0edda
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.2
|
Release files / myclutch-0.4.0-py3-none-any.whl
| Download URL | myclutch-0.4.0-py3-none-any.whl |
|---|---|
| Size | 18.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
414afea218f5240d17be67431c7bc4525444321b3c5f32bbb1089c3ac71fa630
|
|
BLAKE2b-256 checksum How to use checksums |
5cb1291f6270d224ed04c37dc13acd0020aea30e1eb8f4d800bfd1049b612401
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.2
|
