Documentation

Kestrel Mail Help

How to set up the app, get around your mail, and make the most of Kestrel's features.

Updated March 27, 2026

Getting started

Kestrel Mail uses a three-column layout: your mailboxes in the sidebar, conversations in the middle, and the selected message or thread on the right.

  • Add accounts from Settings > Accounts.
  • Use Unified Inbox when you want one inbox across all your accounts.
  • Open Compose to start a new message, then choose the sending account from the From picker when needed.

Adding an account

To add an email account:

  1. Open Settings (⌘,) and go to Accounts.
  2. Click the + button and enter your email address.
  3. Kestrel detects your provider automatically. Gmail and Microsoft 365 open a sign-in page. iCloud uses a streamlined preset flow. Other providers prompt you for server details.
  4. Once signed in, your folders and messages start syncing right away.

You can add as many accounts as you need. Each one gets its own set of folders in the sidebar, and the Unified Inbox combines them all into one view.

Reading and organizing mail

Click a conversation to read it. If a conversation has multiple messages, they're threaded together and you can expand or collapse individual messages.

  • Move to a folder — drag a conversation from the list onto any folder in the sidebar.
  • Archive — press e or use the toolbar.
  • Trash — press Delete or #.
  • Star — press s to star or unstar. Starred messages appear in the Starred mailbox.
  • Mark as junk — press ! to move a message to Junk (or back to Inbox if it's already there).
  • Mark read / unread — press ⇧I to mark read or ⇧U to mark unread.

Summaries

Kestrel can summarize individual messages and entire conversation threads. Summaries appear as a short list of highlights — the key points from a single message, or a per-sender breakdown for threads with multiple participants.

Summaries run on your Mac through Apple Intelligence. Nothing is sent to a server. There's also an optional enhanced model pack you can download in Settings > General for better results on longer threads — it's a one-time download that stays on your Mac.

Swipe actions

Swipe left or right on a conversation row to quickly archive, trash, star, or mark as read. You can customize which actions appear on each side and what order they're in from Settings > Viewing.

Unsubscribe

When Kestrel detects that a message includes an unsubscribe option, it shows an Unsubscribe button in the message view. One click sends the unsubscribe request — no need to scroll through the email looking for a tiny link.

Rules

Rules let you automatically act on incoming messages. Set them up in Settings > Rules.

  • Match messages by sender, subject, recipient, or other conditions.
  • Actions include move to a folder, star, mark as read, and more.
  • Rules run automatically when new messages arrive.

Everyday shortcuts

Kestrel uses single-key shortcuts for common actions and standard Mac shortcuts for everything else. Here's a quick reference.

j
Next conversation
k
Previous conversation
o
Open the selected conversation
c
Compose a new message
r
Reply
a
Reply all
f
Forward
e
Archive
Delete or #
Move to trash
!
Mark as junk or not junk
s
Star or unstar
⇧I
Mark as read
⇧U
Mark as unread

Search and navigation

/
Jump to the mailbox search field
⌘⇧F
Search mailboxes
⌘F
Find inside the current message
⌘G
Find next in the current message
⌘⇧G
Find previous in the current message
⌘I
Go to Inbox
⌘⇧S
Go to Starred
⌘R
Refresh the current mailbox

Search supports plain keywords as well as operators like from:, to:, and has:attachment. You can also type natural-language queries like "emails from Sarah last week" and Kestrel will figure out what you mean.

Compose

The compose window floats independently, so you can keep drafting while moving around the app. Switch the sending account with the From picker, reveal Cc and Bcc when you need them, and drag recipients between fields.

⌘↩
Send
⌘B
Bold
⌘I
Italic
⌘U
Underline
⌘K
Insert link
⌘⇧X
Strikethrough
⌘⇧7
Numbered list
⌘⇧8
Bulleted list
⌘⇧9
Quote block
⌘⇧C
Monospace / code style
⌘⇧\
Clear formatting

Attachments and message viewing

Attachments work the way you'd expect on a Mac. If an attachment has been viewed before, it's cached locally and available even when you're offline.

Space
Quick Look the selected attachment

Use the attachment context menu to Open, Open With, Share, or save. You can also save directly to Downloads or choose a location with a save panel.

Settings and account management

Open Settings with ⌘, to manage accounts, preferences, mail rules, and advanced options. Adding new accounts and changing server settings are both in the Accounts tab.