aqua-communication

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.