prtea

Terminal PR dashboard with AI-powered review

Language
Go
Version
0.6.0
License
MIT
Category
Dev Tool
View on GitHub

A three-panel TUI built with Bubbletea for reviewing GitHub PRs without leaving the terminal. Browse PRs, read diffs, and chat with an AI sidekick powered by the Codex CLI about the changes — with hunk selection to focus the conversation, a review basket that batches inline comments into one submission, CI status, and a live feed of what the agent is actually doing.

Preview

>_

Features

01

Three-panel layout — PR list, diff viewer and AI chat side by side, each toggleable and zoomable

02

AI sidekick — press a for a "what is this PR, what's risky, where do I look" overview, then keep asking

03

Live activity feed — watch the commands and reasoning the agent runs, message by message, rather than waiting on a spinner

04

Safe by design — the agent runs in a read-only sandbox with no network, and any GitHub action it proposes executes only after you confirm it in the TUI

05

Hunk selection — pick specific diff hunks to focus the conversation on what actually matters

06

Review basket — draft inline comments on diff lines, see them queued in the Review tab, and submit them with your verdict as one review

07

CI status tab with check results grouped by status

08

Per-reviewer approval breakdown with visual badges

09

Comments with full markdown rendering, and review threads that show their resolved state

10

Custom per-repo review instructions, so the AI context matches the codebase

11

Search in diff with /, navigate matches with n and N

12

Command palette — Ctrl+P for quick commands, : for full mode with autocomplete

13

Real session resume — a conversation picks up where you left off, resuming the codex session rather than replaying history

14

Vim-style navigation — j/k, Ctrl+d/u, g/G, and modal editing in chat

15

Demo mode — 6 fictional PRs with realistic diffs, comments, CI and a scripted AI engine; no gh or codex needed, writes disabled

Install

Homebrew

>_ 
$ brew install shhac/tap/prtea

GitHub Release (macOS)

>_ 
$ curl -L https://github.com/shhac/prtea/releases/latest/download/prtea-darwin-arm64.tar.gz | tar xz

Build from Source (needs Go 1.25+)

>_ 
$ git clone https://github.com/shhac/prtea.git && cd prtea && make build

Getting Started

prtea drives two external CLIs: gh for everything GitHub, and the Codex CLI for the AI sidekick. gh is required; codex is optional — without it prtea is still a full diff viewer and review tool.

01 · Install and authenticate the GitHub CLI

>_ 
$ brew install gh && gh auth login

Required. prtea uses gh to fetch PRs, diffs, comments and CI, and to submit reviews.

02 · Install the Codex CLI (optional)

>_ 
$ brew install codex

Enables the AI overview and chat; sign in with your ChatGPT account. Without it, everything except the AI panel still works.

03 · Try it with no prerequisites at all

>_ 
$ prtea --demo

Six fictional PRs with a scripted AI engine — no gh, no codex, and write operations disabled.

04 · Launch it for real

>_ 
$ prtea

Run from any directory. The PR list loads your review requests and authored PRs. Press ? for the full keybinding reference.

Usage

>_ Launch the dashboard 
$ prtea
>_ Explore with no auth needed 
$ prtea --demo
>_ Check your installed version 
$ prtea --version