Terminal UI (TUI)

Experimental native Rust review UI and read-only viewer.

Experimental. Interface, keymap, and on-disk mode: "tui" details may change in a minor release. The web UI is the supported path for production workflows.

Two surfaces

CommandRole
diffing view / --viewFocused read-only native diff browser (ergonomic git diff)
diffing --tuiFull review: comments, handoff, agent loop in-terminal
diffing mode tuiMake full TUI the interactive default

Native binaries ship via optional platform packages on npm install. Fallbacks: source build under crates/diffing-tui, or a diffing-tui on $PATH.

diffing view
diffing --tui
diffing mode tui
diffing mode web     # restore web default

Behavior notes

  • Shares sparse diff index ideas with headless inspect tools
  • Publishes a capability-scoped loopback API through the session registry
  • Web and TUI can run concurrently for the same repo
  • Read-only viewer does not register a full review session
  • Mouse capture configurable (tuiMouseEnabled in settings)

Build from source

pnpm build:tui
# or
cargo build --release --manifest-path crates/diffing-tui/Cargo.toml

Design

TUI chrome follows Gridline — same semantic roles as the web adapter.