Skip to content
mxr

TUI

Screens

Section titled “Screens”

The TUI has six top-level screens:

  • Mailbox (1)
  • Search (2)
  • Rules (3)
  • Accounts (4)
  • Diagnostics (5)
  • Analytics (no digit; open via Ctrl-p → “Analytics”)

Open the first five with 1-5. Analytics has no default digit key today — open it from the command palette (Ctrl-p then type “Analytics”) or rebind the open action in keys.toml next to the file printed by mxr config path (see Custom keybindings).

Discoverability

Section titled “Discoverability”

Three places to find a key without memorising:

  • ? opens the help modal — context-aware, shows every key bound in the current view.
  • Ctrl-p opens the command palette — fuzzy-matches every action by name.
  • The hint bar at the bottom of every screen surfaces the most relevant shortcuts for the current selection.

The keybindings reference page lists every default; the help modal is faster while you’re using the TUI.

Mailbox screen

Section titled “Mailbox screen”

Layout:

  • Sidebar
  • Mail list
  • Message or thread pane

Behavior:

  • Thread-first list by default
  • Optional message-list mode
  • Focused-thread-message targeting for reply and mutations
  • Explicit right-pane dismissal with Esc
  • Bulk selection with confirmation modals
  • Sidebar lenses replace the mail list in place: Subscriptions, Owed replies, and Calendar invites (every detected invite with inline RSVP — see keybindings)

Thread summaries

Section titled “Thread summaries”

Press y or run Ctrl-p → Summarize Thread from the mailbox, message, or thread view. The LLM request runs in the background, so navigation, body loads, and other mail actions keep working.

Cached summaries appear above the message body when a thread opens. If a long uncached thread is worth summarizing, the TUI may also start the same background request after a short debounce. While it runs, the message pane shows a Summary block with a refreshing state; when it finishes, the Markdown summary replaces that loading text. The CLI equivalent is:

Terminal window
mxr summarize THREAD_ID

Search screen

Section titled “Search screen”
  • Fixed query input at the top
  • Result list on the left
  • Preview pane on the right
  • Live search against the full local index
  • Ctrl-f is separate and only filters the current mailbox
  • Enter, o, or l opens the selected result in preview
  • Esc moves preview -> results -> mailbox

Rules screen

Section titled “Rules screen”
  • Rule list on the left
  • Guided workspace on the right
  • Overview, history, dry-run, and edit states
  • Textarea-driven condition/action editing for supported rule fields

Diagnostics screen

Section titled “Diagnostics screen”
  • Status summary
  • Doctor output
  • Recent events
  • Recent logs
  • Bug-report generation
  • Config edit and log-open shortcuts from inside the page

Accounts screen

Section titled “Accounts screen”
  • Details on the left
  • Runtime account list on the right
  • Add IMAP/SMTP account
  • Test connectivity
  • Set default account
  • Edit config without leaving the TUI
  • Inspect runtime-only accounts such as browser-auth Gmail setups

Analytics screen

Section titled “Analytics screen”

Same surface as the CLI analytics commands (mxr storage, mxr contacts, mxr stale, mxr response-time, mxr subscriptions, mxr wrapped), without leaving the TUI. Cycle views with Tab / Shift-Tab; refresh the active view with r.

Six views:

  • Storage — sender / mimetype / label rollups (m toggles to Largest Messages mode; g cycles group_by while in Breakdown).
  • Stale Threads — threads waiting on a reply (p toggles perspective, [/] adjusts older_than_days, {/} adjusts within_days).
  • Contacts — asymmetry vs decay (m toggles sub-mode, R refreshes the materialized contacts table).
  • Response Time — reply-latency percentiles (d toggles direction).
  • Subscriptions — list-sender ROI table (o toggles open-rate ranking; u opens the unsubscribe-confirm modal for the selected row).
  • Wrapped — Spotify-style yearly summary as a 7-tile dashboard grid (h/j/k/l move between tiles, y/Y step year, t cycles window kind: YTD → Year → SinceDays).

Two cross-view interactions:

  • Enter drills down. Storage senders/labels and Contacts emails jump to a Search filter; Stale Threads, Largest Messages, and Subscriptions rows open the underlying conversation directly via Request::GetEnvelope (no search round-trip).
  • f opens the filter modal — a per-view form with all CLI flags exposed as editable fields. Tab/Shift-Tab to navigate, Enter to apply, Esc to cancel.

Modals and overlays

Section titled “Modals and overlays”
  • Command palette
  • Help modal
  • Label picker
  • Compose confirmation — [s] sends, [a] schedules send-later, [n] sends and sets a follow-up reminder, [d] saves a draft, [r] refines, [e] reopens $EDITOR, Esc discards
  • Bulk confirmation
  • Attachment modal
  • Snooze modal — preset list plus a Custom… entry that opens a text prompt parsed by the same in 2h / tomorrow 9am / monday 17:00 / RFC3339 grammar as mxr snooze --until
  • Unsubscribe confirmation
  • Analytics filter modal
  • Reply-later queue browser — list of flagged messages and due reminders, opened with Ctrl-p → Reply Queue; cancel a pending reminder from the focused sent message with Ctrl-p → Cancel Reminder
  • Snippets browser — read-only list with body preview; CRUD flows through mxr snippets
  • Sender profile — volume, cadence, open commitments, and other recent emails from the focused message’s sender, opened with Ctrl-p → Sender View. Inside the modal, j / k selects another email and Enter / o opens it.
  • Screener queue — triage list with a/d/f/p disposition keys (allow / deny / feed / paper-trail) wired to Request::SetScreenerDecision
  • Welcome / setup — first-launch modal with d (demo), g (Gmail), i (IMAP) shortcuts; Enter opens the new-account form
  • Doctor findings — surfaced inside the Diagnostics Status pane with per-finding glyph (✗ / ! / ·), category, message, and indented remediation commands

Mailbox semantics

Section titled “Mailbox semantics”
  • Actions in thread view target the focused message
  • Labels appear in message headers
  • Attachment indicators appear in the mail list and message/thread header
  • Thread counts are styled separately from sender names
  • Label and saved-search scopes drive the mail list header and query state
  • Message bodies are fetched through bulk ListBodies reads and should already be cached from sync. The TUI does not use body preview as a provider repair path.
  • Mailbox mutations are optimistic. Transient IPC/database failures get bounded retry while the optimistic UI stays in place; explicit mutations surface an error after retries are exhausted. Preview auto-mark-read is best-effort and reconciles quietly.

Discovery model

Section titled “Discovery model”
  • First-run onboarding walkthrough
  • Command palette: broad action surface
  • Help modal: context-aware keybinding reference
  • Hint bar: context-sensitive shortcuts, including selection-aware actions
  • gc: edit config globally