1<!-- GitAds-Verify: E4MV39T49YJXPDDL5VL456ARZP2SJRPV -->
  2
  3<div align="center">
  4
  5---
  6
  7<img src = "assets/banner.jpg">
  8
  9---
 10
 11[![Go Version](https://img.shields.io/github/go-mod/go-version/floatpane/matcha)](https://golang.org)
 12[![Discord](https://img.shields.io/discord/1489296626827661323?logo=discord)](https://discord.gg/jVnYTeSPV8)
 13[![GitHub release (latest by date)](https://img.shields.io/github/v/release/floatpane/matcha)](https://github.com/floatpane/matcha/releases)
 14[![Go Reference](https://pkg.go.dev/badge/github.com/floatpane/matcha.svg)](https://pkg.go.dev/github.com/floatpane/matcha)
 15[![Awesome](https://awesome.re/badge.svg)](https://github.com/rothgar/awesome-tuis#messaging)
 16
 17<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>
 18
 19
 20</div> 
 21
 22> [!NOTE]
 23> 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!
 24
 25> [!TIP]
 26> There are [nightly releases](https://github.com/floatpane/matcha/releases/tag/nightlyv0)!
 27
 28**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.
 29
 30![Demo GIF](public/assets/demo.gif)
 31
 32### Plugin Marketplace
 33
 34Matcha 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).
 35
 36```bash
 37matcha marketplace                # browse plugins in the TUI
 38matcha install <url_or_file>      # install a plugin
 39matcha config <plugin_name>       # configure an installed plugin
 40```
 41
 42Anyone 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)
 43
 44### AI Integration
 45
 46**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.
 47
 48```bash
 49matcha send --to alice@example.com --subject "Hello" --body "Sent by my AI agent"
 50```
 51
 52[Learn more](https://docs.matcha.email/Features/AI_AGENTS)
 53
 54### Logging
 55
 56Matcha supports global logging verbosity flags before the main command or subcommand:
 57
 58```bash
 59matcha --verbose              # enable verbose logging
 60matcha -V daemon status       # short form for verbose logging
 61matcha --debug daemon status  # enable debug logging
 62```
 63
 64The existing `-v` and `--version` flags continue to print the Matcha version.
 65
 66**AI Rewrite Plugin:** Matcha includes an AI rewrite plugin that allows you to rewrite your email drafts using OpenAI, Ollama, Gemini, or Claude.
 67
 68[Setup Guide](https://docs.matcha.email/setup-guides/ai-rewrite)
 69
 70## Documentation
 71
 72Matcha Documention is available on [our website](https://docs.matcha.email)
 73
 74## Star History
 75
 76[![Star History Chart](https://api.star-history.com/svg?repos=floatpane/matcha&type=date&legend=top-left)](https://www.star-history.com/#floatpane/matcha&type=date&legend=top-left)
 77
 78## Contributing
 79
 80Contributions are welcome! Please feel free to submit a Pull Request. See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 81
 82## License
 83
 84This project is distributed under the MIT License. See the `LICENSE` file for more information.
 85
 86## Suggestions
 87
 88For general suggestions and community discussion, please join our [Discord server](https://discord.gg/jVnYTeSPV8).
 89
 90For security-related issues, please refer to the [Security Policy](https://github.com/floatpane/matcha/blob/master/SECURITY.md).
 91
 92For urgent concerns, contact [support@floatpane.com](mailto:support@floatpane.com)
 93
 94## Sponsors
 95>[!TIP]
 96> 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)
 97
 98
 99Thank you to our sponsors for supporting Matcha's development!
100
101### Individual Sponsors:
102
103[David H. Colmenares](https://github.com/hipomenes) | Elliot Hornes | Robert M. | James L. | Chris D. 
104
105[![Sponsored by GitAds](https://gitads.dev/v1/ad-serve?source=floatpane/matcha@github)](https://gitads.dev/v1/ad-track?source=floatpane/matcha@github)
106
107_Clicking this add helps us fund our expenses!_
108
109<div align="center">
110
111**[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)**
112
113</div>