Skip to content

Keys at a glance

The default map, grouped by what you are doing. Every action is rebindable under [keys] (see keys), and ? in the app always renders your effective map, overrides included. Movement takes vi-style counts (4j).

Moving

Key Action Does
J / K move-down / move-up move the selection
gg / G top / bottom jump to either end
Ctrl+D / Ctrl+U half-page-down / half-page-up page
Enter open open the message (scrolls in the pager)
Esc back back out (list: leave a thread view)
Q quit quit

Finding

Key Action Does
/ search notmuch query in the current scope
: command command prompt
gt / gT next-account / previous-account cycle scope
Ctrl+N / Ctrl+P sidebar-next / sidebar-previous move the sidebar highlight
Ctrl+O sidebar-open open the highlighted entry
Shift+B toggle-sidebar show or hide the sidebar
Shift+T thread-view pivot onto the thread; Esc returns

Acting on mail

Key Action Does
M toggle-read flip read/unread on the message
Shift+M mark-all-read mark the whole listing read
Shift+F toggle-flagged flag or unflag
A archive file to the account's archive folder
C move-to folder picker; :move <name> by name
D delete-message to trash; inside trash, delete with confirm
S sync ask the daemon for a pass now

Reading

Key Action Does
H toggle-html plain or HTML rendering
T toggle-headers configured headers or all of them
O open-link numbered link picker
V attachments expand the attachment drawer
Shift+J / Shift+K pane-down / pane-up scroll the reading pane
P cycle-reading-pane pane below, right, off

Writing

Key Action Does
N compose fresh message
R reply reply to the sender
Shift+R reply-all sender plus every other recipient
Shift+L reply-list reply to the mailing list
F forward forward; F lands in the list when sent

Inside a compose, the stage's keys always sit in the status line: Tab moves fields, Ctrl+E toggles fields and editor, and the review screen answers Y send, Q draft, E / H edit, A attach, S / X seal.

Everything else

Key Action Does
? help the live cheatsheet
Shift+, settings accounts, essentials and folder aliases

Commands

Typed at the : prompt.

Command Does
:settings accounts and essentials, in-app
:theme <name> switch and persist a theme; bare lists them
:move <folder> move the message by folder name or alias
:template <name> compose from a named template
:resume <path> reopen a saved draft
:sign :nosign :encrypt :noencrypt arm the next compose
:accept :tentative :decline answer the open invite
:unsubscribe act on the open message's List-Unsubscribe
:save-patches <path> / :apply <repo> patch series out / git am in
:q quit