gubbi

Work in progress — not production ready. Expect breaking changes.

A terminal-native Git + GitHub client. Full keyboard navigation, live GitHub data, and a dashboard that replaces the GitHub web UI — all in your terminal.

Built on Bun, SolidJS, and OpenTUI.

---

Requirements

• Bun >= 1.3
• git
• gh — GitHub CLI, authenticated (gh auth login)
• Nerd Font — required for icons. Install any Nerd Font (e.g. JetBrains Mono Nerd Font, Hack Nerd Font) and set it as your terminal font.

Installation

git clone https://github.com/nommyt/gubbi
cd gubbi
bun install
bun run build:cli

This builds the binary and symlinks it to ~/.local/bin/gubbi. Make sure ~/.local/bin is in your PATH.

Usage

Run from inside any git repository:

gubbi

For development (restarts on file change):

bun run dev:cli

Views

Key	View	Description
1	smartlog	Sapling-inspired commit graph with ASCII visualization
2	status	Git staging area with diff preview and blame overlay
3	log	Commit log with interactive rebase and cherry-pick
4	branches	Branch list — checkout, create, delete, merge, rebase, push
5	stacks	Stacked diff workflow (Graphite-equivalent)
6	stash	Stash list with preview
7	PRs	Pull requests — view, review, merge, comment, fullscreen diff
8	issues	Issues — browse, filter, create
9	actions	GitHub Actions workflow runs with watch and auto-refresh
0	remotes	Remote management and worktrees
n	notifs	Notifications — triage, mark read, batch ops
e	explore	Browse repos — My Repos, Trending, Search, local clone navigation
w	worktrees	Git worktree management — create, remove, prune, repair

Keybindings

Global

Key	Action
1–0, e, w, n	Switch view
Ctrl+Tab / Ctrl+Shift+Tab	Cycle views
Ctrl+H / Ctrl+L	Previous / next view
Ctrl+Z	Undo last git operation
Ctrl+O	Operations timeline overlay
Ctrl+R	Refresh current view
?	Help overlay
Ctrl+c	Quit

Status View

Key	Action
Space	Stage / unstage file
s	Stage selected hunk
S	Stage selected line
u	Unstage selected hunk
[ / ]	Navigate hunks
c	Commit
P	Push and create PR
b	Toggle blame overlay
V	Jump to PR for current branch

Log View

Key	Action
i	Enter interactive rebase mode
s	Squash (in rebase mode)
f	Fixup (in rebase mode)
d	Drop (in rebase mode)
e	Edit (in rebase mode)
r	Reword (in rebase mode)
Enter	Execute rebase
Esc	Cancel rebase
C	Copy commit to clipboard
V	Cherry-pick copied commits
/	Filter commits
v	Open containing PR in browser

Pull Requests View

Key	Action
r	Toggle fullscreen diff
m	Merge selected PR
a	Review (approve/request changes)
c	Add comment
R	Request reviewers
C	Checkout PR branch
n	Create new PR
f	Cycle filter (open/closed/all)
/	Filter by author

Explore View

Key	Action
m	Switch to My Repos tab
t	Switch to Trending tab
/	Search repos (focus input)
j/k	Navigate repo list
o/Enter	Open repo URL in browser
c	Clone or switch to local clone
f	Filter by language
d/w/m	Trending: daily / weekly / monthly
Tab	Switch focus between list & detail
Ctrl+R	Refresh current tab

Actions View

Key	Action
t	Trigger workflow
w	Toggle watch on selected run
Ctrl+L	Toggle auto-refresh
r	Re-run workflow

Stacks View

Key	Action
u/d	Navigate up/down in stack
t/b	Jump to top/bottom of stack
R	Rebase all dependents
s	Sync stack
p	Submit stack as PRs
a	Absorb staged changes

Worktrees View

Key	Action
n	Create new worktree
d	Remove worktree
p	Prune stale worktrees
r	Repair worktree
o	Open in terminal

Configuration

gubbi supports a YAML config file at ~/.config/gubbi/config.yaml:

theme: "github-dark"
pollInterval:
  notifications: 120000
  prs: 120000

dashboard:
  sections:
    - name: "My PRs"
      type: "pr"
      filters: { author: "@me", state: "open" }
    - name: "Needs Review"
      type: "pr"
      filters: { review-requested: "@me", state: "open" }

actions:
  - name: "Mark Ready"
    key: "R"
    command: "gh pr ready $PR_NUMBER"
  - name: "Auto-merge"
    key: "A"
    commands:
      - "gh pr review $PR_NUMBER --approve"
      - "gh pr merge $PR_NUMBER --auto --squash"

# Scan directories for local repo clones (used by Explore view's 'c' key)
repoScan:
  paths:
    - ~/code
    - ~/work
  maxDepth: 3

State is persisted at ~/.gubbi/state.json (filter preferences, operation history).

Architecture

gubbi/
├── app/
│   └── cli/                  # Entry point (bun + @opentui/solid renderer)
│       └── src/views/        # All application views
└── packages/
    ├── core/                 # State, query cache, config, operation log, icons
    ├── git/                  # git CLI wrappers + parser + hunk staging
    ├── github/               # gh CLI wrappers (PRs, issues, notifications, repos, actions)
    └── tui/                  # Shared components (Header, StatusBar, DiffViewer, BlameView, dialogs)

Stack:

• Bun — runtime and package manager
• SolidJS — fine-grained reactivity
• OpenTUI — terminal renderer with Yoga flexbox layout
• gh CLI — GitHub API access (no OAuth token needed)
• Turborepo — monorepo task runner

Features

Git + GitHub Integration

• PR context shown in every git view (status, branches, log)
• One-key workflow: Stage → Commit → Push → PR → Merge
• Multi-step progress toasts during push and PR creation
• Syncing indicator during background polling

Interactive Rebase

• Enter rebase mode with i on any commit
• Squash, fixup, drop, edit, reword with single keys
• Execute with Enter, cancel with Esc

Git Blame

• Toggle blame overlay with b in status view
• Shows commit hash, author, date for each line

Operation Log & Undo

• Ctrl+Z undoes last git operation (commit, push, etc.)
• Ctrl+O shows operations timeline

Worktree Management

• List, create, remove, prune, repair worktrees
• Open worktree in new terminal window

Explore & Local Clone Navigation

• Browse your repos, trending repos, and search GitHub repos
• c key clones a repo or switches to an existing local clone
• Configurable scan paths detect local clones (repoScan in config)
• Dashboard Enter on repos column opens Explore view

Inspirations

• lazygit — terminal git UI patterns
• gh-dash — GitHub dashboard in terminal
• Sapling — smartlog commit graph
• Magit — hunk staging and rebase UI

Contributing

This project is in early development. Issues and PRs are welcome.

# Install dependencies and build
bun install
bun run build:cli

# Dev mode (restarts on file change)
bun run dev:cli

# Lint
bun run lint

# Typecheck
bun run typecheck

License

MIT