M2a – Chat with remote agents from your terminal
FreeFreeFree tier
Inputs: textOutputs: text
About M2a – Chat with remote agents from your terminal
m2a is a small, keyboard-driven CLI tool that enables terminal-based chat with remote AI agents using the Agent2Agent (A2A) protocol. Built with Bubble Tea and powered by the a2a-go SDK, it loads agent cards, supports HTTP+JSON and JSON-RPC transports, optional authentication headers, markdown rendering of agent replies, and debug traces for request/response inspection. Open source and free to use, m2a is ideal for developers testing or interacting with A2A-compatible agents directly from the command line.
Key Features
Agent card discovery via .well-known/agent-card.json or direct card URL
HTTP+JSON and JSON-RPC transport support (configurable with -transport)
Custom authentication headers (-H flag) for every request
Scrollable chat transcript with mouse wheel support
Markdown rendering of agent replies using Glamour (or plain text with -raw)
Debug mode (-debug) for indented JSON request/response logging
Version printing with -version flag
Multiple installation methods: go install, install script (Linux/macOS), or source build
Bubble Tea terminal UI with keyboard shortcuts (Enter send, Esc/Ctrl+C quit)
Pros & Cons
Pros
- Lightweight and fast CLI with no heavy dependencies
- Supports multiple A2A transports and custom headers for authentication
- Markdown rendering provides readable agent responses
- Open source under a permissive license (MIT assumed, LICENSE file present)
- Cross-platform (Go binary, install script for Linux/macOS, Windows releases)
Cons
- Limited to agents that implement the A2A protocol
- Requires terminal usage and command-line familiarity
- No graphical interface or web-based UI
- Windows support only via pre-built binaries (no install script)
- Multi-turn conversation handling depends on agent implementation, not the tool
Best For
Testing and debugging A2A agent implementations from the command lineIntegrating terminal-based workflows with remote AI agents via A2A protocolQuickly verifying agent card configurations and endpoint responsesScripted or interactive agent communication for development and QA
FAQ
What is m2a?
m2a is a terminal-based CLI tool that lets you chat with remote AI agents using the Agent2Agent (A2A) protocol. It loads agent cards, connects via HTTP+JSON or JSON-RPC, and provides a keyboard-driven chat interface.
How do I install m2a?
m2a can be installed via 'go install github.com/mantyx-io/m2a/cmd/m2a@latest', an install script (curl-pipe-bash) for Linux/macOS, or by building from source. Windows binaries are available in GitHub releases.
What protocols does m2a support?
m2a supports HTTP+JSON and JSON-RPC transports as defined by the A2A protocol. Use the -transport flag to choose when the agent card lists multiple options.
Can I use authentication with m2a?
Yes, you can pass authentication headers using the -H flag (repeatable), for example -H 'Authorization: Bearer YOUR_TOKEN'. These headers are sent on every request including the initial card fetch.
Is m2a free?
Yes, m2a is open source and free to use. It is released under the license included in the repository (LICENSE file).