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:

er-engine er-tui · feat/auth PR #42
feat/auth-refactor → main +42 −8 Local BranchPR Diff SplitUnified
Files · 7
●auth/login.rs⚠1
●api/handler.rs
●ui/panel.rs
●config.rs💬1
src/auth/login.rs · side-by-sideword diff
20pub fn login(self, user: &str)
21 self.check(user)
20pub async fn login(self, creds: Credentials)
21 self.check(creds).await
⚠ Securityinline thread · Ask AI ↗
Token TTL not checked — promote to comment?
BranchReviewNotes
CI checks
✓Build · Tests
⟳Deploy
Arena · last run
6 kept/ 14
⌘K commands· ⌘A select all· ⌘F diff search· d split ↔ unified· ⌘T terminal drawer
The desktop app — persistent tabs, a branch context bar with a Local ↔ PR toggle, a side-by-side split diff with intra-line word-diff highlighting, inline AI threads with “Ask AI” / “promote to comment”, and a four-tab right panel (Branch · Review · Notes · Context).
RegionPurpose
Tab strip (top)Open repos, branches, and PRs as tabs. Drag to reorder, middle-click to close, jump with Cmd+1…9.
Branch context barCurrent branch, base comparison, PR number, change summary, and a Local Branch ↔ PR Diff toggle.
Left sidebarCollapsible 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 panelFour 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):

Cmd+A is native select-all again (including in the embedded browser).

What the desktop adds over the terminal

CapabilityDesktopTerminal
Split-mode (side-by-side) diffYesConfig hub (off by default)
Intra-line word-diff highlightingYes—
Embedded terminal drawerYes—
Embedded browser + page annotationsYes—
Multi-model review arenaFull UI (bracket / matrix / funnel)—
Settings as a GUIYesOverlay + TOML
Persistent, drag-to-reorder tabsYesSession tabs
Reference “find usages” popoverYes—
Export review to markdownPreview + copy/saveShift+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.