@yupingwang/mailcli
v0.1.0
Published
IMAP/SMTP CLI for generic mail servers
Readme
mailcli (Node.js)
A TypeScript/Node.js IMAP/SMTP CLI for generic mail servers.
Install
npm install
npm run buildRun locally:
npm run dev -- --helpAfter build:
node dist/index.js --helpConfig
Config file path:
~/.config/mailcli/config.yamlEnvironment variable overrides use MAILCLI_ prefix:
MAILCLI_IMAP_HOST=imap.example.com
MAILCLI_SMTP_HOST=smtp.example.com
[email protected]
MAILCLI_AUTH_PASSWORD=app-password
MAILCLI_KEYRING_PASSWORD=your-secret-passphrasePasswords are stored in encrypted file backend under:
~/.config/mailcli/keyring/secrets.jsonCommands
mailcli auth login --imap-host ... --smtp-host ... --username ... --password ...
mailcli status
mailcli inbox list --page 1 --page-size 20
mailcli mail list --mailbox Archive
mailcli search "invoice" --mailbox INBOX
mailcli read 12345
mailcli send --to "[email protected]" --subject "Hi" --body "Hello"
mailcli draft save --to "[email protected]" --subject "Draft" --body "WIP"
mailcli draft list
mailcli draft send 42
mailcli delete 12345
mailcli move 12345 Archive
mailcli tag 12345 FollowUp
mailcli mailboxes list
mailcli mailboxes create "Project X"
mailcli attachments download 12345 --output ./attachments
mailcli config show
mailcli config editCompatibility Notes
- Command shape and flags follow the Go
mailclibaseline. auth keyringis intentionally removed in this Node implementation.--threadscurrently falls back to message listing when server-side thread API is unavailable.
