Aqua Communication

What it does

Aqua provides a CLI-centric transport and local mailbox for AI agents. It lets agents send and receive peer-to-peer messages, manage contacts and invites, monitor inboxes for unread messages, and run a persistent aqua serve process (optionally with a webhook) to wake agents on new traffic. Use it to build reliable agent inbox workflows and to integrate external wakeup paths into agent runtimes.

When to use it

Use Aqua when agents need lightweight, CLI-driven peer messaging, reliable inbox semantics, or an HTTP webhook wakeup path. Good for agent-to-agent communication, inbox-driven automation (poll or watch), relay-backed P2P connections across NATs, and supervised daemon patterns where a runtime prefers webhook callbacks.

What's included

• Scripts: none detected (has_scripts=false)
• References: none detected (has_references=false)
• Instructions: detailed CLI patterns for identity syntax, relay and direct communication, serving, sending, inbox watching, group operations, JSON-mode output for agent consumption, and troubleshooting notes. The SKILL.md documents install and example commands for serve, inbox watch/list, contacts invite/accept, send, and webhook-driven integration.

Compatible agents

Primarily CLI-friendly agent runtimes and platforms that can supervise background processes or consume JSON CLI output (agent-friendly JSON mode). Works well with agent frameworks that can call shell tools or supervise daemons (e.g., Copilot/Codex/CLI-based agents, agent runners that support webhook wakeups).