A fast, keyboard-driven GitHub CLI tool.

• TUI Fuzzy Finder - Quickly search and browse your GitHub repositories and organizations from the terminal
• Local Caching - SQLite database stores GitHub data with usage tracking for smart scoring
• Quick Navigation - Open GitHub pages directly from your git repository (issues, actions, settings, milestones)
• GitHub Actions Monitoring - Watch running or recent GitHub Actions for the current repo/branch

You can install it from my Homebrew Tap with:

brew install frankwiles/tools/gg

or build and install it with cargo

cargo install gg-github

Or download a pre-built binary for your OS from our releases.

Set your GitHub Personal Access Token:

export GITHUB_TOKEN="ghp_..."

Or use the --token flag with any command.

Before using the TUI for the first time, you need to populate your local cache with your GitHub organizations and repositories:

gg data refresh

This command fetches all your orgs and repos from the GitHub API and stores them locally for fast searching.

Generate shell completion scripts for your shell:

# For bash
gg completions bash > ~/.local/share/bash-completion/completions/gg
# or (for macOS with Homebrew)
gg completions bash > $(brew --prefix)/etc/bash_completion.d/gg

# For zsh
gg completions zsh > ~/.zsh/completion/_gg
# then add to your ~/.zshrc:
# fpath=(~/.zsh/completion $fpath)
# autoload -U compinit && compinit

# For fish
gg completions fish > ~/.config/fish/completions/gg.fish

# For PowerShell
gg completions powershell | Out-File -Encoding ASCII ~/.config/powershell/completions/gg.ps1

# For elvish
gg completions elvish > ~/.elvish/lib/gg.elv

Run gg without a sub-command or gg tui if you want to be more explicit and it will launch a TUI with fzf-like fuzzy-finding that is lightening quick even with hundreds of repos in dozens of orgs.

1. Type to search through your repos quickly
2. Move the cursor with your arrow keys to the exact repo you need
3. Press enter and it opens https://github.com/<owner>/<repo>/ by default.

You can use these key combos to go more directly to what it is you need:

Esc or Ctrl+d will exit.

Launches the TUI fuzzy finder for browsing cached repositories.

Explicitly launch the TUI fuzzy finder.

Data management commands.

gg data refresh
gg data status
gg data clear
gg data export
gg data reveal

Open the current repository's Issues page in your browser.

Open the current repository's Actions page in your browser.

Open the current repository's Settings page in your browser.

Open the current repository's Milestones page in your browser.

Open the current repository's Pull Requests page in your browser.

Open the currently running or most recently completed Github Action for the current branch.

gg watch action

TODO: Raycast extension integration.

MIT

Frank Wiles