Skip to content

Keybindings

These tables show defaults. To give an action other keys in both clients, use Settings → Keyboard in the web app or mxr keys set <action> <keys>; both write keys.toml through the daemon after checking for conflicts. The TUI uses the change from its next start and the web app when it next loads. To turn off every single-character shortcut, use the Single-key shortcuts switch there or mxr keys single-keys off (details). Help and the command palette show your effective shortcuts.

Every default in both clients comes from one definition. mxr keys lists it, and mxr keys explain <key> --context <place> says what a key does there, for example mxr keys explain e --context todo. The Raycast extension reads the same definition: its shortcuts are Cmd plus the web app’s letter, except where Raycast keeps its own key. ⌘D shows Raycast’s reading pane, which the other clients don’t have. See Raycast.

When a default moves, the old key keeps a reminder for 30 releases: pressing it shows “ is now ” in the status bar and does nothing else. After that the old key does nothing, unless another action takes it.

Find keys while you work (web and desktop)

Section titled “Find keys while you work (web and desktop)”
  • Press g and pause for a moment (300 ms) to see the next keys you can press here, with any keys you changed. The same guide appears after * (select) and i (invitations), and the TUI shows it above its status bar. Fast sequences run immediately without opening the guide. A prefix waits four seconds for its next key. Esc cancels; clicking or entering a text field cancels too.
  • g f reaches filters in mail and Search. On tool and settings pages it focuses the selected tab or first filter. The key is shown beside the controls.
  • Once a tab or segmented choice has focus, arrow keys move between choices; Home and End jump to the ends. Tab leaves the group. Settings and Reading section links keep normal link behavior: arrows move focus, Enter opens.
  • In Messages, f cycles the four views without focusing the controls. In mail lists and the email reader, f still means Forward.

Shortcuts do not take letters from text fields, editors or open dialogs.

Ask the daemon which key does what, in which place, instead of searching these tables. Each row is the client, the place, the key, the action id, its label and, for the TUI, the action the dispatcher runs:

Terminal window
mxr keys explain e # what e does in every place
mxr keys explain e --context todo # what e does in To do
mxr keys --client tui --context todo # every key live in To do
mxr keys --client web --format json # the web app's keys, for a script
$ mxr keys explain e --client tui
tui assistant e tui.assistant.steps Open or fold the steps (inline:toggle_steps)
tui catchup e todo.catchup-let-go Let go of this one (CatchupLetGo)
tui compose-assist-proof e compose.proof.accept-edit Accept proof and edit (ComposeProofAcceptEdit)
tui list e mail.archive Archive (Archive)
tui messages e messages.done Done here (MessagesDone)
tui now e now.done Done here (NowDone)
tui place e place.done Done here: let go of this in Updates or Reading (Archive)
tui reader e mail.archive Archive (Archive)
tui reading e reading.let-go Let go (ReadingLetGo)
tui reading-reader e reading.let-go Let go (ReadingLetGo)
tui rules e tui.rules.toggle Turn rule on or off (ToggleRuleEnabled)
tui search e mail.archive Archive (Archive)
tui search-preview e mail.archive Archive (Archive)
tui todo e todo.done Done (TodoDone)
tui updates e updates.let-go-source Let go of this source (UpdatesLetGoSource)

--client is tui or web. --context takes a TUI context or a web scope such as todo, and a place with no keys prints No keys match. Use the action ids from this listing as the right-hand side of a remap in keys.toml.

After you edit keys.toml, check it before you restart the TUI. mxr keys check reads the file beside your config, or the path you give it, and names every entry the TUI would ignore. It exits non-zero when it finds one:

Terminal window
mxr keys check
mxr keys check ~/dotfiles/mxr/keys.toml
$ mxr keys check keys.toml
keys.toml:
[todo] `Ctrl+Shift+Zzz`: most terminals send Ctrl+Shift+ as plain Ctrl+
[todo] `Q`: no action todo.nope; `mxr keys --client tui --context todo` lists them
Error: 2 problems in keys.toml

With no keys.toml beside your config, it reports No <path>/keys.toml; every key is the default. and exits 0.

mxr keys set, mxr keys reset and mxr keys single-keys change keys.toml through the daemon. Each checks the change first and writes nothing when a key belongs to another action; --dry-run only checks. Keys are spelled as mxr keys prints them, and Mod is Cmd on a Mac, Ctrl elsewhere and in the TUI.

Terminal window
mxr keys set mail.archive % --dry-run # check only
mxr keys set mail.archive % # Archive is % in the TUI and the web app
mxr keys set mail.star s Mod+Shift+s # several keys, primary first
mxr keys set mail.trash --none # palette only
mxr keys reset mail.archive # back to its default keys
mxr keys single-keys off # turn single-character shortcuts off
$ mxr keys set mail.archive s
Can't save:
[actions] mail.archive: web scope `list`: `s` is bound to mail.archive, mail.star
[actions] mail.archive: web scope `reader`: `s` is bound to mail.archive, mail.star
[actions] mail.archive: TUI context `list`: `s` is bound to mail.archive, mail.star
[actions] mail.archive: TUI context `reader`: `s` is bound to mail.archive, mail.star
Error: nothing written to /Users/you/.config/mxr/keys.toml
$ mxr keys set mail.archive %
Archive (mail.archive) is %. Saved /Users/you/.config/mxr/keys.toml; restart the TUI and reload the web app to use it.

mxr keys then marks the action’s keys (yours), and with single-key shortcuts off it says so and marks the keys that do nothing (off).

