CLI
Matcha provides several subcommands for non-interactive use. These work without launching the TUI and are ideal for scripts, cron jobs, and AI agent integration.
AI Agents
Matcha can be used by AI coding agents (like Claude Code) to send emails on your behalf. This is powered by the matcha send CLI command and an optional Claude Code skill.
Split View
Matcha includes an optional split pane view that allows you to browse your inbox and read emails side-by-side without having to switch to a separate full-screen email view.
Threaded View
Matcha can group related emails into conversations using the JWZ threading
Account Management
Matcha allows you to configure and manage multiple email accounts seamlessly.
Advanced Features
Matcha includes several advanced features to enhance your email experience.
Calendar Invites
Matcha can parse and display calendar invites (.ics attachments) directly in the email view, and lets you RSVP without leaving the terminal.
Composing Emails
composer Empty Composer
Contact Management
Matcha keeps your contacts organized and easily accessible.
Background Daemon
Matcha includes an optional background daemon that keeps email connections alive, syncs mail, and sends desktop notifications — even when the TUI is closed.
Draft Management
Drafts
Email Management
settings
Encryption
Matcha supports optional full-disk encryption of all local data using a password you choose. The password is never stored anywhere -- not on disk, not in the OS keyring, not in environment variables. You enter it each time you open matcha.
Hyperlinks
Hyperlink Support (OSC 8)
Image Protocol Compatibility
[!TIP] This feature is optional. To disable images, go to Settings > Image Display: OFF, you can also always turn it on for 1 email by pressing i
Keybinds
Matcha lets you remap every keyboard shortcut. Bindings live in plain JSON at ~/.config/matcha/keybinds.json and are written automatically the first time you launch the app.
PGP Email Security
Matcha supports PGP (Pretty Good Privacy) for signing and encrypting your emails. PGP is widely used in open-source communities, journalism, and privacy-focused environments.
Plugins
Matcha supports Lua plugins for extending functionality. Plugins can react to events like receiving emails, sending messages, switching folders, and more.
S/MIME Email Security
Matcha supports S/MIME (Secure/Multipurpose Internet Mail Extensions) for signing and encrypting your emails. S/MIME provides end-to-end security, ensuring your messages are authentic and private.
Themes
Matcha supports color themes to personalize the look of your terminal email client. Choose from built-in themes or create your own.
User Interface
Matcha features a modern terminal interface built for efficiency and aesthetics.