{"content":"# aux4/email\n\nEmail client for listing, reading, sending emails and managing attachments via IMAP and SMTP. Works with Gmail, Outlook, Yahoo, and any provider that supports IMAP/SMTP.\n\n## Installation\n\n``bash\naux4 aux4 pkger install aux4/email\n`\n\n## Configuration\n\nCreate the config file at ~/.config/aux4/email.yaml:\n\n`yaml\nimap:\n host: imap.gmail.com\n port: \"993\"\nsmtp:\n host: smtp.gmail.com\n port: \"465\"\nuser: your.email@gmail.com\npassword: xxxx xxxx xxxx xxxx\n`\n\n### Provider Examples\n\n**Gmail:**\n`yaml\nimap:\n host: imap.gmail.com\n port: \"993\"\nsmtp:\n host: smtp.gmail.com\n port: \"465\"\nuser: your.email@gmail.com\npassword: xxxx xxxx xxxx xxxx\n`\n\n**Outlook:**\n`yaml\nimap:\n host: outlook.office365.com\n port: \"993\"\nsmtp:\n host: smtp.office365.com\n port: \"587\"\nuser: your.email@outlook.com\npassword: xxxx xxxx xxxx xxxx\n`\n\n**Yahoo:**\n`yaml\nimap:\n host: imap.mail.yahoo.com\n port: \"993\"\nsmtp:\n host: smtp.mail.yahoo.com\n port: \"465\"\nuser: your.email@yahoo.com\npassword: xxxx xxxx xxxx xxxx\n`\n\n> **Note:** Most providers require an app-specific password instead of your regular account password. See your provider's documentation for generating app passwords.\n\n## Usage\n\n### List Emails\n\n`bash\n# List latest 20 emails\naux4 email list all\n\n# List more emails\naux4 email list all --limit 50\n\n# List emails from a specific sender\naux4 email list from user@example.com\n\n# List from a different mailbox\naux4 email list all --mailbox Sent\n`\n\n### Read an Email\n\n`bash\naux4 email read 12345\n`\n\n### Send an Email\n\n`bash\naux4 email send --to recipient@example.com --subject \"Hello\" --body \"Message body\"\n\n# With CC, BCC, and attachment\naux4 email send \\\n --to recipient@example.com \\\n --cc other@example.com \\\n --subject \"Report\" \\\n --body \"Please find the report attached.\" \\\n --attachment ./report.pdf\n`\n\n### Manage Attachments\n\n`bash\n# List attachments of an email\naux4 email attachment list 12345\n\n# Download a specific attachment\naux4 email attachment download 12345 --file document.pdf\n\n# Download to a specific path\naux4 email attachment download 12345 --file document.pdf --output ~/Downloads/document.pdf\n`\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| aux4 email list all | List all emails in the mailbox |\n| aux4 email list from <email> | List emails from a specific sender |\n| aux4 email read <uid> | Read an email by UID |\n| aux4 email send | Send an email |\n| aux4 email attachment list <uid> | List attachments of an email |\n| aux4 email attachment download <uid>` | Download an attachment |\n\n## License\n\nApache-2.0\n"}