Skip to content
mxr

Labels and saved searches

Labels

Labels are first-class in both CLI and TUI.

CLI:

Terminal window
mxr labels
mxr labels create FollowUp --color "#ff6600"
mxr labels rename FollowUp Waiting
mxr labels delete Waiting

Per-message mutations:

Terminal window
mxr label Work MESSAGE_ID
mxr unlabel Work MESSAGE_ID
mxr move Archive MESSAGE_ID

Search-driven bulk mutations:

Terminal window
mxr label FollowUp --search "from:recruiter@example.com"
mxr move Done --search "label:inbox from:billing@example.com"

TUI label flows

  • l: apply label
  • v: move to label
  • Sidebar labels change mailbox scope
  • Open messages and thread headers show label chips

The sidebar separates:

  • System labels
  • User labels
  • Saved searches

Saved searches

Saved searches are reusable mailbox scopes.

CLI:

Terminal window
mxr saved
mxr saved add recruiters "label:inbox from:recruiter@example.com"
mxr saved delete recruiters
mxr saved run recruiters

TUI:

  • Saved searches appear in the sidebar
  • Saved searches are reachable through the command palette
  • Selecting one changes the mail list to that query scope

Why saved searches matter

Folders are not enough for high-volume mail. Saved searches let you treat search as a stable view:

  • Waiting for reply
  • Unread invoices
  • Recruiter follow-up
  • Production alerts
  • Travel receipts