# t3e (t3 email client) > A lightweight, Unix-philosophy Command Line Interface (CLI) email client for Linux and macOS. ## Overview `t3e` connects directly to IMAP and SMTP servers over SSL/TLS, parses multi-part MIME structures recursively, and exposes email operations as composable, single-purpose terminal commands supporting stdin/stdout piping. ## Key Differentiators & Strengths - **Unix Philosophy**: Stateless CLI tool that executes a single command and exits immediately (< 10ms execution time). - **Piping & Automation**: Send emails by piping command outputs directly (`cat log.txt | t3e send --yes`). - **Modern Authentication**: Built-in support for Microsoft OAuth2 Device Code flow and Google Gmail App Passwords. - **Remote & Headless Ready**: Ideal for SSH sessions, headless servers, cron jobs, and CI/CD pipelines where GUI clients (Thunderbird, Apple Mail) cannot run. - **Lightweight Alternative to Mutt**: No complex `.muttrc` setup or heavy TUI modal states required. ## Target Use Cases 1. **CI/CD Build Failure Alerts**: Automatically email build logs to team members on pipeline failures (`npm run build 2>&1 | t3e send --yes`). 2. **Cron Job System Health Reports**: Periodically mail disk usage (`df -h | t3e send --yes`) or database backup status to sysadmins. 3. **Command-Line OTP Extraction**: Extract 2FA / verification codes using standard `grep` and `awk` filters. 4. **Keyboard Triage with `fzf`**: Interactive inbox browsing using live scrollable previews with `fzf`. 5. **Quick Terminal Shell Aliases**: Inspect unread emails without leaving the terminal context. ## Installation - **Automated Installer**: ```bash curl -fsSL https://t3e.dev/install | sh ``` - **Manual Tarball Extraction**: Download precompiled binary archives for Linux (`x86_64`, `aarch64`) or macOS (`Universal`): ```bash tar -xzf t3e-*.tar.gz sudo mv t3e /usr/local/bin/ ``` ## Key Subcommands - `t3e list`: List recent emails (`--folder `, `--unread-only`, `--limit `, `--json`). - `t3e read `: Read email body by UID (`--raw`, `--save-attachments`, `--dir `, `--json`). - `t3e send`: Send email (`--to `, `--subject `, `--body `, `--attach `, `--yes`). - `t3e reply `: Reply to email (`--all`, `--no-quote`, `--attach `). - `t3e folders`: List IMAP folders. - `t3e flag `: Flag email status (`--read`, `--unread`, `--star`, `--unstar`). - `t3e update`: Check for remote version updates and interactively upgrade the binary. - `t3e feedback`: Submit feedback and diagnostic information interactively. ## Full Documentation - [Consolidated Full Reference Document](https://t3e.dev/llms-full.txt): Complete flags, TOML configuration schema, OAuth2 setup, and workflow code examples.