Jump Quickly to a Virtual Mailbox

Prerequisites

1. Notmuch virtual mailboxes configured in NeoMutt (see Getting Started with Notmuch Virtual Mailboxes).

Jump with a Macro

1. Create macros that jump directly to specific virtual mailboxes:

macro index gi "<change-folder>notmuch://?query=tag:inbox<Enter>"            "Jump to Inbox"
macro index gu "<change-folder>notmuch://?query=tag:inbox and tag:unread<Enter>" "Jump to Unread"
macro index gf "<change-folder>notmuch://?query=tag:flagged<Enter>"          "Jump to Flagged"

2. Press gi, gu, or gf in the index.

Expected result: NeoMutt opens the matching virtual mailbox immediately.

Use change-vfolder to Cycle

1. Bind the <change-vfolder> function:

bind index,pager X change-vfolder

2. Press X and type the label of a virtual mailbox (e.g. Inbox), or press <Enter> to jump to the next virtual folder with unread messages.

Expected result: NeoMutt switches to the named virtual mailbox.

Run an Ad-Hoc Query

1. Bind <vfolder-from-query>:

bind index,pager \eX vfolder-from-query

2. Press Alt-X, type a Notmuch query, and press <Enter>.

Expected result: NeoMutt opens a temporary virtual mailbox for that query.

Navigate with the Sidebar

If the sidebar is enabled, virtual mailboxes appear alongside regular mailboxes.

1. Use sidebar navigation keys to move between them:

bind index,pager \CP sidebar-prev
bind index,pager \CN sidebar-next
bind index,pager \CO sidebar-open

2. Press Ctrl-N / Ctrl-P to highlight, then Ctrl-O to open.

Expected result: you can switch between virtual mailboxes without typing queries.

See Sidebar Workflows for more navigation tips.