1<div align="center">
2
3---
4
5<img src = "assets/banner.jpg">
6
7---
8
9[](https://golang.org)
10[](https://discord.gg/jVnYTeSPV8)
11[](https://github.com/floatpane/matcha/releases)
12[](https://pkg.go.dev/github.com/floatpane/matcha)
13[](https://github.com/rothgar/awesome-tuis#messaging)
14
15<a href="https://trendshift.io/repositories/26026" target="_blank"><img src="https://trendshift.io/api/badge/repositories/26026" alt="floatpane%2Fmatcha | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
16
17
18</div>
19
20> [!NOTE]
21> Matcha is in active development of v1. You can see the [`release/v1` branch](https://github.com/floatpane/matcha/tree/release/v1). 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!
22
23> [!TIP]
24> There are [nightly releases](https://github.com/floatpane/matcha/releases/tag/nightlyv0)!
25
26**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.
27
28
29
30### Plugin Marketplace
31
32Matcha has a built-in plugin system with 35+ community plugins. Browse and install them from the terminal or the [online marketplace](https://docs.matcha.email/marketplace).
33
34```bash
35matcha marketplace # browse plugins in the TUI
36matcha install <url_or_file> # install a plugin
37matcha config <plugin_name> # configure an installed plugin
38```
39
40Anyone can submit their own plugin — just add an entry to `plugins/registry.json` and open a PR. [Learn more](https://docs.matcha.email/Features/Plugins#submit-your-plugin)
41
42### AI Integration
43
44**AI Agent Support:** Matcha can be used by autonomous AI agents to send emails on your behalf. The `matcha send` CLI command provides a non-interactive interface for composing and sending emails.
45
46```bash
47matcha send --to alice@example.com --subject "Hello" --body "Sent by my AI agent"
48```
49
50[Learn more](https://docs.matcha.email/Features/AI_AGENTS)
51
52### Logging
53
54Matcha supports global logging verbosity flags before the main command or subcommand:
55
56```bash
57matcha --verbose # enable verbose logging
58matcha -V daemon status # short form for verbose logging
59matcha --debug daemon status # enable debug logging
60```
61
62The existing `-v` and `--version` flags continue to print the Matcha version.
63
64**AI Rewrite Plugin:** Matcha includes an AI rewrite plugin that allows you to rewrite your email drafts using OpenAI, Ollama, Gemini, or Claude.
65
66[Setup Guide](https://docs.matcha.email/setup-guides/ai-rewrite)
67
68## Documentation
69
70Matcha Documention is available on [our website](https://docs.matcha.email)
71
72## Star History
73
74[](https://www.star-history.com/#floatpane/matcha&type=date&legend=top-left)
75
76## Contributing
77
78Contributions are welcome! Please feel free to submit a Pull Request. See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
79
80## License
81
82This project is distributed under the MIT License. See the `LICENSE` file for more information.
83
84## Suggestions
85
86For general suggestions and community discussion, please join our [Discord server](https://discord.gg/jVnYTeSPV8).
87
88For security-related issues, please refer to the [Security Policy](https://github.com/floatpane/matcha/blob/master/SECURITY.md).
89
90For urgent concerns, contact [support@floatpane.com](mailto:support@floatpane.com)
91
92## Sponsors
93>[!TIP]
94> Want to sponsor our development and be featured here? You can do so [here](https://github.com/sponsors/floatpane) (or, if you prefer, [here](https://opencollective.com/floatpane)), or discuss it via email with [our team](mailto:us@floatpane.com)
95
96
97Thank you to our sponsors for supporting Matcha's development!
98
99### Individual Sponsors:
100
101[David H. Colmenares](https://github.com/hipomenes) | Elliot Hornes | Robert M. | James L. | Chris D.
102
103<div align="center">
104
105**[Report Bug](https://github.com/floatpane/matcha/issues/new?template=bug_report.md)** · **[Request Feature](https://github.com/floatpane/matcha/issues/new?template=feature_request.md)** · **[Contributing Guidelines](https://github.com/floatpane/matcha/blob/master/CONTRIBUTING.md)**
106
107</div>