TUI
Select the daemon for the entire session
Section titled “Select the daemon for the entire session”MXR_DAEMON_ADDR='cmd://ssh -T host mxr daemon dial-stdio' mxrThe 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.
Screens
Section titled “Screens”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.
Discoverability
Section titled “Discoverability”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,*oriand wait 300 ms: a box above the status bar lists the keys that can follow here, yourkeys.tomlchanges included. Typing the next key sooner never shows it. The prefix waits four seconds for its next key, andEsccancels it. :(orCtrl-k) opens the command palette, which fuzzy-matches every action that works where you are, by name, with all of its keys there (yourkeys.tomlremaps 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.
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 - Press
Fin an open message to fill the main mail area; the sidebar and message list hide. PressFagain for split view, orEscto return to the list. - Bulk selection with confirmation modals
- In a thread,
JandKmove between messages.ofolds 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, andQshows it. Plain text (Roff) 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 anduto 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 agofor today’s mail,Tue 21 Oct 14:02for earlier mail this year, andTue 21 Oct 2025 14:02after 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.
Now and the modes
Section titled “Now and the modes”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
Section titled “Focus & reply”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
Section titled “Updates”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.
Snoozed
Section titled “Snoozed”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 and Paper trail
Section titled “Reading and Paper trail”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
Section titled “Archive”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.
Thread context
Section titled “Thread context”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.
Thread summaries
Section titled “Thread summaries”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:
mxr summarize THREAD_IDSearch 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-fis separate and only filters the current mailboxEnter,oor→opens the selected result in previewEscmoves 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 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
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 (
mtoggles to Largest Messages mode;bcyclesgroup_bywhile in Breakdown). - Stale Threads: threads waiting on a reply (
ptoggles perspective,[/]adjustsolder_than_days,{/}adjustswithin_days). - Contacts: asymmetry vs decay (
mtoggles sub-mode,Rrefreshes the materialized contacts table). - Response Time: reply-latency percentiles (
dtoggles direction). - Subscriptions: list-sender ROI table (
otoggles open-rate ranking;uopens the unsubscribe-confirm modal for the selected row). - Wrapped: Spotify-style yearly summary as a 7-tile dashboard
grid (
h/j/k/lmove between tiles,y/Ystep year,tcycles window kind: YTD → Year → SinceDays).
Two cross-view interactions:
Enterdrills down. Storage senders/labels and Contacts emails jump to a Search filter; Stale Threads, Largest Messages, and Subscriptions rows open the underlying conversation directly viaRequest::GetEnvelope(no search round-trip).fopens the filter modal, a per-view form with all CLI flags exposed as editable fields.Tab/Shift-Tabto navigate,Enterto apply,Escto cancel.
Modals and overlays
Section titled “Modals and overlays”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]orEscreopens$EDITORon 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 bareEnterruns 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-asays where it went until 0.6.225). - Drafts (
g d):Enteropens the selected draft in$EDITOR, asrdoes 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]orEscreopens 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_COLORto show[-removed-]{+added+}marks. Gap ranges use the warning style, and the warning says sending remains blocked.Esckeeps the original draft, asqdoes. 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]orEnteraccepts the selected proposal,[e]accepts and opens$EDITOR,[n]enters a revision note, and←/→select proof versions. Arrow keys orj/kscroll; PageUp/PageDown and Home/End move farther.[o]opens the next cited voice example in the reader. Scroll with arrows or PageUp/PageDown;Escreturns 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 on1–4, then a Custom… entry that opens a text prompt with a live preview of the resolved time, using the same time phrases asmxr 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.jandk, the arrows, orCtrl-nandCtrl-pmove, as in the web app’s Not now.Zsays 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 (Dblocks).Tand the new-sender digits say where they went until 0.6.197. Tab switches between readings of an ambiguous phrase such asfri 3; the send-at and remind prompts work the same way - Unsubscribe confirmation:
Enteroruunsubscribes,ealso archives the sender’s mail (asays where it went until 0.6.204), andn,Escorqcancels - Analytics filter modal
- Reply-later queue browser: list of flagged messages and due reminders,
opened with Reply queue (
gq).Fthere opens Focus & reply on the selected message.wtakes 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 …?”;
ykeeps it as a reminder,norEsclets 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/kselects another email andEnter/oopens it. - Screener queue: triage list with
a/d/f/pdisposition keys (allow / deny / feed / paper-trail) wired toRequest::SetScreenerDecision - Welcome / setup: first-launch modal with
d(demo),g(Gmail),i(IMAP) shortcuts;Enteropens 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
ListBodiesreads 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”- 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.
Escor using that key dismisses it in every client;mxr modes hint ID --showbrings 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 opensconfig.tomlin$EDITOR