Active · v1.0

ghboard

GitHub activity dashboard for your terminal. Contribution heatmap, starred repos, and live notifications in a BubbleTea TUI. No browser required. Built in Go because it should open instantly and stay out of the way.

language

tabs

MIT

license

TUI

interface

What it is

ghboard is a terminal dashboard for GitHub. One command, one screen, everything you actually need to see: your contribution heatmap for the year, your starred repos, and your live notifications. Tab between them. No browser. No context switch.

Built with Go and BubbleTea. It launches in under a second, polls the GitHub API with a configurable refresh interval, and renders cleanly at any terminal width.

Want the full story on why I built it and how BubbleTea works under the hood? Read the post →

Install

git clone https://github.com/Null-Phnix/ghboard
cd ghboard
go build -o ghboard .
export GITHUB_TOKEN=your_token_here
./ghboard

Tabs

Heatmap

Full-year contribution heatmap rendered in the terminal. Same visual as GitHub profile but offline and instant.

Stars

Your starred repositories in a scrollable list with descriptions. Browse without opening a browser.

Notifications

Live GitHub notifications with type labels: PRs, issues, mentions. Mark read without leaving the terminal.

Usage

Tab / Shift+Tab   switch between Heatmap / Stars / Notifications
j / k             scroll lists
r                 refresh data
q / Ctrl+C        quit

Config

GITHUB_TOKEN=ghp_...       # required, classic or fine-grained PAT
GITHUB_USERNAME=Null-Phnix # optional, auto-detected if not set
GHBOARD_REFRESH=60         # optional, refresh interval in seconds

Open source on github.com/Null-Phnix/ghboard. Issues and PRs welcome.