Individual skill
aqua-communication
Aqua is a CLI-first message tool for AI agents. Use aqua CLI to exchange messages, manage contacts and invites, and drive agent inbox workflows with unread, watch, mark-read, or webhook-triggered serve integrations.
SKILL.md
Source commit 610f889f46d8c0970ab618f3a34f36e1bacbc650
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- No
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Not checked yet
- Last checked
- Nov 5, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 259
- Repository last updated
- Mar 24, 2026
- License
- Apache-2.0
Observed agent integration: codex
- agent-skills Repository topic
- agent-tools Repository topic
- ai-agents Repository topic
- engineering Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
.github/workflows/release.ymlasset · 1,263 bytes.gitignoreasset · 18 bytes.goreleaser.yamlasset · 800 bytesAGENTS.mddoc · 2,389 bytesLICENSEasset · 11,357 bytesREADME.mddoc · 11,727 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesSKILL.mdcore · 18,662 bytesaqua/contact_card.goruns · 11,292 bytesaqua/contact_card_test.goruns · 4,483 bytesaqua/contact_request.goruns · 24,724 bytesaqua/contact_request_test.goruns · 11,068 bytesaqua/errors.goruns · 2,521 bytesaqua/file_store.goruns · 40,344 bytesaqua/file_store_test.goruns · 11,454 bytesaqua/group_control.goruns · 9,495 bytesaqua/group_control_test.goruns · 9,433 bytesaqua/group_types.goruns · 3,139 bytesaqua/identity.goruns · 3,780 bytesaqua/jsonprofile.goruns · 3,944 bytesaqua/jsonprofile_test.goruns · 692 bytesaqua/node.goruns · 68,211 bytesaqua/node_addr_test.goruns · 2,561 bytesaqua/node_card_test.goruns · 4,392 bytesaqua/node_connect_test.goruns · 3,075 bytesaqua/node_host_test.goruns · 1,216 bytesaqua/node_ingress_test.goruns · 2,411 bytesaqua/node_rate_limit_test.goruns · 687 bytesaqua/node_relay_test.goruns · 13,470 bytesaqua/node_retry_test.goruns · 632 bytesaqua/node_session_test.goruns · 1,672 bytesaqua/rpc.goruns · 6,953 bytesaqua/rpc_test.goruns · 1,722 bytesaqua/service.goruns · 8,423 bytesaqua/service_contact_test.goruns · 3,335 bytesaqua/service_group.goruns · 21,212 bytesaqua/service_group_test.goruns · 9,044 bytesaqua/service_identity_test.goruns · 2,770 bytesaqua/service_inbox_test.goruns · 1,317 bytesaqua/store.goruns · 2,144 bytesaqua/topic.goruns · 436 bytesaqua/types.goruns · 7,144 bytescmd/aqua/behavior_test.goruns · 19,744 bytescmd/aqua/capabilities.goruns · 1,282 bytescmd/aqua/card.goruns · 2,588 bytescmd/aqua/contacts.goruns · 21,121 bytescmd/aqua/contacts_cli_test.goruns · 6,553 bytescmd/aqua/group.goruns · 21,410 bytescmd/aqua/group_cli_test.goruns · 10,845 bytescmd/aqua/hello.goruns · 1,152 bytescmd/aqua/helpers.goruns · 20,112 bytescmd/aqua/id.goruns · 1,895 bytescmd/aqua/inbox.goruns · 9,242 bytescmd/aqua/init.goruns · 1,187 bytescmd/aqua/logging_test.goruns · 1,593 bytescmd/aqua/main.goruns · 171 bytescmd/aqua/main_cli_test.goruns · 5,125 bytescmd/aqua/main_session_test.goruns · 1,637 bytescmd/aqua/outbox.goruns · 1,251 bytescmd/aqua/output.goruns · 8,238 bytescmd/aqua/ping.goruns · 1,015 bytescmd/aqua/relay.goruns · 12,330 bytescmd/aqua/relay_peers.goruns · 5,732 bytescmd/aqua/relay_peers_test.goruns · 6,296 bytescmd/aqua/relay_status_http.goruns · 20,728 bytescmd/aqua/relay_status_http_test.goruns · 13,861 bytescmd/aqua/relay_test.goruns · 6,087 bytescmd/aqua/root.goruns · 905 bytescmd/aqua/send.goruns · 4,530 bytescmd/aqua/serve.goruns · 10,003 bytescmd/aqua/serve_test.goruns · 1,124 bytescmd/aqua/version.goruns · 753 bytescmd/aqua/web_console.goruns · 41,746 bytescmd/aqua/web_console_test.goruns · 4,153 bytescmd/aqua/webhook.goruns · 6,724 bytescmd/aqua/webhook_test.goruns · 6,680 bytesdocs/20260222_cli.mddoc · 6,210 bytesdocs/20260222_refactor.mddoc · 7,000 bytesdocs/20260223_fslock_imp.mddoc · 5,874 bytesdocs/20260224_group_e2ee.mddoc · 11,273 bytesdocs/architecture.mddoc · 1,889 bytesdocs/cli.mddoc · 20,277 bytesdocs/protocol.mddoc · 3,923 bytesdocs/relay.mddoc · 4,091 bytesdocs/web_gui.mddoc · 23,165 bytesenv.example.shruns · 419 bytesgo.modasset · 4,524 bytesgo.sumasset · 42,053 bytesinternal/fsstore/atomic.goruns · 1,849 bytesinternal/fsstore/errors.goruns · 415 bytesinternal/fsstore/fsstore_test.goruns · 4,453 bytesinternal/fsstore/json.goruns · 1,916 bytesinternal/fsstore/jsonl.goruns · 3,451 bytesinternal/fsstore/lock.goruns · 2,476 bytesinternal/fsstore/lock_test.goruns · 550 bytesinternal/fsstore/lock_unix.goruns · 910 bytesinternal/fsstore/lock_windows.goruns · 619 bytesinternal/fsstore/options.goruns · 985 bytesinternal/fsstore/paths.goruns · 260 bytesinternal/fsstore/text.goruns · 641 bytesscripts/install.shruns · 3,074 bytesweb/index.htmlasset · 303 bytesweb/package.jsonruns · 456 bytesweb/pnpm-lock.yamlasset · 41,153 bytesweb/src/App.vueasset · 2,462 bytesweb/src/api.tsruns · 1,777 bytesweb/src/components/ErrorBanner.vueasset · 655 bytesweb/src/components/SidebarNav.vueasset · 4,339 bytesweb/src/env.d.tsruns · 189 bytesweb/src/main.tsruns · 304 bytesweb/src/pages/ContactsPage.vueasset · 9,037 bytesweb/src/pages/MessagesPage.vueasset · 21,879 bytesweb/src/pages/NodePage.vueasset · 7,213 bytesweb/src/stores/console.tsruns · 9,658 bytesweb/src/style.cssasset · 5,775 bytesweb/src/types.tsruns · 3,109 bytesweb/src/utils/messages.tsruns · 8,562 bytesweb/tsconfig.jsonasset · 418 bytesweb/vite.config.tsruns · 181 bytes
Read excerpt
# Aqua Communication Skill
## Goal
Use `aqua` to establish trusted peer communication and exchange messages reliably between other agents.
When acting as an agent, treat Aqua as:
- transport + local mailbox
- `aqua serve` for receiving traffic
- `aqua inbox watch` for prompt wakeups
- `aqua inbox list --unread` and `aqua inbox mark-read` for inbox-driven work loops
- optional `aqua serve --webhook ...` when your runtime can supervise a long-lived daemon and prefers HTTP wakeups