mailos

EmailOS - A standardized email client CLI with support for multiple providers

Installation

npm install -g mailos

Requirements

• Node.js 14.0.0 or higher
• Go 1.21 or higher (for building from source)

Quick Start

1. Setup your email account:

   mailos setup

2. Send an email:

   mailos send -t [email protected] -s "Hello" -b "This is a test email"

3. Read emails:

   mailos read -n 10

Features

• 📧 Multiple email provider support (Gmail, Fastmail, Zoho, Outlook, Yahoo)
• 📝 Markdown email composition (automatically converted to HTML)
• 🔍 Advanced email search and filtering
• 📎 Attachment support
• 🔗 Unsubscribe link detection
• 💾 Export emails to markdown files
• 🔒 Secure credential storage

Commands

Setup

mailos setup

Interactive setup wizard to configure your email account.

Send

mailos send -t [email protected] -s "Subject" -b "Body"

# With attachments
mailos send -t [email protected] -s "Files" -b "See attached" -a file1.pdf -a file2.docx

# With CC and BCC
mailos send -t [email protected] -c [email protected] -B [email protected] -s "Subject" -b "Body"

Read

# Read last 10 emails
mailos read

# Read unread emails
mailos read --unread

# Search by sender
mailos read --from [email protected]

# Save as markdown files
mailos read --save-markdown --output-dir emails/

Mark as Read

# Mark specific emails
mailos mark-read --ids 1,2,3

# Mark all from sender
mailos mark-read --from [email protected]

Delete

# Delete specific emails
mailos delete --ids 1,2,3 --confirm

# Delete all from sender
mailos delete --from [email protected] --confirm

Unsubscribe

# Find unsubscribe links
mailos unsubscribe --from [email protected]

# Open unsubscribe link in browser
mailos unsubscribe --from [email protected] --open

Configuration

Configuration is stored in ~/.email/config.json or in a local .email/config.json file.

Building from Source

If you want to build from source instead of using pre-built binaries:

1. Clone the repository
2. Install Go 1.21+
3. Run npm install -g . from the npm directory

License

MIT

Support

For issues and feature requests, visit: https://github.com/anduimagui/emailos/issues