A Textual-powered TUI that surfaces GitHub repo traffic the web UI buries behind graphs menus: clones, views, referrers, top paths — plus stars/forks/watchers, language breakdown, and recent commits, all in one screen.
Styled in the neo-glitch palette: RGB-split neon on void black.
- Hero panel — description, stars / forks / watchers / issues, language mix, last push
- Clones & views (14 days) — daily totals and unique counts with neon bar sparklines
- Referrers & top paths — where your traffic comes from
- Recent commits — last 14 days with authors and timestamps
Ctrl+T— cycle through every repo you have push access tor— refresh (auto-refreshes every 5 minutes anyway)q— quit
No tokens, no OAuth apps, no stored credentials — every API call is
delegated to gh, which manages its own keyring auth.
git clone https://github.com/keviedev/ghstats.git
cd ghstats
pip install --user textual
# run straight from the repo, or install a launcher:
ln -s "$PWD/ghstats.py" ~/.local/bin/ghstatsghstats.py # launcher — adds repo root to sys.path, calls main()
ghstats/
├── api.py # GitHubAPI — gh CLI calls, payload quirks, data bundles
├── widgets.py # neo-glitch palette, NeoPanel, rich table builders
├── ui.py # dashboard construction (hero, traffic, referrers, commits)
├── app.py # GhStats App: bindings, workers, refresh cycle
└── styles.tcss # Textual stylesheet
Optionally, add a keybind in Omarchy/Hyprland:
o.bind("SUPER + G", "ghstats", { terminal = "ghstats" })| Token | Hex |
|---|---|
| void | #07040c |
| green | #00ff9f |
| cyan | #00e5ff |
| magenta | #ea00d9 |
| red | #ff2a6d |
| yellow | #f9f871 |
Matches the neo-glitch Omarchy theme.
MIT
