README
¶
gh-repo-dashboard
See the status of every git and jj repository under a directory in one dashboard, with GitHub pull request and CI state beside the local status. Fetch, prune, and delete merged branches across all of them at once.
Install
# GitHub CLI extension
gh extension install kyleking/gh-repo-dashboard
# Homebrew
brew install --cask kyleking/tap/gh-repo-dashboard
# from source
go build -o gh-repo-dashboard ./cmd/gh-repo-dashboard
Quick start
Pass the directories that hold your repositories:
gh repo-dashboard -depth 2 ~/Developer
Move with j and k, press enter to open a repo, and press ? for the
keymap. Set scan_paths in the config file once and
gh repo-dashboard launches from anywhere with no arguments.
What it does not do
- Commit, push, merge, rebase, or stage. The only writes are
fetch, remote prune, and deleting branches already merged upstream - Open or create pull requests. Use
gh prfor that - Replace a single-repo client. Per-repo detail is read-only, so use lazygit or gitui to work inside one repo
- Replace
gh. Pull request data comes from theghCLI, and every non-GitHub column still works whenghis missing or logged out - Edit your notes files. It reads the configured notes files and never writes them
- Run as a server or daemon.
--cliand--scriptare one-shot headless runs
Full docs: ./docs
License
MIT
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
gh-repo-dashboard
command
Package main implements gh-repo-dashboard: K9s-inspired Bubble Tea TUI for managing multiple git and jj repositories
|
Package main implements gh-repo-dashboard: K9s-inspired Bubble Tea TUI for managing multiple git and jj repositories |
|
internal
|
|
|
app
Package app implements the Bubble Tea TUI model, update, and view for gh-repo-dashboard.
|
Package app implements the Bubble Tea TUI model, update, and view for gh-repo-dashboard. |
|
batch
Package batch runs repo operations (fetch, prune, cleanup) over multiple repos concurrently.
|
Package batch runs repo operations (fetch, prune, cleanup) over multiple repos concurrently. |
|
cache
Package cache provides a generic in-memory TTL cache used to avoid redundant gh/git/jj calls across TUI refreshes.
|
Package cache provides a generic in-memory TTL cache used to avoid redundant gh/git/jj calls across TUI refreshes. |
|
cli
Package cli implements the non-interactive --cli mode that prints repo summaries as JSON instead of launching the TUI.
|
Package cli implements the non-interactive --cli mode that prints repo summaries as JSON instead of launching the TUI. |
|
config
Package config loads the optional TOML config file, applied below flags and above built-in defaults.
|
Package config loads the optional TOML config file, applied below flags and above built-in defaults. |
|
copier
Package copier reads a repo's .copier-answers.yml and compares its installed template commit against the template's latest upstream semver tag.
|
Package copier reads a repo's .copier-answers.yml and compares its installed template commit against the template's latest upstream semver tag. |
|
discovery
Package discovery walks configured base paths to find git and jj repositories.
|
Package discovery walks configured base paths to find git and jj repositories. |
|
filters
Package filters implements repo list filtering, fuzzy search, and sorting.
|
Package filters implements repo list filtering, fuzzy search, and sorting. |
|
github
Package github wraps the gh CLI to fetch pull request and workflow run data.
|
Package github wraps the gh CLI to fetch pull request and workflow run data. |
|
models
Package models defines the domain types shared across the repo dashboard: repos, branches, pull requests, and the filter/sort state used to display them.
|
Package models defines the domain types shared across the repo dashboard: repos, branches, pull requests, and the filter/sort state used to display them. |
|
ui/styles
Package styles defines the Catppuccin-derived color palette and lipgloss styles shared across the TUI's views.
|
Package styles defines the Catppuccin-derived color palette and lipgloss styles shared across the TUI's views. |
|
vcs
Package vcs abstracts git and jj repository operations behind a common Operations interface.
|
Package vcs abstracts git and jj repository operations behind a common Operations interface. |
Click to show internal directories.
Click to hide internal directories.