Back to directory
floatpane avatar
floatpane / matcha

matcha

A beautiful and functional email client for your terminal, built with Go and the charming Bubble Tea TUI library. Never leave your command line to check your inbox or send an email again!

1,056

Stars

82

Forks

3

Watchers

MIT

License


banner

Go Version Discord GitHub release (latest by date) Go Reference Awesome

floatpane%2Fmatcha | Trendshift

[!NOTE] Matcha is in active development of v1. You can see the release/v1 branch. v0 will still be maintained with bug fixes and minor features, but all major new features will be added to v1. You will be able to use v1 release candidates soon!

[!TIP] There are nightly releases!

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.

Demo GIF

Plugin Marketplace

Matcha has a built-in plugin system with 35+ community plugins. Browse and install them from the terminal or the online marketplace.

matcha marketplace                # browse plugins in the TUI
matcha install <url_or_file>      # install a plugin
matcha config <plugin_name>       # configure an installed plugin

Anyone can submit their own plugin — just add an entry to plugins/registry.json and open a PR. Learn more

Logging

Matcha supports global logging verbosity flags before the main command or subcommand:

matcha --verbose              # enable verbose logging
matcha -V daemon status       # short form for verbose logging
matcha --debug daemon status  # enable debug logging

The existing -v and --version flags continue to print the Matcha version.

Documentation

Matcha Documention is available on our website

Star History

Star History Chart

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. See CONTRIBUTING.md for guidelines.

License

This project is distributed under the MIT License. See the LICENSE file for more information.

Suggestions

For general suggestions and community discussion, please join our Discord server.

For security-related issues, please refer to the Security Policy.

For urgent concerns, contact [email protected]

Sponsors

[!TIP] Want to sponsor our development and be featured here? You can do so here (or, if you prefer, here), or discuss it via email with our team

Thank you to our sponsors for supporting Matcha's development!

Individual Sponsors:

David H. Colmenares | Elliot Hornes | Robert M. | James L. | Chris D.

Releases

nightlyv0

Pre-release

Aug 10, 2026

Nightly Build (5198d8f)

Download .zip

WarningThis is an automated nightly build from the latest master commit (5198d8f). It may be unstable — use stable releases for production.

Install

Homebrew: brew install floatpane/matcha/matcha-nig...

v1.0.0-rc2

Pre-release

Aug 5, 2026

Download .zip

What's Changed New Features

feat(gitmail): initial by @andrinoff in #1420 feat: horizontal split pane view by @andrinoff in #1423 feat: command palette by @andrinoff in #1431 feat: macos helper (init...

preview-pr1703

Pre-release

Aug 1, 2026

Preview Build (PR #1703 @ a1f3382)

Download .zip

Preview build from PR #1703 at commit a1f3382. Not for production use.

preview-pr1699

Pre-release

Jul 24, 2026

Preview Build (PR #1699 @ e3c6c63)

Download .zip

Preview build from PR #1699 at commit e3c6c63. Not for production use.

What's Changed New Features

feat: reply-all by @andrinoff in #1673

Bug Fixes

fix: release fail by @andrinoff in #1649 fix: resolve sent folders by @andrinoff in #1643

Dependencies

chore(deps): vu...