Skip to content

TUI

Terminal window
MXR_DAEMON_ADDR='cmd://ssh -T host mxr daemon dial-stdio' mxr

The TUI uses the same MXR_DAEMON_ADDR selection as the CLI and stdio MCP: unix://, cmd:// or authenticated loopback tcp://. A remote mailbox loads even when the client has no local accounts. Editors, file pickers and attachment destinations remain on your client.

Remote connection setup authenticates TCP before status, finishes within five seconds and requires the same IPC protocol version as the client (protocol_version in mxr status --format json). Package/build differences are accepted remotely; missing or unsupported protocol and connection failures do not start or query a local daemon. Account setup and credential/config maintenance through remote selections are unsupported; run them on the daemon host.

The session retains its first workspace owner across background requests, reply prewarm, archive previews and reconnect. If the selected workspace changes, private drafts, attachments and pending outcomes remain under their original owner. Return to that workspace to recover them. A failed initial owner lookup requires explicit reopen before private work can continue.

The TUI has seven top-level screens. Tools open with g and a capital:

  • Mailbox (gi)
  • Search (/)
  • Rules (gR)
  • Accounts, where the TUI’s settings live (gC)
  • Diagnostics (gD)
  • Analytics (gA)
  • Deliveries (gP)

The command palette (: or Ctrl-k) opens each by name too. Rebind the keys in keys.toml next to the file printed by mxr config path (see Custom keybindings), or with mxr keys set or the web app’s Settings → Keyboard, which change both clients. With single_keys = false a character typed on its own does nothing outside text fields and open menus; Ctrl-k opens the palette, and help says the switch is off. Restart the TUI to load changes. Mail lists, single-message readers and multi-message threads each have their own binding section. Help, the palette and mail-pane hints use those effective keys; typing in a search or compose field still enters text.

