Regards is a local-first, open-source email client for Windows, macOS and Linux. It offers a calm, sectioned inbox, done / pin / set aside, snooze, reminders, send later, undo everywhere, and a safe interface for AI agents. It is built with a Rust core, Tauri 2 and React.
Website: regards-two.vercel.app (en français)
Status: pre-alpha. It reads, sorts and sends mail every day, but has no signed installers or live tests on real providers yet. What works today:
- Accounts: any IMAP host with a password or app password (kept in the OS credential store), changed in place when it rotates; Microsoft and Google sign-in (OAuth) in builds made with their client ids (docs/oauth-setup.md).
- Sync: every folder, newest first and then older mail in the background. New inbox mail arrives by push (IMAP IDLE); the other folders follow within minutes.
- The inbox: by priority, by category or by date; new senders screened; done, pin, set aside, snooze and reminders, all with undo; one row per message for now (conversations open whole).
- Reading: HTML mail in a sandboxed frame with remote images blocked until you allow them, quoted history folded, a dark page in the dark theme; conversations across folders.
- Writing: formatted text, attachments and pasted images, signatures and templates, send later and undo send, from any of your addresses; mail waits in the Outbox when offline.
- Search of everything on this device and on the servers.
- Agents: the
regardsCLI and an MCP server, with per-account access, approvals and an activity log with undo (docs/agents.md).- Desktop: notifications, a taskbar badge, background mode in the tray,
mailto:links. Press?in the app for the keys.Coming: sending while the computer is off (1.1, ADR-0019). See the plan.
- One background service per user (the daemon) owns all mail data. The desktop app, the
regardsCLI and the MCP server for agents all talk to it (ADR-0005). - The local API is JSON-RPC over a per-user Windows named pipe (current user only) or a Unix socket (
0600). There is no TCP port (ADR-0006). - Storage:
- Mail data: SQLite (
mail.db) in the data directory, migrated automatically, with a backup before every migration. The directory is private to the user. - Passwords: the OS credential store (Credential Manager, Keychain or Secret Service). They are never written to the database or the logs (ADR-0008).
- Mail data: SQLite (
- Regards 1.0 is fully local: no Regards servers and no telemetry. Sending while the computer is off arrives in 1.1 (ADR-0019).
All architecture decisions are in docs/adr/. Research is in docs/research/.
Requirements:
- Rust (stable; the toolchain is pinned in
rust-toolchain.toml) - Node.js 22 or newer (for the desktop UI)
- Windows: Visual Studio Build Tools with "Desktop development with C++" (the WebView2 runtime ships with Windows 10/11)
- Linux:
build-essentialplus the Tauri system libraries, for example on Debian/Ubuntu:libwebkit2gtk-4.1-dev libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev
cargo build --workspace
cargo test --workspaceTests against a real IMAP server are opt-in. They run in CI against Dovecot in Docker; to run them locally, start the container from spikes/imap-trial, then:
REGARDS_TEST_IMAP=localhost:31993 REGARDS_TEST_IMAP_CA=/path/to/ca.pem \
cargo test -p regards-imap -p regards-daemon -- --ignored live_Desktop app (development mode with hot reload):
cd apps/desktop
npm install
npm run tauri devtauri dev builds the regards CLI first. The app starts the daemon from the regards program next to its own executable, which is also where installers will put it. Set REGARDS_DAEMON_BIN to use a different program.
To work on the interface without a mail server, run npm run dev and open http://localhost:1420/preview.html in a browser. It shows the app with made-up sample mail, and the actions work on that sample. Add ?accounts=2 for two accounts, ?accounts=0 for the first-run screen, ?theme=dark, ?layout=single to open messages in place of the list, ?sidebar=icons for the folded sidebar, or ?screen=off or ?screen=hold for how new senders are shown. The preview is not part of the app build.
Actions in the app change your real mailbox, and "Delete forever" is permanent. To try things safely, use the Dovecot container from spikes/imap-trial: start the app with REGARDS_DEV_EXTRA_CA=/path/to/ca.pem (development builds only), then add an account on localhost, port 31993, with any user name and the password pass.
regards daemon start # start it in the background (no-op if it is running)
regards daemon run # or run it in the foreground (Ctrl+C to stop)
regards daemon status # add --json for machine output
regards daemon stop
regards versionA daemon started in the background logs to logs/daemon.log in the data directory. The desktop app logs what it could not do, and where it stopped if it ever does, to logs/app.log beside it. Neither holds mail, passwords, tokens or addresses, and Settings › Support › export puts both in a file you choose.
Add accounts in the desktop app.
- The check: Regards first signs in to the IMAP server (TLS, usually port 993) to check the details. Only then does it save the account.
- The password: it goes to the OS credential store.
The CLI cannot add accounts: only the app may change accounts and credentials (ADR-0006).
Testing against a local server: to try it against a local test server with its own CA, for example the Dovecot container from spikes/imap-trial, point a debug build at the CA:
REGARDS_DEV_EXTRA_CA=/path/to/ca.pem REGARDS_DATA_DIR=/tmp/regards-dev npm run tauri devRelease builds ignore REGARDS_DEV_EXTRA_CA.
The desktop app owns the daemon it uses. Only a daemon the app started itself can give it desktop access (ADR-0006). When the app finds a daemon started some other way, for example by regards daemon run, it replaces it with its own. Closing the window leaves Regards in the tray (background mode, on by default), so mail keeps arriving and scheduled mail goes out; Quit stops the app and its daemon.
During development, point Regards at a throwaway data directory so it never touches real data:
REGARDS_DATA_DIR=/tmp/regards-dev regards daemon run # macOS / Linux
$env:REGARDS_DATA_DIR="$env:TEMP\regards-dev"; regards daemon run # Windows PowerShellSet REGARDS_LOG=debug for verbose daemon logs.
daemon status exit codes: 0 running, 3 not running. daemon run exits with 4 when another daemon already owns the data directory.
The Windows installers are to be signed through the SignPath Foundation's free programme for open-source projects. What is signed, by whom and how: Code signing policy.
Read CONTRIBUTING.md first. It covers the clean-room rules, which every contribution must follow, and the Signed-off-by requirement (DCO).
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE)
- MIT licence (LICENSE-MIT)
at your option. Unless you explicitly state otherwise, any contribution you intentionally submit for inclusion in Regards, as defined in the Apache-2.0 licence, is dual licensed as above, without additional terms or conditions.