A terminal dashboard for reviewing GitHub PRs with AI-powered analysis.

Website: prtea.paulie.app

Three-panel TUI built with Bubbletea: browse your PRs, read diffs, and chat with Claude about the changes — all without leaving the terminal.

• Three-panel layout — PR list, diff viewer, and AI chat side by side with toggleable panels and zoom
• AI-powered analysis — one-key PR analysis with risk assessment, architecture impact, and line-level comments
• Interactive chat — ask Claude questions about the PR with streaming markdown responses and hunk-specific context
• Hunk selection — select specific diff hunks to focus AI chat and analysis on what matters
• Review submission — approve, request changes, or leave review comments with an integrated Review tab
• CI status — dedicated tab showing check results grouped by status
• Review status — per-reviewer approval breakdown with visual badges
• Comments — read and post PR comments with full markdown rendering
• Custom prompts — per-repo review instructions for tailored analysis
• Search in diff — / to search, n/N to navigate matches with highlighting
• Command palette — Ctrl+P for quick commands, : for full mode with autocomplete
• AI review generation — AI-powered inline review comments rendered on diff lines
• Chat persistence — chat sessions saved to disk and restored when revisiting PRs
• Vim-style navigation — j/k, Ctrl+d/u, g/G, and modal editing in chat

• GitHub CLI (gh) — authenticated with gh auth login
• Claude Code (claude) — optional, required for AI analysis and chat

For releasing: gh CLI and access to the ../homebrew-tap sibling repo.

brew install shhac/tap/prtea

Download from the releases page, extract, and add to your $PATH.

Requires Go 1.25+.

git clone https://github.com/shhac/prtea.git
cd prtea
make build

The binary is written to bin/prtea. Move it somewhere on your $PATH:

cp bin/prtea /usr/local/bin/

prtea

Check your installed version with prtea --version.

Launch from any directory. The PR list loads your review requests and authored PRs from GitHub.

Try prtea without any prerequisites:

prtea --demo

Demo mode loads 6 fictional PRs with realistic diffs, comments, CI statuses, and reviews. No gh or claude CLI needed. Write operations (approve, comment, submit review) are disabled; AI features require the claude CLI.

Typical workflow:

1. Browse PRs in the left panel — switch between "To Review" and "My PRs" tabs with h/l
2. Press Enter to select a PR and jump to the diff viewer
3. Navigate the diff with j/k, jump between hunks with n/N
4. Press a to run AI analysis, or select specific hunks with s and press Enter to chat about them
5. Switch to the Review tab with l and submit your review (approve, comment, or request changes)

Press ? at any time to see the full keybinding reference.

Config file location: ~/.config/prtea/config.json

{
  "claudeTimeoutMs": 120000,
  "pollIntervalMs": 60000
}

Add per-repository review instructions by creating markdown files in ~/.config/prtea/prompts/:

~/.config/prtea/prompts/{owner}_{repo}.md

These are automatically included when analyzing PRs for that repository.

go test ./...

Tests cover pure functions (panel layout, CI status computation, diff parsing, review deduplication) and mock-based GitHub client methods using injectable CommandRunner. No external services or gh CLI needed for tests.

Releases are done manually via scripts and gh CLI. Use the /release command in Claude Code, or follow the steps in .claude/commands/release.md.

Quick overview:

sh scripts/release.sh patch      # bump version, tag, push
sh scripts/build-release-assets.sh  # cross-compile + tarballs + checksums
gh release create v<VERSION> release/*.tar.gz release/checksums-sha256.txt --title "v<VERSION>"

Then update the Homebrew formula in ../homebrew-tap/Formula/prtea.rb.

cmd/prtea/main.go        Entry point (--version, --demo flags)
internal/ui/              Bubbletea UI layer (panels, layout, styles, keys)
internal/github/          GitHub API client (gh CLI based, with CommandRunner injection)
internal/claude/          Claude CLI subprocess (analysis + chat + caching)
internal/demo/            Demo mode mock service (in-memory fake data)
internal/config/          Config file management
internal/notify/          Desktop notifications

MIT