-
Notifications
You must be signed in to change notification settings - Fork 0
Home
A Mac email client where an AI agent has already read every message before you open the app. Drafts the replies, sorts the noise, and surfaces a tight queue of decisions for you to confirm.
This wiki is for users (install, troubleshooting, FAQ) and developers (architecture, releases, signing). The repo's README.md and DEVELOPER.md hold the canonical product overview and technical reference; this wiki is the operational companion.
- Getting Started — download, install, first-launch setup.
- FAQ — the questions people actually ask.
- Troubleshooting — notifications, sync, OAuth, login issues — and the exact commands to fix each.
- Privacy & Data — what we store, where, and how to wipe it.
- Architecture — Tauri shell + Node sidecar + React renderer, with the contracts between each.
- Building from Source — toolchain prerequisites, dev loop, common build pitfalls.
- Release Process — the automated GitHub Actions pipeline, end to end.
- Updater Keys and Signing — Apple Developer ID + Tauri minisign, rotation, recovery.
- Contributing — PR workflow, code style, what reviewers look for.
- Roadmap — what's next.
AOS Mail is a Mac email client where an agent (Claude, or any OpenAI-compatible model via OpenRouter) has already triaged your overnight mail before you open the app. It tells you what's important, drafts the replies in your voice, sorts the noise, and surfaces decisions for you to confirm. It supports Gmail (OAuth) and any IMAP provider (iCloud, Fastmail, Outlook, custom domains). It's a real native Mac app — signed, notarized, Keychain-backed — not a web wrapper.
Active development. Current shipped version: v0.1.8 (Apple Silicon only; Intel support is on the roadmap). See Releases for changelog and downloads.
AOS Mail is a fork of Exo by Ankit Gupta. Where Exo is "Claude Code for your inbox" in a polished Electron app, AOS Mail is a full rewrite of the shell into Tauri 2 + Node sidecar with IMAP support, a wider agent surface (morning briefing, smart-action, awaiting-reply, learned rules), calendar UI, an extensions system, and an automated signed-release pipeline. Same BUSL-1.1 license as upstream.
BUSL-1.1. Free for personal and internal-organization use. Commercial use requires a separate license. Becomes Apache 2.0 on January 1, 2033.