Matcha Client

A powerful, feature-rich email client for your terminal. Built with Go and the Bubble Tea TUI framework, Matcha brings a beautiful, modern email experience to the command line with support for rich content, multiple accounts, and advanced terminal features.

Features:

Email Management

• Inbox & Sent Mail: View and manage emails from both inbox and sent folders
• Multi-Account Support: Manage multiple email accounts with an elegant tabbed interface
• Smart Caching: Instant inbox display with background refresh for optimal performance
• Real-time Refresh: Manually refresh your inbox at any time with a single keypress
• Infinite Scroll: Automatically loads more emails as you scroll through your inbox
• Search & Filter: Built-in filtering to quickly find emails by subject, sender, or content
• Rich Email Viewing
• Reply to Emails: Quick reply with automatic quoting of original message
• Delete & Archive: Manage your inbox by deleting or archiving messages
• Attachment Support

Image Protocol Support

• Kitty Graphics Protocol: Full support for Kitty, Ghostty, WezTerm, Wayst, and Konsole terminals
• iTerm2 Inline Images: Native support for iTerm2 and Warp terminals
• Inline Email Images: Display images embedded in HTML emails (including CID references)
• Remote Image Fetching: Automatically fetches and displays remote images from URLs
• Data URI Support: Renders base64-encoded inline images
• Smart Fallback: Gracefully falls back to clickable links when images aren't supported

Terminal Hyperlinks (OSC 8)

• Clickable Links: Full OSC 8 hyperlink support for modern terminals
• Supported Terminals: Kitty, Ghostty, WezTerm, Alacritty, iTerm2, Hyper, VS Code terminal, GNOME Terminal, and more
• Smart Detection: Automatically detects terminal capabilities
• Fallback Mode: Shows plain text URLs in unsupported terminals

Account Management

• Multiple Accounts: Configure and manage multiple email accounts
• Easy Switching: Switch between accounts with keyboard shortcuts or tabs
• Secure Storage: Credentials stored locally in ~/.config/matcha/config.json

Contact Management

• Automatic Contact Saving: Email addresses are automatically saved from:
• Smart Search: Fuzzy search through your contacts while composing
• Quick Autocomplete: Contact suggestions appear as you type in the "To" field
• Persistent Storage: Contacts are saved locally for offline access

Advanced Features

• Automatic Updates: Built-in update checker notifies you of new releases
• Self-Update Command: Update Matcha with a simple matcha update command
• Flexible Configuration: JSON-based configuration with automatic migration from legacy formats
• Performance Optimized: Concurrent email fetching for faster inbox loading
• Email Caching: Instant inbox display on startup with background refresh