MIT License macOS & Linux Written in Go

The Ultimate
Terminal Email Client.

Never leave your command line to check your inbox or send an email again. A beautiful TUI for power users who live in the terminal.

Live Preview

matcha — zsh
Matcha
What would you like to do?
> View Inbox
Compose Email
Settings
Use ↑/↓ to navigate, enter to select, and ctrl+c to quit.
Matcha Preview

Features

📬

View Your Inbox

Fetches and displays a list of your most recent emails with beautiful formatting and quick navigation.

📖

Read Emails

Select an email from your inbox to view its full content with proper text rendering and attachments.

✍️

Compose & Send

A simple and intuitive interface for writing and sending new emails without leaving your terminal.

🎨

Beautiful TUI

A clean and modern terminal user interface built with Bubble Tea that's a pleasure to use.

🔐

Secure

Uses a local configuration file to store your credentials securely. Your data never leaves your machine.

⌨️

Keyboard Driven

Navigate, select, and manage your emails entirely with keyboard shortcuts. No mouse required.

Installation

Install with Homebrew

Recommended
Terminal
~ $ brew tap floatpane/matcha
~ $ brew install floatpane/matcha/matcha
~ $ matcha

Or, Build from Source

1

Clone the Repository

Grab the source code from GitHub. Make sure you have Go installed.

git clone https://github.com/floatpane/matcha.git
2

Build the Binary

Navigate to the project folder and compile.

cd matcha && go build -o matcha
3

Run It

Execute the binary or move it to your PATH for global access.

./matcha

Usage

or kj

Navigate

Move through menus and email lists

Enter

Select

Open emails or confirm actions

c

Compose

Start writing a new email

Tab

Switch Fields

Move between To, Subject, and Body

Esc

Go Back

Return to the previous view

Ctrl+C

Quit

Exit the application

Supported Providers

📧 Gmail
☁️ iCloud
📬 More coming soon...

Get in Touch

Made with ❤️ by floatpane

For support, please open an issue on the GitHub repository.