README.md

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