Skip to content

Releases: zombocoder/ghdash

Release v0.3.1

12 Feb 18:03

Choose a tag to compare

v0.3.1

Bug Fixes

  • Stale data after refresh: Pressing r to refresh now invalidates the disk cache before fetching, ensuring closed PRs and updated data are reflected immediately. Previously, refresh would serve cached results until the TTL expired, causing closed PRs to remain visible.

Full Changelog

v0.2.0...v0.3.1

Full Changelog: v0.2.0...v0.3.1

Release v0.2.0

12 Feb 17:02

Choose a tag to compare

Release v0.2.0

Bug Fixes

  • Fixed search overlay position — The search input (/) was rendering at the bottom of the navigation pane instead of spanning the full terminal width. It now renders as a full-width bar just above the status bar, matching the expected command-line prompt appearance.

Download

Platform Download
macOS (Apple Silicon) ghdash-aarch64-apple-darwin.tar.gz
macOS (Intel) ghdash-x86_64-apple-darwin.tar.gz
Linux (x86_64) ghdash-x86_64-unknown-linux-gnu.tar.gz
Linux (aarch64) ghdash-aarch64-unknown-linux-gnu.tar.gz
Windows (x86_64) ghdash-x86_64-pc-windows-msvc.zip

From source

cargo install --git https://github.com/zombocoder/ghdash.git --tag v0.2.0

Full Changelog

v0.1.0...v0.2.0

Full Changelog: v0.1.0...v0.2.0

Initial release of ghdash - a terminal UI dashboard for GitHub.

12 Feb 16:44

Choose a tag to compare

Release v0.1.0

Initial release of ghdash - a terminal UI dashboard for GitHub.

Highlights

  • TUI dashboard built with ratatui and crossterm, featuring a two-pane layout with a collapsible navigation tree and PR list table
  • GitHub GraphQL API integration with automatic pagination and bounded concurrency
  • Organization and personal account support — monitor repos from both orgs and users in a single dashboard
  • Inbox view — see PRs where you're requested for review or assigned, deduplicated and sorted by last update
  • All open PRs view — aggregated across all configured organizations and users
  • Client-side search — filter displayed PRs by title, author, or repo name with /
  • Browser integration — open any PR or repo in your default browser with o or Enter
  • Disk caching — JSON file cache with configurable TTL to minimize API calls
  • Auto-refresh — configurable interval with manual refresh via r
  • Vim-style keybindingsj/k navigation, h/l for back/select, Tab to switch panes
  • TOML configuration — supports ~/.config/ghdash/config.toml (and macOS ~/Library/Application Support/)
  • Flexible authentication — resolves tokens via gh auth token, GITHUB_TOKEN, or GH_TOKEN
  • Repo filtering — include/exclude repos with glob patterns
  • Error handling — dismissible error modals, non-fatal cache errors, actionable auth error messages

Installation

Download a prebuilt binary

Platform Download
macOS (Apple Silicon) ghdash-aarch64-apple-darwin.tar.gz
macOS (Intel) ghdash-x86_64-apple-darwin.tar.gz
Linux (x86_64) ghdash-x86_64-unknown-linux-gnu.tar.gz
Linux (aarch64) ghdash-aarch64-unknown-linux-gnu.tar.gz
Windows (x86_64) ghdash-x86_64-pc-windows-msvc.zip

From source

cargo install --git https://github.com/zombocoder/ghdash.git --tag v0.1.0

Quick start

  1. Authenticate with GitHub:

    gh auth login
  2. Create a config file:

    mkdir -p ~/.config/ghdash
    cat > ~/.config/ghdash/config.toml << 'EOF'
    [github]
    users = ["your-username"]
    # orgs = ["your-org"]
    EOF
  3. Run:

    ghdash

Keybindings

Key Action
j / k Move down / up
Enter / l Select / expand
Esc / h Back / collapse
Tab Switch pane
r Refresh
o Open in browser
/ Search
q Quit

Configuration reference

See README.md for the full config reference.

What's next

Planned for future releases:

  • PR detail view with review status, checks, and comments
  • Notification integration
  • Custom keybinding configuration
  • Theme customization
  • GitHub Enterprise Server support

Full Changelog: https://github.com/zombocoder/ghdash/commits/v0.1.0