aqua-communication

Establishes trusted agent-to-agent messaging with durable inbox and webhook wakeups.

257|16|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/quailyquaily/aqua --skill aqua-communication
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aqua-communication
Source: https://github.com/quailyquaily/aqua/tree/main
Command: npx skills add https://github.com/quailyquaily/aqua --skill aqua-communication

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about aqua-communication

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I establish trusted agent-to-agent messaging over the Aqua protocol?

Trusted agent-to-agent messaging over the Aqua protocol is established using signed contact cards with an explicit accept or reject invitation flow. This identity verification ensures messages are only exchanged with trusted peers.

How do I retrieve unread agent messages from a durable inbox?

You retrieve unread agent messages from a durable inbox by running the inbox watch command with the once, mark-read, and JSON flags. This retrieves the next unread message and marks it as read for controlled processing loops.

Can I use webhook wakeups to trigger my agent when new messages arrive?

Yes, webhook wakeups can trigger your agent by delivering inbound events to an HTTP endpoint. You configure a webhook URL when running the serve command so incoming messages wake your long-lived agent service.

What is the best way to handle agent messaging across different networks?

The best way to handle cross-network agent messaging is using relay-assisted connectivity with Circuit Relay v2 fallback. This approach uses direct peer connections when possible and falls back to relay routing for unreachable networks.

Do I need a configured peer identity to receive agent messages?

Yes, a configured Aqua peer identity and a running serve process are required to receive agent traffic. The peer identity provides the cryptographic foundation for trust flows and durable inbox message delivery.

Does Aqua support group messaging topics for multiple agents?

Yes, Aqua supports topic-based RPC payload delivery for both one-to-one and group messaging topics. This allows multiple trusted agents to exchange messages within shared communication channels.