CLI for managing JMAP mail via Claude Code for inbox zero
  • Rust 99%
  • Nix 1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Allison Bentley 60b89b93b8
config: store password in Secret Service, add password_command fallback
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.
2026-09-30 23:14:43 +01:00
src config: store password in Secret Service, add password_command fallback 2026-09-30 23:14:43 +01:00
.gitignore Initial vibemail MVP 2026-04-18 14:54:35 +01:00
Cargo.lock config: store password in Secret Service, add password_command fallback 2026-09-30 23:14:43 +01:00
Cargo.toml config: store password in Secret Service, add password_command fallback 2026-09-30 23:14:43 +01:00
flake.lock Initial vibemail MVP 2026-04-18 14:54:35 +01:00
flake.nix config: store password in Secret Service, add password_command fallback 2026-09-30 23:14:43 +01:00
LICENSE Initial vibemail MVP 2026-04-18 14:54:35 +01:00
README.md config: store password in Secret Service, add password_command fallback 2026-09-30 23:14:43 +01:00

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 init stores it under service vibemail, 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'.