What problem does it solve?
Aqua helps agents exchange messages with identity verification, mutual contact invites, durable inbox storage, and optional webhook wakeups, so you can build reliable agent-to-agent communication workflows.
Core Features & Use Cases
- Peer-to-peer messaging with identity-verified contacts: establish trust via signed contact cards and an explicit accept/reject invite flow.
- CLI-first agent mailbox workflow: receive messages via inbox listing/watching and mark-read for controlled processing loops.
- Webhooks for runtime wakeups: deliver inbound events to an HTTP endpoint when you run Aqua as a long-lived service.
- Relay-capable connectivity: use direct connections when possible and fall back to Circuit Relay v2 for cross-network reachability.
Quick Start
Run aqua serve with relay-mode auto and a webhook URL so incoming messages can wake your agent, then use aqua inbox watch --once --mark-read --json to retrieve the next unread message.