Four places to find a key without memorising:

  • ? opens the help modal, which shows every key bound in the current view.
  • A pause after a prefix. Press g, * or i and wait 300 ms: a box above the status bar lists the keys that can follow here, your keys.toml changes included. Typing the next key sooner never shows it. The prefix waits four seconds for its next key, and Esc cancels it.
  • : (or Ctrl-k) opens the command palette, which fuzzy-matches every action that works where you are, by name, with all of its keys there (your keys.toml remaps included). The first time you run an action that has a key from the palette, a toast names the key: Catch-up. Next time: 2. That shows once per action on your profile, shared with the web app.
  • 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.

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
  • Press F in an open message to fill the main mail area; the sidebar and message list hide. Press F again for split view, or Esc to return to the list.
  • Bulk selection with confirmation modals
  • In a thread, J and K move between messages. o folds the focused message to one line (who, when, how it starts) and opens it again; ; folds every message but the newest and the unread ones, and opens them all when pressed again. The reading and HTML views fold quoted text, and Q shows it. Plain text (R off) shows every quoted line.
  • ] archives the open conversation and then opens the next one; [ opens the previous one. It is the list’s archive, with its confirm for a multi-message thread and u to undo, and the reader moves only once the archive is done.
  • An open message shows when it arrived in your local time, never UTC and never a day alone: Today 14:02 · 2h ago for today’s mail, Tue 21 Oct 14:02 for earlier mail this year, and Tue 21 Oct 2025 14:02 after that. The same wording heads each message in Messages and Reading. List rows keep the compact form.
  • The sidebar opens Now, Messages, To do, Updates, Reading, Archive and Inbox. Additional views include Screener, Reply queue, Waiting on, Snoozed and Subscriptions.

In a list that mixes accounts, each email row shows its account as a coloured tag chip just before the date. A list scoped to one account, or an install with one enabled account, shows no chips. The reader header always names the account the message came to.

Press gh for Now, the front page of people waiting on you, tasks due soon, the Updates digest and an evening Reading pick. Open a row to continue in its mode: Enter on a person opens Messages on that conversation, and r, a and f reply, reply all and forward. o opens the email itself, full width, since the modes draw no reader beside their list; Esc comes back to the mode. gm opens Messages, gx opens To do, and ge opens Archive. In To do, Space opens the lit row’s details under it, as the web app’s do: its dates, why it is here, the email’s first lines and where each field came from. Space again or Esc closes them.

mxr desk remains available from the CLI for the full You owe, Due, Waiting on and New from people lanes. See the keyboard reference for navigation keys.

Focus & reply (gF) is the web app’s queue of everyone you owe a reply, one conversation at a time: the desk’s You owe lane, then the reply-later queue. It shows why the conversation is here and its newest message from them. r writes the reply in $EDITOR, and Send in the review moves on to the next one; j skips, e is Done, b is Not now and d drafts in your voice; sending with a reminder is in the palette. Esc or q goes back to where you opened it (Reply to everyone you owe). The keys are in the keybindings reference.

Updates (gu) is the briefing lens: the latest digest in Needs a look, Changed and Routine, one line per source, with what arrived after the cut below it (Read Updates as a briefing). E lets go of the digest after a preview, e lets go of one source, t makes a to-do from a line, P tunes the source, L opens the line’s link and o the email. Space opens the lit line’s details under it, as the web app’s peek does: the whole fact when the row cuts it, when the latest email arrived and its first lines, why the update is here, the numbers the mail quoted, a tracker’s state, a parcel’s items and references, and where L and o go. Space again or Esc closes them. The keys are in the keybindings reference.

g n opens Snoozed: snoozed mail, waking soonest first, one row per conversation, with the wake time where the date usually is and “Back Fri 31 Oct, 09:00” in place of the snippet. It is a mail list, so Enter opens the message and the list’s keys act on the lit conversation. w wakes it now: every snoozed message in the conversation goes back to the inbox. b sends it away again. mxr snoozed and mxr unsnooze do the same from the CLI.

Reading (gr) is the edition: the bands, a reader, the tabs 1 Edition, 2 Later and 3 Highlights, and " to highlight the paragraph at the top of the reader. Its keys are in the keybindings reference.

Paper trail is a lens (Clear Reading and Paper trail). Mail is bundled by sender, each bundle with its “here because” line and no unread count. From a bundle, s pins a message, P moves the sender to another place and E sweeps the whole place; sweeping one sender’s bundle and loading more senders, or more of one sender’s messages, are in the palette (:). They were p, K, A, S, > and + until K3. Every sweep shows its preview first; the whole-place sweep opens on Cancel, so confirming it takes a deliberate extra step. Undo reverses every chunk of the last sweep. Mail keys (archive, star, trash) act on the message under the cursor. The keys are in the keybindings reference.

Archive (ge) is a records lens: receipts, orders, bookings, bills and documents, one row per record (Archive). The answer box sits at the top; / focuses it and Enter asks, and the answer card shows the field, where it came from and whether it is checked. Below it are the “Coming up” lines and the ledger by month, each month with its count and totals; ·? marks an amount nobody has confirmed. Enter on a row opens the record’s document, and the record card shows every field with its source. ? explains the mode; the first time the cursor reaches the first record, or an answer appears, a one-line hint in the status line names its key, and Esc dismisses it for good. On a conversation, X then e files it as a record; Pass to a mode in the palette shows the card first. The keys are in the keybindings reference.

Mailbox Archive is a separate provider action. Open the command palette with : and choose Preview Archive selection for the selected messages. The palette also lists query and submit commands for retained operation IDs. After a lost response, query the same ID. Submitting that ID can resume only pending items; an unknown effect is not repeated. This does not file a record in Archive or invoke the desk’s Done action.

When a thread opens, the message pane leads with its context: the gist and what they ask of you (with the quoted sentence) when a model is configured, then who the thread is with and how you know them, whether you owe a reply, open promises both ways, and which model wrote the gist. The facts arrive at once; the gist waits out a short debounce so scrolling through the list does not ask the model about every row. The CLI equivalent is mxr briefing context THREAD_ID.

Run : → 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
  • 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 → opens the selected result in preview
  • Esc moves preview -> results -> mailbox
  • 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
  • Status summary
  • Doctor output
  • Recent events
  • Recent logs
  • Bug-report generation
  • Config edit and log-open shortcuts from inside the page
  • Details on the left
  • Runtime account list on the right
  • Add IMAP/SMTP account
  • Test connectivity
  • Set default account
  • Edit an account’s colour and tag with i; the first Enter previews, the next saves
  • Edit config without leaving the TUI
  • Inspect runtime-only accounts such as browser-auth Gmail setups

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; b 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.

Every overlay’s keys are in the generated keybindings tables, and help (?) lists them too.

  • 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] opens a writing proof for the current body, [e] or Esc reopens $EDITOR on the draft, and [#] discards it. When the safety check returns an override token, [O] overrides that block and sends once; a gap block has no override. A bare Enter runs the option marked ›: Send, or Edit again when the safety check found something or the draft can’t go as it is. When it suggests someone to copy in, [c] adds the first suggestion to Cc (Ctrl-a says where it went until 0.6.225).
  • Drafts (g d): Enter opens the selected draft in $EDITOR, as r does for a conversation’s unsent reply in Messages. Closing the editor saves your changes to that draft and opens the compose confirmation for it. [s], [a] and [n] send it, schedule it or send it with a reminder, [d] keeps it as a draft, and [e] or Esc reopens it in $EDITOR. The confirmation doesn’t offer [#] or [r] for a saved draft: delete it from the Drafts list, and edit it to change its text.
  • Writing proof: additions are highlighted and removals are struck through; set NO_COLOR to show [-removed-]{+added+} marks. Gap ranges use the warning style, and the warning says sending remains blocked. Esc keeps the original draft, as q does. Model selection opens the daemon’s compose catalogue before the first proof and from [m] in the proof; unavailable entries show why they cannot run. [y] or Enter accepts the selected proposal, [e] accepts and opens $EDITOR, [n] enters a revision note, and ←/→ select proof versions. Arrow keys or j/k scroll; PageUp/PageDown and Home/End move farther. [o] opens the next cited voice example in the reader. Scroll with arrows or PageUp/PageDown; Esc returns to the same proof. Each proof starts its example cycle at the first source. These are the default bindings; user remaps remain authoritative. Accepting a proof with gaps lets you fill them in the editor; send safety still blocks sending until they are filled.
  • Bulk confirmation
  • Attachment modal
  • Not now (b): Later with no time first, then the presets on 1–4, then a Custom… entry that opens a text prompt with a live preview of the resolved time, using the same time phrases as mxr snooze --until. Later is the reply queue in mail and Messages and the Later shelf in Reading; a time snoozes the email, takes a Messages conversation off until then, or schedules a to-do. j and k, the arrows, or Ctrl-n and Ctrl-p move, as in the web app’s Not now. Z says where it went until 0.6.197.
  • Move to (X): a lowercase letter moves this email to a mode, a capital moves the sender, and the mode it is in now says “here now”; on Now it also answers a Not-sure question and a new sender’s question (D blocks). T and the new-sender digits say where they went until 0.6.197. Tab switches between readings of an ambiguous phrase such as fri 3; the send-at and remind prompts work the same way
  • Unsubscribe confirmation: Enter or u unsubscribes, e also archives the sender’s mail (a says where it went until 0.6.204), and n, Esc or q cancels
  • Analytics filter modal
  • Reply-later queue browser: list of flagged messages and due reminders, opened with Reply queue (gq). F there opens Focus & reply on the selected message. w takes the selected message out of the queue, as the web app’s Done does. Cancel a pending reminder from the focused sent message with the palette (:) → Cancel no-reply reminder
  • Promise prompt: after a send whose message promises something with a date, a toast asks “Remind me …?”; y keeps it as a reminder, n or Esc lets it go
  • 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 the palette (:) → Sender profile. 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
  • 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.
  • Hints: the first time the cursor reaches an element a mode explains (Now’s first why line, To do’s first row, Messages’ Got it, an Archive answer), one sentence naming its key shows in the status line. Esc or using that key dismisses it in every client; mxr modes hint ID --show brings one back. There is no tour.
  • Command palette: broad action surface
  • Help modal: context-aware keybinding reference
  • Hint bar: context-sensitive shortcuts, including selection-aware actions
  • gC: accounts and settings; Edit config in the palette opens config.toml in $EDITOR