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.
The 10 keys that get you 80% of mxr
If you only learn ten, learn these:
Key
Action
:
Command palette — searchable surface for everything below (Ctrl-k too)
?
Help modal (context-aware)
j / k
Move down / up
Enter
Open selected message or thread
e
Archive
r
Reply
c
Compose
s
Star / unstar
b
Not now: Later with no time, a preset (1–4) or a typed time
/
Search
Everything else is discoverable from the palette (:) and the
help modal (?).
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:
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:
mxr keys check ~/dotfiles/mxr/keys.toml
$ mxr keys check 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.
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
[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
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, 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.
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+..
Keys that moved
Tools open with g and a capital in both clients: g R Rules, g D
Diagnostics, g P Deliveries, g C Settings (was g c and 0) and g Y
Activity (was g y). The digit tabs, 8, 9, g E, g p, the list’s H
and M, and raw headers’ g H retired; raw headers are in the palette. The
assistant is @ as well as ⌘., and Summarize folded into the briefing
(B).
The next wave moved these: Export
(E, in the mail list and Archive) and Updates’ sender sweep (S) are in the
palette; Archive’s mark checked (v) is in the , dialog; To do’s details
(v) is in the palette and on the row; Focus skips with j (was s); the
sidebar folds a section with Enter on its header (was [ and ]) and
jumps between sections with { and }; and the assistant’s history deletes
with # (was d). Every mode now takes g g, G, Ctrl+d and Ctrl+u.
Until 0.6.200: the Screener decides with its letters, a d f p, in
both clients (the digits 1 to 4 say so).
Until 0.6.204: in the Unsubscribe dialog, “and archive their mail” is e,
Archive’s letter, in both clients; a says so.
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
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.