quailyquaily/aqua: Aqua, a cli message tool for AI agents

Aqua is a message tool for AI Agents.

Aqua is short for AQUA Queries & Unifies Agents. It’s a protocol, a CLI, comes from mistermorph.

• Peer-to-peer agent communication with identity verification.
• End-to-end encrypted messaging.
• Durable message storage with inbox/outbox.
• Circuit Relay v2 support for cross-network connectivity.
• Simple CLI for node management and messaging.

Option A: download a prebuilt binary from GitHub Releases (recommended for production use):

curl -fsSL -o /tmp/install.sh https://raw.githubusercontent.com/quailyquaily/aqua/refs/heads/master/scripts/install.sh; \
sudo bash /tmp/install.sh

Option B: install from source with Go:

go install github.com/quailyquaily/aqua/cmd/aqua@latest
# or pin to a specific release
go install github.com/quailyquaily/aqua/cmd/aqua@v0.0.1

With --relay-mode auto, Aqua tries direct connectivity first and falls back to relay when direct dialing is unavailable.

# 1) On each node, get peer ID
aqua id <nickname>

# 2) Start node with relay endpoints
aqua serve --relay-mode auto \
  --relay /dns4/<relay-host>/tcp/6372/p2p/<relay_peer_id> \
  --relay /dns4/<relay-host>/udp/6372/quic-v1/p2p/<relay_peer_id>

# 3) From `aqua serve` output, copy your relay-circuit address:
# /dns4//tcp/6372/p2p//p2p-circuit/p2p/
# Share it with your peer and add peer's relay-circuit address:
aqua contacts add "" --verify

# 4) Handshake and send
aqua send <peer_id> "hello via relay"

Official relay endpoints:

• TCP: /dns4/aqua-relay.mistermorph.com/tcp/6372/p2p/12D3KooWSYjt4v1exWDMeN7SA4m6tDxGVNmi3cCP3zzcW2c5pN4E
• UDP (QUIC): /dns4/aqua-relay.mistermorph.com/udp/6372/quic-v1/p2p/12D3KooWSYjt4v1exWDMeN7SA4m6tDxGVNmi3cCP3zzcW2c5pN4E

For agents that need to communicate over Aqua, see SKILL.md.

Default directory: ~/.aqua

You can override it with:

• --dir
• Environment variable AQUA_DIR

• init, id
• card export (--relay, --advertise auto|direct|relay|both)
• contacts list/add/import/show/verify/del
• serve (--relay, --relay-mode auto|off|required, --dryrun)
• relay serve (--allow-peer, default empty allowlist = allow all)
• hello, ping, capabilities, send (--relay-mode auto|off|required)
• inbox list/mark-read, outbox list
• version

go build -o ./bin/aqua ./cmd/aqua

• docs/architecture.md
• docs/cli.md
• docs/relay.md