The tables below are generated from the key definition, so they list exactly what the TUI does. Help (?) shows the same keys for the place you are in, with your keys.toml remaps.

  • Esc goes back one level and never destroys anything. q closes the innermost layer (a menu, the reader, a sub-view, a screen) and quits only at the mailbox root. Ctrl-z suspends the TUI to the shell; fg brings it back.
  • g and a lowercase letter goes to a mail place or mode; g and a capital opens a tool. The digits that used to open the tabs retired.
  • Pasted text types into the focused text field. With no field focused, the TUI drops it, so a paste never runs as shortcuts. In terminals that support the kitty keyboard protocol, Esc also acts at once instead of waiting to see whether it starts an Alt key; every key works without it.
  • n and N step to the next and previous conversation from the message view, as in the web app; in the list they say j and k until 0.6.200.
  • The reader folds as the web reader does: o folds or opens the focused message (J and K move the focus), ; folds all but the newest and unread messages or opens them all, and Q shows or folds quoted text. ] and [ archive the conversation, with the list’s confirm and undo, and then open the next or previous one. The reader’s o used to open the original in the browser; that is O.
  • Digits count rows only in visual line mode (V, 3, j selects 4 rows), and Esc with a count typed drops the count. Before a multi-message action runs, the confirm lists the messages it will touch.
  • Some actions have no key and are in the command palette (:): draft assist, a new draft for this sender, commitments, the voice profile, Edit config, Export as Markdown, Send to Microsoft To Do and Sync the linked Microsoft To Do task in To do, Sweep this sender out of Updates, and Archive’s export of the records in view.
  • In To do, , reviews a waiting resolution before it edits fields. Review later evidence lists the preview’s own keys.
  • With single-key shortcuts off (single_keys = false in keys.toml, or mxr keys single-keys off), a character typed on its own does nothing in the mail panes, the modes and the tool screens; text fields and open menus keep their letters. Ctrl-k opens the palette, and help’s title says the switch is off.
  • On any conversation, X then e files it in Archive. Pass to a mode in the palette shows the card it would file first, and Enter files it.

In the mail list, the reader, the sidebar and every mode.

Key Action
:, Ctrl+k, Ctrl+p Command palette
? Keyboard help
g h Go to Now
g m Go to Messages
g u Go to Updates
g e Go to Archive
g w Waiting on
g i, g 0 Go to Inbox
g s Go to Starred
g t Go to Sent
g d Go to Drafts
g a Go to All Mail
g l Go to label
g A Analytics
g Y Activity log
g L Daemon logs
g C Settings
g n Go to Snoozed
g # Go to Trash
g ! Go to Spam
g q Reply later
g o Owed replies
g v Calendar invites
g r Reading
g S Screener
g R Rules
g D Diagnostics
g P Deliveries
g F Focus & reply
g x To do
@ Show or hide the assistant
* t Pattern select thread
g 1 … g 9 Open saved search 1 to 9, in sidebar order

In the mail list, the reader, and the Reading and Paper trail lists. Mail verbs act on the selected conversations, or on the open one.

Key Action
/ Search mail
c Compose
u, z Undo last action
m Mark read and archive
#, Delete, Backspace Move to Trash
! Mark as spam
I Mark read
U Mark unread
l Labels…
v Move to label…
b Not now…
t Make a to-do from this
r Reply
a Reply all
f Forward
B Thread briefing
p Sender profile
L Links in this message
A Attachments
i a Accept invite
i m Maybe (invite)
i d Decline invite
i A Accept with comment
i M Maybe with comment
i D Decline with comment
x Select and move down
V Visual line mode
* a Select all
* n Select none
* r Select read
* u Select unread
* s Select starred
g f Filter this list
R Reader view, or back to plain
S Show or hide signatures
O Open original in a new tab
F Full-width reader
X Move to…
Tab Switch pane

Inbox, labels and saved searches.

Key Action
e Archive
s Star or unstar
D Unsubscribe…
j, ↓ Next conversation
k, ↑ Previous conversation
Home, g g First conversation
End, G Last conversation
Ctrl+d, PageDown Half page down
Ctrl+u, PageUp Half page up
→, o, Enter Open conversation
←, h Go to sidebar
w Wake: bring it back now
Esc Clear selection, then close
Ctrl+f Filter this list
P Send everything from this sender to…
q Quit view

An open conversation.

Key Action
e Archive
s Star or unstar
D Unsubscribe…
Ctrl+f Filter this list
↓, j Scroll down
↑, k Scroll up
Ctrl+d, PageDown, Space Page down
Ctrl+u, PageUp Page up
Home, g g Top of thread
End, G End of thread
J Next message
K Previous message
o Expand or collapse message
; Expand or collapse all
n Next conversation
N Previous conversation
] Archive, open next
[ Archive, open previous
←, h Back to list
Esc, q Close conversation
H Formatted (HTML) view, or back to plain
M Load remote images
Q Show or hide quoted text

Places, labels and saved searches, on the left.

Key Action
/ Search mail
u, z Undo last action
b Not now…
A Attachments
i a Accept invite
i m Maybe (invite)
i d Decline invite
i A Accept with comment
i M Maybe with comment
i D Decline with comment
↓, j Next item
↑, k Previous item
Home, g g First item
End, G Last item
Enter, →, l, o Open
{ Previous section
} Next section
Ctrl+d, PageDown Half page down
Ctrl+u, PageUp Half page up
x Select and move down
V Visual line mode
* a Select all
* n Select none
* r Select read
* u Select unread
* s Select starred
Esc Clear selection, then close
g f, Ctrl+f Filter this list
F Full-width reader
Tab Switch pane
q Quit view
c New saved search

Newsletters and automated mail, bundled by sender, opened from the sidebar.

Key Action
Home, g g First conversation
End, G Last conversation
Ctrl+d, PageDown Half page down
Ctrl+u, PageUp Half page up
←, h Go to sidebar
Esc Clear selection, then close
↓, j Next
↑, k Previous
→, Enter, o Open, or expand a bundle
e Done here: let go of this in Updates or Reading
s Pin or unpin (a sweep leaves pins)
E Sweep the whole place…
P Move sender to…
D Unsubscribe…
q Quit view

The front page the TUI opens on. Acting on a row does it in that row’s own mode.

Key Action
/ Search mail
c Compose
u, z Undo last action
b Not now…
Home, g g First conversation
End, G Last conversation
Ctrl+d, PageDown Half page down
Ctrl+u, PageUp Half page up
←, h Go to sidebar
↓, j Next
↑, k Previous
Enter Open in its mode
e Done here
r Reply
a Reply all
f Forward
t Make it a to-do
o Open the email
E Let go of the Updates digest…
Esc Dismiss the hint
X Move to…
P Send everything from this sender to…
q Quit view

People as rows with their topics inside. See Messages.

Key Action
/ Search mail
u, z Undo last action
Home, g g First conversation
End, G Last conversation
Ctrl+d, PageDown Half page down
Ctrl+u, PageUp Half page up
←, h Go to sidebar
↓, j Next person
↑, k Previous person
Enter Open the person
r Reply
a Reply all
. Got it: a short thanks, after a countdown
e Done here
t Make it a to-do…
b Not now: reply later…
s Pin or unpin this person
c New topic with this person
{ Previous topic
} Next topic
p Go to the person page
o Show the message as sent
f Cycle Messages views
g f, Ctrl+f Filter the people list: turn, unread, past your pace
Esc Dismiss the hint, or back to the people
X Move to…
P Send everything from this sender to…
q Quit view

See Act on To dos.

Key Action
/ Search mail
c Compose
u, z Undo last action
Home, g g First conversation
End, G Last conversation
Ctrl+d, PageDown Half page down
Ctrl+u, PageUp Half page up
←, h Go to sidebar
↓, j Next
↑, k Previous
Enter Do it: what the row’s button says
e Done
b Not now: schedule…
, Edit what mxr read…
X Correct to-do
o Open the email it came from
Space Peek: why it is here, its email and where each field came from
1 Runway
3 Expired list
2 Catch-up
Esc Dismiss the hint
q Quit view

The first run’s older undated tasks: keep each one, or let it go to the Expired list.

Key Action
/ Search mail
c Compose
u, z Undo last action
Home, g g First conversation
End, G Last conversation
Ctrl+d, PageDown Half page down
Ctrl+u, PageUp Half page up
o Open the email it came from
1 Runway
3 Expired list
2 Catch-up
↓, j Next
↑, k Previous
Enter Keep: it still needs me
e Let go of this one
E Let go of all…
Esc, q Back to To do

Tasks that expired or were let go.

Key Action
/ Search mail
c Compose
Home, g g First conversation
End, G Last conversation
Ctrl+d, PageDown Half page down
Ctrl+u, PageUp Half page up
o Open the email it came from
1 Runway
3 Expired list
2 Catch-up
↓, j Next
↑, k Previous
Enter, u Restore to To do
Esc, q Back to To do

The briefing: the latest digest, one line per source, with what arrived since below the cut.

Key Action
/ Search mail
c Compose
u, z Undo last action
Home, g g First conversation
End, G Last conversation
Ctrl+d, PageDown Half page down
Ctrl+u, PageUp Half page up
←, h Go to sidebar
↓, j Next
↑, k Previous
Enter Show routine
E Let go of the digest…
e Let go of this source
t This needs me: make it a to-do
P Tune this source…
L Open the link
y Copy the one-time code
o Open the email
Space Peek at this update under its line
s Pin or unpin this source’s latest email
Esc Dismiss the hint
X Move to…
q Quit view

The edition. Mail keys such as archive, star and reply don’t apply here.

Key Action
/ Search mail
c Compose
u, z Undo last action
t Make a to-do from this
Home, g g First conversation
End, G Last conversation
Ctrl+d, PageDown Half page down
Ctrl+u, PageUp Half page up
←, h Go to sidebar
↓, j Next
↑, k Previous
Enter Read
L Fetch the linked article
b Not now: later or snooze…
e Let go
D Unsubscribe…
R Read in the sender’s layout
E Let go of everything shown…
o Open the email as sent
P This sender here: move to…
1 Edition
2 Later
3 Highlights
O Open in Marginalia
Esc Dismiss the hint
X Move to…
q Quit view

One item from the edition, open.

Key Action
/ Search mail
c Compose
u, z Undo last action
t Make a to-do from this
Home, g g First conversation
End, G Last conversation
Ctrl+d Half page down
Ctrl+u Half page up
Enter Read
L Fetch the linked article
b Not now: later or snooze…
e Let go
D Unsubscribe…
R Read in the sender’s layout
E Let go of everything shown…
o Open the email as sent
P This sender here: move to…
1 Edition
2 Later
3 Highlights
O Open in Marginalia
" Highlight the paragraph at the top, or the selection
←, Esc, q Back to the edition
X Move to…

The records lens, with the answer box focused.

Key Action
c Compose
u, z Undo last action
Home, g g First conversation
End, G Last conversation
Ctrl+d, PageDown Half page down
Ctrl+u, PageUp Half page up
←, h Go to sidebar
↓, j Next record
↑, k Previous record
/ Ask Archive
y Copy the reference
Y Copy the amount
Enter Open the document
o Open the email
p This issuer’s records
{ Previous year
} Next year
, Fix a field…
X Not a record
t Make a to-do from this record
g f Filter by kind
Esc Close
q Quit view
→ Records open card

g F: everyone you owe a reply, one conversation at a time. r writes the reply in $EDITOR, and Send in the review moves on to the next. The navigation keys above work here too.

Key Action
/ Search mail
c Compose
u, z Undo last action
j Skip for now
e Done, no reply needed
b Not now…
d Draft in your voice
r Back to the reply
Esc, q Leave focus mode

New senders waiting for a decision.

Key Action
a Allow sender
d Deny sender
f Send to feed
p Send to paper trail
↓, j Next sender
↑, k Previous sender
Esc, q Close screener modal

The calendar invites list, from the sidebar. The i keys above answer an invite.

Key Action
Enter, o, → Open the invite’s email
/ Search mail
u Undo the RSVP while it can still be stopped
h, ← Go to sidebar

The Search screen’s results.

Key Action
c Compose
u, z Undo last action
e Archive
m Mark read and archive
#, Delete, Backspace Move to Trash
! Mark as spam
s Star or unstar
I Mark read
U Mark unread
l Labels…
v Move to label…
D Unsubscribe…
t Make a to-do from this
r Reply
a Reply all
f Forward
B Thread briefing
p Sender profile
L Links in this message
R Reader view, or back to plain
S Show or hide signatures
O Open original in a new tab
Esc Back to the mailbox
j, ↓ Next row
k, ↑ Previous row
/ Edit the query
Enter, o, → Open the result in the preview

The thread previewed beside the results.

Key Action
c Compose
u, z Undo last action
e Archive
m Mark read and archive
#, Delete, Backspace Move to Trash
! Mark as spam
s Star or unstar
I Mark read
U Mark unread
l Labels…
v Move to label…
D Unsubscribe…
t Make a to-do from this
r Reply
a Reply all
f Forward
B Thread briefing
p Sender profile
L Links in this message
o Expand or collapse message
; Expand or collapse all
] Archive, open next
[ Archive, open previous
R Reader view, or back to plain
S Show or hide signatures
Q Show or hide quoted text
O Open original in a new tab
/ Edit the query
h, ←, Esc Back to the results
j, ↓ Next message in the thread
k, ↑ Previous message in the thread
Ctrl+d Scroll the message down
Ctrl+u Scroll the message up
G End of the message
H Original HTML
M Remote images

While you type the query. Letters type.

Key Action
Enter Run the search
Esc Stop editing the query
Key Action
Esc Back to the mailbox
j, ↓ Next row
k, ↑ Previous row
c New rule
E Edit rule
e Turn rule on or off
Enter, o Refresh the rule’s overview
D Dry run: what the rule would change
PageDown Next page of the dry run
PageUp Previous page of the dry run
A Apply the sorting preview
H Rule history
# Delete rule (asks first)

Letters type into the field; these keys don’t.

Key Action
Ctrl+d Dry run: what the rule would change
Ctrl+s, Enter Save the rule
Tab Next field
Shift+Tab Previous field
Esc Close the form

Accounts, and the TUI’s settings.

Key Action
Esc Back to the mailbox
j, ↓ Next row
k, ↑ Previous row
c Add account
Enter, o Edit account
t Test account
d Make it the default account
r Refresh accounts, or repair the selected one when it is unhealthy
R Refresh accounts
O Details of the last test

While a field is being edited, letters type into it, and Enter or Esc stops editing.

Key Action
t Test account
o Details of the last test
Esc Close the form (a new account keeps its draft)
j, ↓, Tab Next field
k, ↑, Shift+Tab Previous field
l, → Next account type
h, ← Previous account type
Enter, i, Space Edit or toggle the field
r Sign in to Gmail again
s Save the account
Ctrl+k Command palette
Key Action
Esc Back to the mailbox
j, ↓, Tab, → Next section
k, ↑, Shift+Tab, ← Previous section
Ctrl+d, PageDown Scroll the section down
Ctrl+u, PageUp Scroll the section up
Enter, o Full screen for the section, or back
/ Search the events, logs or activity section
d Details of the section
r Refresh diagnostics
b Generate a bug report
c Edit config
L Open logs
a Preview activating the restored archive
A Activate the restored archive
p Preview the recovered draft
P Restore the recovered draft
] Next recovered draft
[ Previous recovered draft

These work in every view.

Key Action
Esc Back to the mailbox
j, ↓ Next row
k, ↑ Previous row
Tab Next view
Shift+Tab Previous view
r Refresh the view
f Filter: every CLI flag for the view
Enter Drill down: a sender to a search, a thread to the conversation
Key Action
m Breakdown or largest messages
b Group the breakdown by sender, type or label
Key Action
p Mine or theirs
[ Older than: 7 days less
] Older than: 7 days more
{ Within: 30 days less
} Within: 30 days more
Key Action
m Asymmetry, decay or refresh
R Rebuild the contacts table
Key Action
d Clock or business hours
Key Action
o Rank by volume or open rate
u Unsubscribe from the selected sender (asks first)

The year in review moves between tiles instead of rows.

Key Action
Esc Back to the mailbox
Tab Next view
Shift+Tab Previous view
r Refresh the view
f Filter: every CLI flag for the view
Enter Drill down: a sender to a search, a thread to the conversation
h, ← Tile to the left
l, → Tile to the right
j, ↓ Tile below
k, ↑ Tile above
y A year back
Y A year forward
t Year to date, a year, or the last days

Tracked packages detected in your mail.

Key Action
j, ↓ Next row
k, ↑ Previous row
Enter, o, → Open the source email in a split preview
Esc Close the preview
Ctrl+d Scroll the open email down
Ctrl+u Scroll the open email up
r Resolve: mark it delivered
d Dismiss a false positive
D Active, delivered or all
R Refresh the list

@ opens the pane and gives it the keys. While it has them, nothing you type reaches the screen behind it. See the assistant guide.

Key Action
Esc Give the keys back to the screen
i, Enter Write a message
@ Hide the assistant
Ctrl+k, Ctrl+p Command palette
Ctrl+c Stop the running turn
j, ↓ Scroll down
k, ↑ Scroll up
Ctrl+d, PageDown Page down
Ctrl+u, PageUp Page up
G Latest message
e Open or fold the steps
1–9 Open the reply’s link by number
N New conversation
L Past conversations
M Choose the model
T Auto-approve reversible changes in this conversation
# Delete the conversation (shows what goes first)
Key Action
Ctrl+k, Ctrl+p Command palette
Ctrl+c Stop the running turn
Enter Send
Alt+Enter, Ctrl+j New line
Esc To the pane keys

The proof shown for a draft written in your voice, before it goes into your editor.

Key Action
y, Enter Accept writing proof
e Accept proof and edit
n Revise writing proof
m Try writing proof with another model
Esc, q Keep my draft
o Open next voice example
← Previous writing proof
→ Next writing proof
↑, k Scroll writing proof up
↓, j Scroll writing proof down
PageUp Page up in writing proof
PageDown Page down in writing proof
Home Top of writing proof
End Bottom of writing proof

An open overlay takes every key until it closes. Each one closes with Esc without changing anything, and with q where nothing is typed; Enter runs the highlighted option, and in a yes-or-no question y is Enter and n is Esc. Each prints its keys in its footer too.

? opens it. Letters type into its filter.

Key Action
j, ↓ Move down
k, ↑ Move up
Ctrl+d Page down
Ctrl+u Page up
Esc, ?, Enter, q Close help
Tab Show the next place’s keys first

: or Ctrl-k opens it. Letters type into its filter.

Key Action
Esc Close
↓, Ctrl+n Move down
↑, Ctrl+p Move up
Enter Run the highlighted option

l labels and v moves. Letters type into its filter.

Key Action
Esc Close
↓, Ctrl+n Move down
↑, Ctrl+p Move up
Enter Run the highlighted option

L opens it.

Key Action
Esc, q Close
j, ↓ Move down
k, ↑ Move up
Enter, o Open the link
y Copy the link

D opens it.

Key Action
Esc, q Close
n No
Enter, u, U Unsubscribe
e, E Unsubscribe and archive their mail

X moves this email; a capital moves everything from its sender.

Key Action
Esc, q Close
j, ↓ Move down
k, ↑ Move up
Enter Run the highlighted option
m Move this email to Messages
x Move this email to To do
u Move this email to Updates
r Move this email to Reading
e Move this email to Archive
M Move the sender to Messages
U Move the sender to Updates
R Move the sender to Reading

P moves everything from the sender. Either case picks.

Key Action
Esc, q Close
j, ↓ Move down
k, ↑ Move up
Enter Run the highlighted option
m, M Move the sender to Messages
u, U Move the sender to Updates
r, R Move the sender to Reading

X or P on a new sender: a capital answers its question (from P, either case does).

Key Action
Esc, q Close
j, ↓ Move down
k, ↑ Move up
Enter Run the highlighted option
m Move this email to Messages
x Move this email to To do
u Move this email to Updates
r Move this email to Reading
e Move this email to Archive
M Answer: People
U Answer: Paper trail
R Answer: Reading
D Answer: Screened out

P in Reading and Paper trail. Either case picks.

Key Action
Esc, q Close
j, ↓ Move down
k, ↑ Move up
Enter Run the highlighted option
m, M Move the sender to People
r, R Move the sender to Reading
u, U Move the sender to Paper trail
d, D Move the sender to Screened out
a, A Automatic: let the rules decide

b opens it on Later; the digits pick the presets.

Key Action
Esc, q Close
↓, Ctrl+n Move down
↑, Ctrl+p Move up
j Move down
k Move up
Enter Run the highlighted option
1–4 Pick that time

Letters type the time, read as you type.

Key Action
Esc Back
Enter Run the highlighted option
Tab Use the other reading of the time

X on a to-do.

Key Action
Esc, q Close
j, ↓ Move down
k, ↑ Move up
Enter Run the highlighted option
1 Not a to-do
2 Not mine
3 Already done
4 Wrong details

Deleting a saved search, rule, category, draft or assistant conversation, and cancelling a scheduled send. It opens on Keep, so a bare Enter changes nothing.

Key Action
Esc, q Close
Enter Run the highlighted option
y Yes
n No
Tab, Shift+Tab Light the other option
j, k, h, l, ↑, ↓, ←, → Light the other option

A batch action over many conversations shows them first.

Key Action
Esc, q Close
j, ↓ Move down
k, ↑ Move up
Enter Run the highlighted option
y, Y Yes
n No

E in Reading and Paper trail. A whole place’s sweep opens on Cancel.

Key Action
Esc, q Close
Enter Run the highlighted option
y Yes
n No
Tab, Shift+Tab Light the other option

Letters type when to bring it back; with nothing typed, Enter flags it for reply later.

Key Action
Esc Close
Enter Run the highlighted option
Tab Use the other reading of the time

After a Not-sure answer. Any other key drops the question and does what it always does.

Key Action
y, Enter Yes, always for this sender
n, Esc No, this email only
Key Action
Esc, q Close
j, ↓ Move down
k, ↑ Move up
Enter Run the highlighted option
w Why is this here?
/ Filter
c New category
r Rename
# Delete the category

A change the assistant wants to make, waiting in its pane. Any other key works as it does in the pane.

Key Action
y Approve the waiting change
n Reject it, with a reason
x Show or hide its exact call
a Show all or fewer of its messages

Assistant: a question waiting for an answer

Section titled “Assistant: a question waiting for an answer”

A question the assistant asks, waiting in its pane. Any other key works as it does in the pane.

Key Action
1–9 Choose an answer by number
o Write your own answer
Tab Next question
Shift+Tab Previous question
Enter Answer
s Skip the question
Esc, q Leave the question for later

L in the assistant pane opens it.

Key Action
Ctrl+k, Ctrl+p Command palette
Enter Open the conversation
# Delete the conversation
Esc, q Close
j, ↓ Move down
k, ↑ Move up

After you save and quit $EDITOR. It opens on Send.

Key Action
Enter Run the highlighted option
O, Ctrl+o Override the block and send once
s Send
a Send later
n Send, and remind me if nobody replies
d Save as a draft on the server
e, Esc Edit again
r Refine with the assistant
# Discard draft
c Add the suggested person to Cc

Letters type the time, read as you type.

Key Action
Esc Back
Enter Run the highlighted option
Tab Use the other reading of the time
Key Action
Esc, q Close
j, ↓ Move down
k, ↑ Move up
Enter Edit the draft
# Delete the draft
c Cancel the scheduled send
p Sync the draft to the server

c opens it. Letters type into its fields.

Key Action
Esc Close
↓, Ctrl+n Move down
↑, Ctrl+p Move up
Enter Next field: the subject
Tab Add the highlighted person
Key Action
Esc, q Close
j, ↓ Move down
k, ↑ Move up
Enter Run the highlighted option

Letters type into the instruction field.

Key Action
Esc Close
Enter Run the highlighted option
Tab, ↑, ↓, j, k Next field
←, →, h, l Next or previous choice
Key Action
Esc, q Close
j, ↓ Move down
k, ↑ Move up
PageDown Page down
PageUp Page up

A opens it.

Key Action
Esc, q, A Close
j, ↓ Move down
k, ↑ Move up
Enter, o Open the attachment
d Save it somewhere

Letters type the path.

Key Action
Esc Close
Enter Run the highlighted option
1–3 Downloads, Desktop or here

Export, from the palette.

Key Action
Esc Close
Enter Run the highlighted option
↓ Move down
↑ Move up
m Markdown
j JSON
x Mbox
l LLM context
Key Action
Esc Close
c Copy to the clipboard
s Save to a file

Letters type the path.

Key Action
Esc Close
Enter Run the highlighted option

Ctrl-f or g f opens it. Letters type the filter.

Key Action
Esc Close
Enter Run the highlighted option
Tab Next search mode

g f or Ctrl-f in Messages.

Key Action
Esc, q, Ctrl+f Close
j, ↓ Move down
k, ↑ Move up
Enter Run the highlighted option
Space Pick it

Letters type into the field.

Key Action
Esc Close
Enter, Ctrl+s Run the highlighted option
Tab Next field
Shift+Tab Previous field
Space Next search mode

Letters type into the field.

Key Action
Esc Close
Enter Run the highlighted option
Tab Next field
Shift+Tab Previous field
←, → Next or previous choice

Letters type the to-do, or field=value to fix one.

Key Action
Esc Close
Enter Run the highlighted option

Letters type field=value.

Key Action
Esc Close
Enter Run the highlighted option

Pass to a mode, from the palette.

Key Action
Esc, q Close
Enter Run the highlighted option
a See what filing would make

The emails behind Now’s arrivals line.

Key Action
u, z Undo last action
X Move to…
P Send everything from this sender to…
j, ↓ Next
k, ↑ Previous
Enter, o Open conversation
Esc, q Close
Tab Next kind of arrival
Key Action
Esc, q Close
j, ↓ Move down
k, ↑ Move up
Key Action
Esc, q Close
j, ↓ Move down
k, ↑ Move up
1 Overview
2 Relationship
3 Their emails
Enter, o Open the email
W Who is this?
Key Action
w Wake: bring it back now
Esc, q Close
j, ↓ Move down
k, ↑ Move up
Enter, r Reply
F Focus and reply, one at a time
Key Action
Esc, q Close
Key Action
Esc, q, Enter, x Close
Key Action
Esc, q, Enter, x Close
j, ↓ Move down
k, ↑ Move up
Ctrl+d, PageDown Page down
Ctrl+u, PageUp Page up

On first run, before an account exists.

Key Action
Enter, Space Start setting up
d Try the demo
g Add Gmail
i Add IMAP and SMTP
Esc Not now
q Quit

Adding an account while an unsaved account form is kept.

Key Action
Esc, q Close
Enter Run the highlighted option
y Yes
n No
Tab, Shift+Tab Light the other option
j, k, h, l, ↑, ↓, ←, → Light the other option
c Resume the form

Changing an account form’s type drops what doesn’t fit the new one.

Key Action
Esc Close
Enter Run the highlighted option
y Yes
n No

i on the Accounts screen. Letters type the tag.

Key Action
Esc Close
Enter Run the highlighted option
Tab, Shift+Tab, ↑, ↓ Other field
←, →, Space Next or previous colour

While Microsoft sign-in waits for the code.

Key Action
Esc Close

Any other key works as usual and leaves the question for later.

Key Action
y Yes, remind me
n, Esc No, let it go

The web app shares the TUI’s default mail shortcuts. One dispatcher reads every key from the shared action registry (apps/web/src/lib/actions/), so these tables, the in-app help (?), the command palette and Settings → Keybindings always agree. Where the web deliberately differs from the TUI, the note says why, and the key definition’s check fails if the two clients bind a key differently without the definition saying why. Keys never fire while you type in a field or while compose is open, except ⌘K / Ctrl+K and the assistant’s ⌘. / Ctrl+..

Work on every page except while typing in a field or compose.

Key Action Note
⌘K / Ctrl+K, :, Ctrl+P Command palette Ctrl+P works on macOS only, where it is not the browser’s Print; the TUI’s Mod+K is Ctrl+k
/ Search mail
? Keyboard help
c Compose
u, z Undo last action z also undoes, for Gmail muscle memory
@, ⌘. / Ctrl+. Show or hide the assistant Mod+. also works from a text field; terminals don’t pass it through

g then a letter, as in the TUI: lowercase for mail places and modes, a capital for tools.

Key Action Note
g 1 … g 9 Open saved search 1 to 9 In sidebar order, as the TUI’s tab strip
g h Go to Now
g m Go to Messages
g u Go to Updates
g e Go to Archive
g w Waiting on Waiting on lives in Messages in the TUI, so g w opens that
g i, g 0 Go to Inbox
g s Go to Starred
g t Go to Sent
g d Go to Drafts One page here; in the TUI g d is the Drafts mailbox, and its local drafts are in the palette
g a Go to All Mail
g l Go to label
g A Analytics
g Y Activity log
g L Daemon logs
g C Settings The TUI opens its Accounts screen, where its settings live; Edit config is in its palette
g n Go to Snoozed
g # Go to Trash
g ! Go to Spam
g q Reply later
g o Owed replies
g v Calendar invites
g r Reading
g S Screener
g R Rules
g D Diagnostics
g P Deliveries
g F Focus & reply
g x To do

In the mail list they act on the selection or the row under the cursor; in the reader, on the open conversation.

Key Action Note
e Archive
m Mark read and archive Same as the TUI; read/unread are I and U
#, Delete, Backspace Move to Trash
! Mark as spam
s Star or unstar
I Mark read
U Mark unread
l Labels…
v Move to label…
b Not now…
D Unsubscribe…
t Make a to-do from this
r Reply
a Reply all
f Forward
B Thread briefing
p Sender profile
L Links in this message
A Attachments
i a Accept invite
i m Maybe (invite)
i d Decline invite
i A Accept with comment
i M Maybe with comment
i D Decline with comment
X Move to…

With a conversation open beside the list, the reader’s view keys work from here too.

Key Action Note
j, ArrowDown Next conversation
k, ArrowUp Previous conversation
g g, Home First conversation
G, End Last conversation
Ctrl+D, PageDown Half page down
Ctrl+U, PageUp Half page up
Enter, o, ArrowRight Open conversation
h, ArrowLeft Go to sidebar
w Wake: bring it back now
x Select and move down
V Visual line mode
* a Select all
⌘A / Ctrl+A Select all Only in the mail list: in the reader and the sidebar ⌘A / Ctrl+A stays the browser’s select-all, and a terminal can’t send Ctrl+A
* n Select none
* r Select read
* u Select unread
* s Select starred
Esc Clear selection, then close
g f, Ctrl+F Filter this list Ctrl+F works on macOS only, where it is not the browser’s Find
R Reader view, or back to plain
S Show or hide signatures
O Open original in a new tab
F Full-width reader
P Send everything from this sender to…

Selection and filter keys act on the mail list beside the reader.

Key Action Note
x Select and move down
V Visual line mode
* a Select all
* n Select none
* r Select read
* u Select unread
* s Select starred
g f, Ctrl+F Filter this list Ctrl+F works on macOS only, where it is not the browser’s Find
j, ArrowDown Scroll down
k, ArrowUp Scroll up
Ctrl+D, PageDown, Space Page down
Ctrl+U, PageUp, Shift+Space Page up
g g, Home Top of thread
G, End End of thread
J Next message
K Previous message
o Expand or collapse message
; Expand or collapse all
n Next conversation
N Previous conversation
] Archive, open next
[ Archive, open previous
h, ArrowLeft Back to list
Esc, q Close conversation
R Reader view, or back to plain
H Formatted (HTML) view, or back to plain
M Load remote images
S Show or hide signatures
Q Show or hide quoted text
O Open original in a new tab
F Full-width reader

Keys for the mail list and the reader reach them from here, as in the TUI: mail verbs act on the list’s selection or its lit row.

Key Action Note
b Not now…
A Attachments
i a Accept invite
i m Maybe (invite)
i d Decline invite
i A Accept with comment
i M Maybe with comment
i D Decline with comment
j, ArrowDown Next item
k, ArrowUp Previous item
g g, Home First item
G, End Last item
Enter, o, l, ArrowRight Open
{ Previous section
} Next section
Ctrl+D, PageDown Half page down
Ctrl+U, PageUp Half page up
x Select and move down
V Visual line mode
* a Select all
* n Select none
* r Select read
* u Select unread
* s Select starred
Esc Clear selection, then close
g f, Ctrl+F Filter this list Ctrl+F works on macOS only, where it is not the browser’s Find
F Full-width reader

On tool and settings pages, focus tabs and filters with g f; arrow keys then change the choice.

Key Action Note
g f Focus page tabs and filters
Key Action Note
a Allow sender
d Deny sender
f Send to feed
p Send to paper trail
j, ArrowDown Next sender
k, ArrowUp Previous sender

One conversation at a time. In the reply, ⌘Enter sends and moves on; Tab out of the reply (or Esc in the rich-text editor) to use these keys.

Key Action Note
⌘Enter / Ctrl+Enter Send and next
j Skip for now Goes to the end of the queue
e Done, no reply needed
b Not now…
d Draft in your voice
r Back to the reply
Esc, q Leave focus mode

On a lit new sender, X then M, U, R or D answers its question.

Key Action Note
g g, Home First conversation
G, End Last conversation
Ctrl+D, PageDown Half page down
Ctrl+U, PageUp Half page up
h, ArrowLeft Go to sidebar
j, ArrowDown Next
k, ArrowUp Previous
Enter Open in its mode
e Done here
r Reply
a Reply all
f Forward
t Make it a to-do
o Open the email
E Let go of the Updates digest… Previews the daemon’s dry run first; undo afterwards
Esc Dismiss the hint
P Send everything from this sender to…

On a lit new sender, X then M, U, R or D answers its question.

Key Action Note
g g, Home First conversation
G, End Last conversation
Ctrl+D, PageDown Half page down
Ctrl+U, PageUp Half page up
h, ArrowLeft Go to sidebar
j, ArrowDown Next person
k, ArrowUp Previous person
Enter Open the person
r Reply
a Reply all
. Got it: a short thanks, after a countdown Shows the exact text and counts down; u cancels before it sends
e Done here
t Make it a to-do…
b Not now: reply later…
s Pin or unpin this person
c New topic with this person
{ Previous topic
} Next topic
p Go to the person page
o Show the message as sent
g f, Ctrl+F Filter the people list: turn, unread, past your pace Ctrl+F works on macOS only, where it is not the browser’s Find
f Cycle Messages views Needs attention, All conversations, Your turn, Waiting on them; keeps Unread and Past your pace
⌘Enter / Ctrl+Enter Send, then the next person whose turn it is
Esc Dismiss the hint, or back to the people
P Send everything from this sender to…
Key Action Note
g g, Home First conversation
G, End Last conversation
Ctrl+D, PageDown Half page down
Ctrl+U, PageUp Half page up
h, ArrowLeft Go to sidebar
j, ArrowDown Next
k, ArrowUp Previous
Enter Do it: what the row’s button says The TUI opens the source email; the web opens it or a reply for a promise. Links stay in the email.
e Done
b Not now: schedule…
, Edit what mxr read…
X Correct to-do
o Open the email it came from
Space Peek: why it is here, its email and where each field came from
1 Runway
3 Expired list
2 Catch-up
Esc Dismiss the hint

The first run’s older undated tasks: keep each one, or let it go to the Expired list. 2 on To do opens it.

Key Action Note
g g, Home First conversation
G, End Last conversation
Ctrl+D, PageDown Half page down
Ctrl+U, PageUp Half page up
1 Runway
3 Expired list
2 Catch-up
j, ArrowDown Next
k, ArrowUp Previous
Enter Keep: it still needs me
e Let go of this one
E Let go of all… Previews the daemon’s dry run first; undo afterwards
Esc Back to To do

Tasks that expired or were let go. 3 on To do opens it.

Key Action Note
g g, Home First conversation
G, End Last conversation
Ctrl+D, PageDown Half page down
Ctrl+U, PageUp Half page up
1 Runway
3 Expired list
2 Catch-up
j, ArrowDown Next
k, ArrowUp Previous
Enter Restore to To do
Esc Back to To do
Key Action Note
g g, Home First conversation
G, End Last conversation
Ctrl+D, PageDown Half page down
Ctrl+U, PageUp Half page up
h, ArrowLeft Go to sidebar
j, ArrowDown Next
k, ArrowUp Previous
Enter Show routine
E Let go of the digest… Previews the daemon’s dry run first; undo afterwards
e Let go of this source
t This needs me: make it a to-do
P Tune this source…
L Open the link
y Copy the one-time code
o Open the email
Space Peek at this update under its line
s Pin or unpin this source’s latest email
Esc Dismiss the hint

Newsletters as an edition. b, e, D and A work on the item or link under the cursor; D and A preview first.

Key Action Note
g g, Home First conversation
G, End Last conversation
Ctrl+D, PageDown Half page down
Ctrl+U, PageUp Half page up
h, ArrowLeft Go to sidebar
j, ArrowDown Next
k, ArrowUp Previous
Enter Read
L Fetch the linked article
b Not now: later or snooze…
e Let go
D Unsubscribe… Shows the evidence and the method first; nothing is sent until you confirm
R Read in the sender’s layout
E Let go of everything shown… Previews the daemon’s dry run first; undo afterwards
o Open the email as sent
P This sender here: move to…
1 Edition
2 Later
3 Highlights
O Open in Marginalia
Esc Dismiss the hint

One item in a 66-character column. The article is fetched only on L or the Article tab.

Key Action Note
1 Edition
2 Later
3 Highlights
j, ArrowDown Scroll down
k, ArrowUp Scroll up
L Article or issue: switch between them
b Not now: later or snooze…
e Let go and go back
n Next item
R Sender’s layout or cleaned
" Highlight the paragraph at the top, or the selection
D Unsubscribe…
o Open the email as sent
O Open in Marginalia
Esc Back to the edition
Key Action Note
g g, Home First conversation
G, End Last conversation
Ctrl+D, PageDown Half page down
Ctrl+U, PageUp Half page up
h, ArrowLeft Go to sidebar
j, ArrowDown Next record
k, ArrowUp Previous record
/ Ask Archive
y Copy the reference
Y Copy the amount
Enter Open the document
o Open the email
p This issuer’s records
{ Previous year
} Next year
, Fix a field…
X Not a record
t Make a to-do from this record
g f Filter by kind The TUI steps to the next kind; the web’s filters also take issuer, year, amount, PDF and checked
Esc Close

The emails behind one of Now’s arrival counts. X (in Mail actions) moves the email under the cursor.

Key Action Note
P Send everything from this sender to…
j, ArrowDown Next
k, ArrowUp Previous
Enter, o Open conversation

While writing a message. ⌘ and Ctrl both work, on every platform.

Key Action Note
⌘Enter / Ctrl+Enter Send
⌘⇧Enter / Ctrl+Shift+Enter Send and archive
⌘⇧L / Ctrl+Shift+L Send later…
⌘S / Ctrl+S Save draft
⌘⇧S / Ctrl+Shift+S Save to server draft
⌘⇧R / Ctrl+Shift+R Refresh from daemon
⌘Backspace / Ctrl+Backspace, ⌘⇧Backspace / Ctrl+Shift+Backspace Discard draft
⌘⇧C / Ctrl+Shift+C Add Cc
⌘⇧B / Ctrl+Shift+B Add Bcc
⌘⇧A / Ctrl+Shift+A Attach files
⌘⇧G / Ctrl+Shift+G Insert signature
⌘; / Ctrl+; Insert snippet
⌘J / Ctrl+J Draft for me
⌘⇧F / Ctrl+Shift+F Toggle fullscreen

An open dialog takes every key until it closes. Esc closes any of them without changing anything, and so does q where nothing is typed; Enter presses the highlighted button, and in a yes-or-no question y is yes and n is no.

? opens it. Letters type into its filter.

Key Action Note
Esc, ? Close help

⌘K / Ctrl+K or : opens it. Letters type into its filter.

Key Action Note
Esc Close The browser’s own key
ArrowDown, Ctrl+N (macOS) Move down
ArrowUp, Ctrl+P (macOS) Move up
Enter Run the highlighted option The browser’s own key

/ opens it. Letters type the search.

Key Action Note
Esc Close The browser’s own key
ArrowDown, Ctrl+J Next result The TUI searches on its Search screen
ArrowUp, Ctrl+K Previous result The TUI searches on its Search screen
Enter Open the result The TUI searches on its Search screen
⌘Enter / Ctrl+Enter, Ctrl+ENTER (macOS) Search everything on the Search page The TUI searches on its Search screen

l labels and v moves. Letters type into its filter, and Enter ticks a label.

Key Action Note
Esc Close The browser’s own key
ArrowDown, Ctrl+N (macOS) Move down
ArrowUp, Ctrl+P (macOS) Move up
Enter Run the highlighted option The browser’s own key
⌘Enter / Ctrl+Enter Apply the ticked labels The web’s label picker ticks several labels with Enter, then applies them; the TUI’s picks one

Letters type into its filter, and Enter ticks or unticks a category; Preview shows the change before it applies.

Key Action Note
Esc Close The browser’s own key
ArrowDown, Ctrl+N (macOS) Move down
ArrowUp, Ctrl+P (macOS) Move up
Enter Run the highlighted option The browser’s own key

L opens it.

Key Action Note
Esc, q Close
j, ArrowDown Move down
k, ArrowUp Move up
Enter, o Open the link
y Copy the link

D opens it.

Key Action Note
Esc, q Close
n No
Enter, u, U Unsubscribe
e, E Unsubscribe and archive their mail

X moves this email; a capital moves everything from its sender.

Key Action Note
Esc, q Close
j, ArrowDown Move down
k, ArrowUp Move up
Enter Run the highlighted option The browser’s own key
m Move this email to Messages
x Move this email to To do
u Move this email to Updates
r Move this email to Reading
e Move this email to Archive
M Move the sender to Messages
U Move the sender to Updates
R Move the sender to Reading

P moves everything from the sender. Either case picks.

Key Action Note
Esc, q Close
j, ArrowDown Move down
k, ArrowUp Move up
Enter Run the highlighted option The browser’s own key
m, M Move the sender to Messages
u, U Move the sender to Updates
r, R Move the sender to Reading

X or P on a new sender: a capital answers its question (from P, either case does).

Key Action Note
Esc, q Close
j, ArrowDown Move down
k, ArrowUp Move up
Enter Run the highlighted option The browser’s own key
m Move this email to Messages
x Move this email to To do
u Move this email to Updates
r Move this email to Reading
e Move this email to Archive
M Answer: People
U Answer: Paper trail
R Answer: Reading
D Answer: Screened out

P in Reading. Either case picks.

Key Action Note
Esc, q Close
j, ArrowDown Move down
k, ArrowUp Move up
Enter Run the highlighted option The browser’s own key
m, M Move the sender to People
r, R Move the sender to Reading
u, U Move the sender to Paper trail
d, D Move the sender to Screened out
a, A Automatic: let the rules decide

b opens it on Later. Letters type a time of your own.

Key Action Note
Esc, q Close
ArrowDown, Ctrl+N (macOS) Move down
ArrowUp, Ctrl+P (macOS) Move up
Enter Run the highlighted option The browser’s own key
1, 2, 3, 4 Pick that time

X on a to-do.

Key Action Note
Esc, q Close
j, ArrowDown Move down
k, ArrowUp Move up
Enter Run the highlighted option The browser’s own key
1 Not a to-do
2 Not mine
3 Already done
4 Wrong details

After a Not-sure answer.

Key Action Note
y, Enter Yes, always for this sender
n, Esc No, this email only

Letters type when to bring it back; with nothing typed, Enter flags it for reply later.

Key Action Note
Esc Close The browser’s own key

Deleting a draft, rule, saved search or label. It opens on Keep, so a bare Enter deletes nothing.

Key Action Note
Esc, q Close
Enter Run the highlighted option The browser’s own key
y Yes
n No
Tab, Shift+Tab Light the other option The browser’s own key

A batch action over many conversations shows them first.

Key Action Note
Esc, q Close
Enter Run the highlighted option The browser’s own key
y Yes
n No
Tab, Shift+Tab Light the other option The browser’s own key

Sweeping a sender or a whole place. A whole place’s sweep opens on Cancel.

Key Action Note
Esc, q Close
Enter Run the highlighted option The browser’s own key
Tab, Shift+Tab Light the other option The browser’s own key

Letting go of everything in To do’s catch-up or in Updates.

Key Action Note
Esc, q Close
y Yes
n No

When the safety check found something. It opens on Cancel.

Key Action Note
Esc, q Close
Enter Run the highlighted option The browser’s own key
y Yes
n No
O, o Override the block and send once

Discarding a draft from the composer. It opens on Keep.

Key Action Note
Esc, q Close
y Yes
n No

The proof card in the assistant, while it has focus. Esc in the message box moves there.

Key Action Note
y Approve the waiting change
n Reject it, with a reason
x Show or hide its exact call
a Show all or fewer of its messages

Assistant: a question waiting for an answer

Section titled “Assistant: a question waiting for an answer”

The question card in the assistant, while it has focus. Number keys answer the first question not yet answered.

Key Action Note
1, 2, 3, 4, 5, 6, 7, 8, 9 Choose an answer by number
o Write your own answer
Enter Answer
s Skip the question
Esc, q Leave the question for later

The assistant’s history list.

Key Action Note
Enter Open the conversation
# Delete the conversation
Esc, q Close
j, ArrowDown Move down
k, ArrowUp Move up

A topic list, the people in a conversation, Search’s filters, a link preview or the side rail. Menus close with Esc too.

Key Action Note
Esc Close The TUI has no popovers: its panels are overlays or panes, which close with Esc or q
  • Input methods. Keys that belong to an input method’s composition are ignored. Enter that picks a candidate does not submit a field or run a shortcut, and Escape that cancels a composition does not close the highlight note.
  • Other layouts. A character you type with Option on macOS or AltGr elsewhere matches its binding as that character. # typed as Option-3 on a UK Mac works as #, and [ ] { } typed with AltGr on German and French layouts work. Alt with a plain letter or digit stays a chord.
  • Mistyped prefixes. After g, a key that completes no shortcut cancels the sequence and runs nothing. The status bar says g U is not a shortcut for two seconds. A modifier chord such as ⌘K still runs.
  • Held keys. Holding j or k repeats in every mode, not only the mail list. Every other action runs once per press.
  • Menus and dialogs. A shortcut pressed right after Esc closes a menu works at once. When Help or a dialog closes, focus returns to the pane you were in.

Settings → Keyboard lists every key. The pencil beside an action changes its keys: the new keys are checked as you type, any action already on them is named, and Save writes keys.toml through the daemon, so the TUI uses them too. Use the default keys puts an action back. The Single-key shortcuts switch turns every single-character shortcut off, ? included: ⌘K or Ctrl+K still opens the palette, and its Keyboard help says the switch is off. The web app reads your keys when it loads.