Skip to content
keviedevPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ghstats — a neon GitHub dashboard for your terminal

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.

ghstats

Features

  • 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 to
  • r — refresh (auto-refreshes every 5 minutes anyway)
  • q — quit

Requirements

  • Python 3.11+ with Textual
  • The gh CLI, logged in (gh auth login)

No tokens, no OAuth apps, no stored credentials — every API call is delegated to gh, which manages its own keyring auth.

Install

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/ghstats

Project structure

ghstats.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" })

Palette

Token Hex
void #07040c
green #00ff9f
cyan #00e5ff
magenta #ea00d9
red #ff2a6d
yellow #f9f871

Matches the neo-glitch Omarchy theme.

License

MIT

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages