Exploring SagaMail Features
Learn how to use SagaMail's core features like keyboard shortcuts, AI triage, and smart rules to manage your email efficiently.
const response = await fetch('http://localhost:8080/api/emails/archive/123', {
method: 'POST',
headers: { 'Authorization': 'Bearer YOUR_TOKEN' }
});
curl -X POST http://localhost:8080/api/emails/archive/123 \
-H "Authorization: Bearer YOUR_TOKEN"
{
"success": true,
"emailId": "123",
"action": "archived"
}
Overview
SagaMail reimagines email management on macOS with powerful, intuitive features. You navigate emails using Vim-inspired keyboard shortcuts, categorize messages with on-device AI triage, automate workflows via smart rules, create calendar events directly from emails, and handle multiple accounts with color-coded inboxes. These tools help you focus on what matters while keeping your data private on your Mac.
Keyboard Shortcuts
Move fast with j/k navigation and single-key actions.
AI Triage
Automatically sort emails into priority categories.
Smart Rules
Set up automations for labels, archiving, and more.
Calendar Integration
Turn emails into events with one click.
Multi-Account Management
Unified view with per-account colors.
REST API
Automate via local HTTP endpoints.
Keyboard Navigation
SagaMail's keyboard-first design uses familiar Vim keybindings. You press j to move down, k to move up, e to archive, s to star, and # to trash. Search with /.
Enable full keyboard mode in SagaMail > Preferences > Keyboard for global hotkeys.
Use these core shortcuts in the inbox:
| Action | Key | Description |
|---|---|---|
| Next email | j | Select the next message |
| Previous email | k | Select the previous message |
| Archive | e | Move to archive |
| Star | s | Toggle star |
| Trash | # | Delete permanently |
| Search | / | Open search bar |
Combine keys for power users:
r: Replyf: Forwardo: Open in new windowu: Undo last actiongg: Jump to topG: Jump to bottom
AI Triage
AI triage runs on-device to categorize incoming emails as urgent, actionable, informational, or noise. You review only high-priority messages first.
Enable AI Triage
Open SagaMail > Preferences > AI.
- Toggle
Enable AI Triage. - Select categories: Urgent, Actionable, etc.
- Choose auto-archive for
Noise.
Review Categorized Emails
Emails appear in color-coded sections:
```mermaid
graph TD
A[New Email] --> B[AI Triage]
B --> C[Urgent Red]
B --> D[Actionable Orange]
B --> E[Informational Blue]
B --> F[Noise Gray]
```
Smart Rules
Create rules to auto-label, archive, or forward emails based on sender, subject, or keywords. Rules process instantly on arrival.
Rules use simple JSON-like conditions.
{
"name": "Archive Newsletters",
"conditions": [
{"field": "subject", "operator": "contains", "value": "newsletter"},
{"field": "sender", "operator": "domain", "value": "@marketing.com"}
],
"actions": [
{"type": "archive"},
{"type": "label", "name": "Newsletters"}
]
}
// Trigger rule via REST API
fetch('http://localhost:8080/api/rules/trigger', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ ruleId: 'newsletter-rule' })
});
Calendar Integration
Extract events from emails and add them to Google, Apple, or Outlook calendars with one click.
Connect Calendars
In Preferences > Calendar:
- Add Google Calendar account
- Link Apple Calendar
- Sync Outlook via IMAP
Create Event from Email
Open an email with event details.
Press c or click the calendar icon.
Edit title, date, time, then save.
Multi-Account Management
Manage Gmail, Outlook, Yahoo, iCloud, and IMAP accounts in one unified inbox. Assign unique colors per account.
Add via OAuth:
OAuth2 configuration.
Use app password:
Basic {base64(email:password)}
Manual setup:
| Field | Value Example |
|---|---|
| Server | imap.example.com |
| Port | 993 |
| SSL | true |
REST API Automation
SagaMail exposes a local REST API at http://localhost:8080/api for scripting and Shortcuts integration.
Generate YOUR_TOKEN in Preferences > API. Keep it local—API binds to 127.0.0.1.
Last updated today
Built with Documentation.AI