osfeed.dev
Use with your agentConnect an agent
Projects/huacnlee / omamail

Omamail

A keyboard-driven email and calendar app for Omarchy

by@huacnlee
Get it on GitHub
Unclaimed

This page was written by @iluxav from public sources, last updated for v0.10.8 (2026-10-01), and may lag behind new releases.

Are you @huacnlee?Claim this page to keep it up to date
v0.10.8 · 12 things you can do 2 changes to know before upgrading
Follow GitHub

Read, search and answer mail from Gmail, Outlook, HEY, JMAP and IMAP accounts, and manage your calendar, in a native keyboard-driven window instead of a browser tab.

Omamail's three-column window reading a message, with the AI assistance panel open.The Omamail calendar showing a week of events.Writing a new message in the Omamail composer.

What you can do with Omamail

Read, search, archive, star and reply to mail from several accounts in one window.

Since v0.4.1
Good to know

Gmail needs your own Google OAuth client; HEY has no archive or star.

Move through, file and answer mail without the mouse.

Since v0.4.1

See your unread count in the Omarchy bar and get a notification when mail arrives, with the window closed.

Since v0.4.1

Answer meeting invitations with Yes, Maybe or No from the message.

Since v0.4.1
Good to know

Not on HEY.

Unsubscribe from a newsletter in one click without leaving the window.

Since v0.4.1
Good to know

Only for lists that support one-click unsubscribing; others get a message or open a page.

Write mail with attachments and Bcc, from any connected address, including from mailto: links.

Since v0.6.0

See and edit your accounts' calendars next to your mail.

Since v0.6.0

Save drafts to the mail server, reopen them later, and undo a send during a short delay.

Since v0.6.0
Show all 12

Install Omamail as a standalone desktop app on macOS, Linux or Windows.

Since v0.10.4
Good to know

No system tray, AI assistance or mailto: registration in the standalone app; macOS and Windows builds are unsigned.

Read mail, act on messages and send from the command line with JSON output.

Since v0.10.4
Good to know

Dry-run by default.

Set Omamail as the default mail client for mailto: links and Omarchy's mail keys.

Since v0.10.8

Ask an AI agent about selected messages and get suggested drafts to review.

ExperimentalSince v0.10.4
Good to know

Uses the configured Omarchy agent; not in the standalone app.

Before you upgrade Omamail

Newest first
Omamail release history 6
v0.10.8

Make Omamail the default mail client so mailto: links and Super+Shift+E open it.

Details

Settings > Default mail client binds mailto:, SUPER+SHIFT+E and SUPER+SHIFT+ALT+E in a marked block of ~/.config/hypr/bindings.lua, with Undo. The calendar is redesigned with Month, Week, Day and Agenda views and deeper Google Calendar support with reminders. AI chat works with Claude, Codex or OpenCode. Account-wide IMAP search and All mail. Groups v0.10.7 and v0.10.8.

Also: Locked GNOME Keyring entries are unlocked instead of signing out; Proton Bridge negotiates STARTTLS first; replies to your own sent mail go to the original recipients.

v0.10.8.

Added: Set Omamail as the default mail client for mailto:…Improved: See and edit your accounts' calendars next to your…Improved: Ask an AI agent about selected messages and get sug…Improved: Read, search, archive, star and reply to mail from…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v0.10.6

Get new IMAP and Outlook mail within seconds of it arriving, on servers that support IMAP IDLE.

Details

IMAP IDLE wakes the mail check when INBOX changes; Microsoft and iCloud mailboxes discover their calendars without entering addresses; Windows-1251, GB2312 and other legacy charsets decode. Groups v0.10.5 and v0.10.6.

Also: The login keyring no longer crashes during credential reads; new-mail notifications work with scoped shell APIs.

v0.10.6.

Improved: See your unread count in the Omarchy bar and get a…Improved: See and edit your accounts' calendars next to your…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v0.10.4

Run Omamail as a standalone desktop app on macOS, Linux or Windows as well as an Omarchy plugin.

Details

v0.8.2 adds JMAP accounts with push, personal Outlook.com/Hotmail sign-in, an All Mailboxes view and multi-select. v0.9.0 moves mail networking to a pinned Rust backend that you install when prompted, and adds AI assistance through the Omarchy agent, label management, Microsoft 365 work accounts with Graph sending, and Outlook calendars. v0.10.x adds the standalone app and CLI commands with JSON output. Groups v0.8.2 to v0.10.4.

v0.10.4. Plugin backends for Linux x86_64 and aarch64; standalone installers via curl -fsSL https://huacnlee.github.io/omamail/install.sh | sh or install.ps1 on Windows; the macOS and Windows builds are unsigned.

Added: Install Omamail as a standalone desktop app on macO…Improved: Read, search, archive, star and reply to mail from…Added: Ask an AI agent about selected messages and get sug…Added: Read mail, act on messages and send from the comman…Action required / inferred

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v0.8.1

Give each mailbox its own signature and send-as aliases, and reach STARTTLS servers such as iCloud on port 587.

Details

IMAP send-as aliases, STARTTLS for IMAP and SMTP, a Contacts button filling recipients from Thunderbird or contacts.json/.vcf, a unified calendar view, per-mailbox signatures, Spam/Junk on the rail, v to move to a label or folder, saving attachments, and naming a mailbox. Groups v0.7.0 to v0.8.1.

Also: Failed sends return to the composer; sent mail carries Message-ID and Date; the bar icon can be hidden; mail with a wrong charset header reads correctly.

v0.8.1, a security update recommended for all earlier versions.

Improved: Write mail with attachments and Bcc, from any conne…Now works: Read, search, archive, star and reply to mail from…Improved: Move through, file and answer mail without the mous…Improved: See and edit your accounts' calendars next to your…Action required

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v0.6.0

Attach files and send from any of your addresses, including from mailto: links elsewhere on the desktop.

Details

Compose opens from mailto: links, picks From across mailboxes, adds Bcc and attachments by choosing, dropping or pasting; account calendars and delayed send with undo; a Reader view next to Original and Plain. v0.6.0 adds drafts saved to the provider and reopened from Drafts, Alt+Z to undo a queued send, calendar event editing and Proton Mail Bridge with custom domains. Groups v0.5.0 and v0.6.0.

v0.6.0.

Added: Write mail with attachments and Bcc, from any conne…Added: See and edit your accounts' calendars next to your…Added: Save drafts to the mail server, reopen them later,…Improved: Read, search, archive, star and reply to mail from…

Seeded by @iluxav with Claude Code (canido)

Read the evidence
v0.4.1
First release

Read and answer Gmail, HEY and IMAP mail in a native Omarchy window driven from the keyboard.

Details

First releases (v0.1.0 to v0.4.1). A Quickshell plugin with an unread badge in the bar and a three-column window; Gmail over the Gmail API, HEY through the hey CLI (v0.4.0) and any IMAP/SMTP server with an app password. Keys: j/k, e archive, s star, r reply, c compose, Alt+1..0 mailboxes, Alt+A switch account, / search, ? help.

Also: Credentials kept in GNOME Keyring; remote images blocked until you load them for a message.

Omarchy 4 plugin: omarchy plugin add https://github.com/huacnlee/omamail.git --enable.

Added: Read, search, archive, star and reply to mail from…Added: Move through, file and answer mail without the mous…Added: See your unread count in the Omarchy bar and get a…Added: Answer meeting invitations with Yes, Maybe or No fr…Added: Unsubscribe from a newsletter in one click without…

Seeded by @iluxav with Claude Code (canido)

Read the evidence