CLI for managing JMAP mail via Claude Code for inbox zero
- Rust 99%
- Nix 1%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
keyring's linux-native backend is the kernel keyutils store, which is memory-only and loses the password on reboot. Switch Linux to the freedesktop Secret Service (gnome-keyring, KWallet, KeePassXC). Add an optional `password_command` to [jmap] for hosts without a Secret Service daemon: run via `sh -c`, stdout is the password. It takes precedence over the keychain when set. `vibemail init --password-command` writes it to the config instead of touching the keychain. Also replace the macOS-only hint in the missing-entry error and swap the unused libsecret build input for dbus. |
||
| src | ||
| .gitignore | ||
| Cargo.lock | ||
| Cargo.toml | ||
| flake.lock | ||
| flake.nix | ||
| LICENSE | ||
| README.md | ||
vibemail
CLI for managing JMAP mail, designed to be driven by Claude Code for inbox zero.
Commands
| Subcommand | Auto-accept? | Description | Flags |
|---|---|---|---|
init |
manual | Interactive first-run setup — prompts for JMAP URL, username, password; tests connection; writes config and stores password in OS keychain (or saves a password_command instead). |
--url, --username, --override-url, --password-command, -f/--force |
list |
auto | List emails from inbox (or archive). Filter by class, read state, date, subscription status; paginate. | --archive, --unread, --read, --list, --not-list, --auto, --not-auto, --has-unsub, --no-unsub, --since, --until, -n/--limit, --page |
search |
auto | Full-text / per-field search across inbox, archive, or both. Same filters as list plus sender/subject/body/attachment criteria. | <query>, --in, --from, --to, --subject, --body, --has-attachment, --unread, --read, --list, --not-list, --auto, --not-auto, --has-unsub, --no-unsub, --since, --until, -n/--limit, --page |
read |
auto | Read one or more emails — headers + body text (HTML-rendered) + attachment/image paths. Body truncated to ~2KB unless --full. Multi-ID native; accepts - for stdin. |
<ids...>, --full, --no-download |
archive |
auto | Move emails from inbox to archive. Thread-level by default, --message for per-message. Reversible via unarchive. Multi-ID, stdin via -. |
<ids...>, --message |
unarchive |
auto | Inverse of archive — move emails from archive back to inbox. Thread-level by default, --message for per-message. |
<ids...>, --message |
mark-read |
auto | Add $seen keyword (mark as read / deferred). Thread-level by default, --message for per-message. Reversible. |
<ids...>, --message |
mark-unread |
auto | Remove $seen keyword (re-promote to new / unread). Thread-level by default, --message for per-message. Reversible. |
<ids...>, --message |
unsubscribe |
manual | RFC 8058 one-click unsubscribe. Multi-ID native; optional post-archive of successful unsubs. | <ids...>, --archive, --dry-run, --sleep-ms |
debug |
manual | Low-level JMAP probing — dump session doc, enumerate mailboxes, or send arbitrary method calls. rpc variant can mutate, so not auto-safe. |
session, mailboxes, rpc <method> [args] |
Password storage
The password is never written to config.toml. It comes from one of:
-
OS keychain (default): the macOS Keychain, or the freedesktop Secret Service on Linux (gnome-keyring, KWallet, KeePassXC).
vibemail initstores it under servicevibemail, keyed by username. -
password_command: a shell command whose stdout is the password. Takes precedence over the keychain when set, so it works on headless hosts with no Secret Service daemon:[jmap] url = "https://mail.example.com" username = "you" password_command = "rbw get mail.example.com"Or set it during setup:
vibemail init --password-command 'rbw get mail.example.com'.