A fast, keyboard-driven terminal UI for browsing and managing GitHub Pull Requests.

Built with Bubble Tea and the GitHub CLI.

• 🔍 Powerful Search - Search PRs with GitHub's query syntax
• 📑 Multiple Tabs - Browse multiple PRs and searches simultaneously
• ⌨️ Vim-style Keys - Navigate efficiently with familiar keybindings
• 📝 Full PR Management - Comment, approve, request changes, merge
• 👥 Team Collaboration - Add reviewers and assignees
• 💾 Saved Searches - Save frequently used searches to config
• 🎨 Rich Rendering - Markdown support, syntax highlighting, colored diffs
• 🔄 Live Updates - Refresh PRs and searches on demand

• GitHub CLI (gh) - Must be installed and authenticated
• Go 1.21+ (for installation)

go install github.com/dbd/ght@latest

This installs the ght binary to $GOPATH/bin (usually ~/go/bin).

Standard Go installation: Make sure $GOPATH/bin is in your PATH:

export PATH="$HOME/go/bin:$PATH"

If using asdf: Add asdf's Go packages bin to your PATH:

export PATH="$HOME/.asdf/installs/golang/$(asdf current golang | awk '{print $2}')/packages/bin:$PATH"

git clone https://github.com/dbd/ght.git
cd ght
go build
./ght

1. Authenticate with GitHub CLI (if not already done):

   gh auth login

2. Configure your searches in ~/.config/ght/config.yaml:

   pr:
     searches:
       - name: "My PRs"
         query: "is:pr author:@me"
       - name: "Review Queue"
         query: "is:pr review-requested:@me"
       - name: "Team PRs"
         query: "is:pr org:yourorg is:open"

3. Launch ght:

   ./ght

Press : to enter command mode. Available commands:

Configuration file location: ~/.config/ght/config.yaml

pr:
  searches:
    - name: "My Open PRs"
      query: "is:pr author:@me is:open"
    
    - name: "Needs My Review"
      query: "is:pr review-requested:@me is:open"
    
    - name: "Recently Updated"
      query: "is:pr is:open sort:updated-desc"
    
    - name: "Assigned to Me"
      query: "is:pr assignee:@me is:open"

Use GitHub's advanced search syntax for powerful queries:

• is:pr - Pull requests only
• is:open / is:closed / is:merged - PR state
• author:username - PRs by author
• author:@me - Your PRs
• review-requested:@me - PRs requesting your review
• assignee:username - PRs assigned to user
• org:orgname - PRs in organization
• repo:owner/repo - PRs in specific repo
• label:bug - PRs with label
• sort:updated-desc - Sort by update time

Full search syntax documentation

1. Start ght and select "Review Queue" tab
2. Browse PRs with j/k
3. Press Enter to view PR details
4. Read diff and comments
5. Press a to approve, or x to request changes
6. Enter your review message and press Ctrl+S
7. Press q to close tab and return to queue

From any PR detail view:

:comment Great work! LGTM 🚀

Or use the dialog:

1. Press C
2. Type your comment
3. Press Ctrl+S to submit

1. Open PR detail
2. Press m or type :merge
3. Select merge method (merge commit, squash, rebase)
4. Confirm with Ctrl+S

Quick command:

:add-reviewer username

Or use dialog:

1. Press r
2. Enter username
3. Press Enter

├── main.go                  # Entry point
├── update.go                # Root update handler
├── view.go                  # Root view + header/footer
├── commands.go              # Command mode handlers
├── components/
│   ├── types.go             # Page interface, command types
│   ├── keys.go              # Key bindings
│   ├── styles.go            # Lipgloss styles
│   ├── config.go            # Configuration management
│   ├── mergeDialog.go       # Merge dialog component
│   ├── reviewDialog.go      # Review dialog component
│   ├── inputDialog.go       # Input dialog component
│   ├── helpDialog.go        # Help dialog component
│   ├── pullRequestSearch/   # PR list/search component
│   ├── pullRequestDetail/   # PR detail view + diff
│   └── tab/                 # Tab wrapper component
├── internal/api/
│   ├── pullrequest.go       # GitHub API calls
│   └── types.go             # API response types
└── utils/
    └── gitDiffParse.go      # Git diff parser

# Run main application
go run .

# Run dev utilities
go run ./cmd/pr      # PR diff rendering test
go run ./cmd/query   # API query test

See AGENTS.md for detailed development documentation.

Use :newtab to create a new search tab, enter your query with /, then save it with :save-tab "My Custom Search".

In your PR list, press / and type the PR number to quickly filter.

Use with tmux or screen:

• Ctrl+Z suspends ght to shell
• fg returns to ght
• Or run in dedicated tmux pane

Comments support full markdown syntax:

:comment ## Summary

This PR looks great!

- [x] Code reviewed
- [x] Tests passing
- [ ] Documentation updated

Install and authenticate GitHub CLI:

# Install (macOS)
brew install gh

# Install (Linux)
# See https://github.com/cli/cli/blob/trunk/docs/install_linux.md

# Authenticate
gh auth login

Ensure config file exists:

mkdir -p ~/.config/ght
touch ~/.config/ght/config.yaml

GitHub CLI uses your authenticated token. Check rate limits:

gh api rate_limit

Contributions welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

MIT License - see LICENSE file for details

• Built with Bubble Tea TUI framework
• Uses Lipgloss for styling
• Uses Glamour for markdown rendering
• Powered by GitHub CLI