Desktop App
Desktop App Overview
The desktop app is a graphical front end for the same review engine the terminal uses. It trades the terminal's instant, minimal feel for a richer surface: split diffs, an embedded terminal and browser, a multi-model review “arena”, point-and-click settings, and persistent tabs. Everything shared with the terminal is covered under Core Concepts; this section is the desktop-specific parts.
The desktop app is in active development. Apple Silicon Macs can install a signed,
notarized .dmg from a release; other platforms are built from source. Details such as exact keyboard
shortcuts may change. See Installation for both.
How it relates to the terminal app
Same engine, same data. The desktop app reads and writes the same review files per repository, branch, and view, so a review started in the terminal continues in the desktop app and vice versa. The mental model — diff modes, watch mode, reviewed marks, questions vs GitHub comments, AI sidecars and staleness — is identical. What differs is the presentation and a set of features only a GUI can offer.
The layout
The window is organized into several regions:
| Region | Purpose |
|---|---|
| Tab strip (top) | Open repos, branches, and PRs as tabs. Drag to reorder, middle-click to close, jump with Cmd+1…9. |
| Branch context bar | Current branch, base comparison, PR number, change summary, and a Local Branch ↔ PR Diff toggle. |
| Left sidebar | Collapsible file tree with search, plus a project / branch / PR picker for switching context. |
| Diff view (center) | Unified or split diff with inline threads, AI findings, and intra-line word-diff highlighting. |
| Right panel | Four tabs — Branch (git/PR status and GitHub comments), Review (AI findings, summary, arena history), Notes (questions and local notes), and Context (Mermaid diagrams of the diff). |
| Browser (optional) | An embedded webview for docs, design systems, or APIs, with an annotation mode. |
| Terminal drawer (bottom) | A resizable embedded shell for running commands without leaving the app. |
Command surfaces
Everything is reachable from the command palette (Cmd+K):
- Top level — navigation, PR actions (including the arena), settings, export, and files in the current diff. Letter shortcuts jump to items. Press / (or choose Focus search) to type a filter. Search is not focused on open.
- AI submenu — run a review, triage, professor, generate a tour or diagrams, pick a provider and model, choose specialized reviewers, validate findings, and more. Letter shortcuts and arrow keys work inside nested menus.
Cmd+A is native select-all again (including in the embedded browser).
What the desktop adds over the terminal
| Capability | Desktop | Terminal |
|---|---|---|
| Split-mode (side-by-side) diff | Yes | Config hub (off by default) |
| Intra-line word-diff highlighting | Yes | — |
| Embedded terminal drawer | Yes | — |
| Embedded browser + page annotations | Yes | — |
| Multi-model review arena | Full UI (bracket / matrix / funnel) | — |
| Settings as a GUI | Yes | Overlay + TOML |
| Persistent, drag-to-reorder tabs | Yes | Session tabs |
| Reference “find usages” popover | Yes | — |
| Export review to markdown | Preview + copy/save | Shift+E → clipboard |
| Mermaid diagrams (Context tab) | Yes | — |
| Keyboard-driven, zero-dependency, instant start | — | Yes |
Each of these is covered in depth on the next page.
Working beside an AI assistant
The desktop app supports the same live loop as the terminal: watch mode keeps the diff current while an assistant edits, stages, and commits. The embedded terminal drawer means the assistant can run inside the app — open Claude Code in the drawer, review its changes in the diff above, and drop questions or notes inline as they come up. Run reviews from the command palette (Cmd+K → AI); findings and triage land in the Review tab, Mermaid diagrams in Context, and a generated tour turns the diff into its Guide mode.
Running it
# development shell with hot reload
./scripts/tauri-dev.sh
# with extra logging (e.g. the review arena)
./scripts/tauri-dev.sh --logs arena
# build a release bundle (.app on macOS; a .dmg is produced when ER_SKIP_DMG=0)
./scripts/tauri-build.sh
Next: Features in Depth walks through the arena, browser annotations, terminal drawer, export, references, and the desktop keyboard shortcuts.