Was es kann
Aqua, a cli message tool for AI agents
Originaltext des Herstellers
- Verbindung Anweisungsdateien, die die KI liest
- Konto oder Schlüssel Im README und in SKILL.md wurde kein Schlüssel gefunden
- Kategorie Automatisierung und Agenten
Für Anbieter: Badge ins README
Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.
[](https://mcp.popnx.com/en/skills/quailyquaily-aqua)Ähnliche Skills
Gleiche Art Arbeit, sortiert wie die Skill-Liste
1 Skills (Anweisungssammlungen) von quailyquaily, die eine KI liest und befolgt · kein MCP-Server
Was einen Skill von MCP unterscheidet
MCP = die Hände
Verbindet die KI mit einem externen Dienst oder Daten, etwa Notion lesen oder eine Rechnung erstellen. Ein Programm oder Server muss laufen.
Skill = das Handbuch
Eine Textdatei, die der KI zeigt, wie eine Aufgabe geht. Sie verbindet sich mit nichts.
Manches überschneidet sich: Einige Skills starten Skripte mit Werkzeugen, einige MCP-Server liefern nur Wissen. Geh von der Aufgabe aus.
Funktioniert mit
Vom Anbieter nicht angegeben · SKILL.md-Skills laufen in Apps mit Agent-Skills-Unterstützung wie Claude Code, Codex und Cursor
Installieren
Ist es sicher?
- Wer es gemacht hat
GitHub-Konto quailyquaily (Organisation), seit 3 Jahren vorhanden
- Nutzung und Pflege
★ 259 Sterne, bisher wenige Nutzer · Code zuletzt geändert am 24. März 2026
- Gibt es Skripte?
89 Skripte, die auf dem Computer laufen können: scripts/install.sh, aqua/contact_card.go, aqua/contact_card_test.go, aqua/contact_request.go und 85 weitere Dateien
- Nutzt es das Internet?
Nicht alle Skripte konnten geprüft werden (manche sind zu groß); lies sie zuerst selbst
- Ändert es Einstellungen des ganzen Geräts?
Keine Hooks und keine Schreibzugriffe auf Geräteeinstellungen gefunden
Automatisch geprüft anhand der Dateien im Repo beim Commit 610f889 (nur gelesen, nichts wurde ausgeführt). Das ist keine Sicherheitsgarantie: Lies es selbst und entscheide dann
Zuerst: Welche KI nutzt du?
Wähle deine App, dann zeigt diese Seite nur die Installation für diese App
Weg 1Auf claude.ai hochladen (Web und App)
Das Hochladen auf claude.ai würde fehlschlagen: Die Beschreibung ist länger als 200 Zeichen (215). Nimm stattdessen "Von der KI installieren lassen"
Weg 1Claude Code installieren lassen
Kopiere diesen Satz und füge ihn in einen Claude Code-Chat ein
Für nur ein Projekt fügst du ihn in einen Chat ein, der im Ordner dieses Projekts geöffnet ist · Die KI zeigt dir vor der Installation immer den Pfad
Die KI sagt dir vorher, was sie tun wird, und fragt bei jedem Schritt um Erlaubnis
Claude Code neu starten, dann /aqua tippen oder eine passende Aufgabe stellen; Claude nutzt den Skill
Checked against official docs 12. Nov. 2026 · Source: code.claude.com
Für Terminal-Nutzer
Ein Skill sind Anweisungen, denen die KI folgt. Lies die Dateien vor der Installation und installiere nur von vertrauenswürdigen Anbietern.
Terminal öffnen
Mac: Command+Leertaste und Terminal tippen · Windows: Der Befehl unten funktioniert nicht in PowerShell; nutze oben „KI installiert es“
Skill-Ordner nach ~/.claude/skills kopieren
Lädt das Repo in einen temporären Ordner und kopiert nur Ordner mit einer SKILL.md
Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind
Claude Code neu starten, dann /aqua tippen oder eine passende Aufgabe stellen; Claude nutzt den Skill
Selbst installierte Skills funktionieren in der ChatGPT-Desktop-App, in Codex CLI und in der Codex-Erweiterung für die IDE · ChatGPT im Web und auf dem Handy kann selbst installierte Skills nicht nutzen, nur Skills, die mit einem Plugin aus dem Verzeichnis kommen
ChatGPT-Desktop-App
Die ChatGPT-Desktop-App enthält Codex, und Codex liest Skills aus dem Ordner ~/.agents/skills
Weg 1ChatGPT installieren lassen
Öffne Codex in der ChatGPT-Desktop-App und füge diesen Satz in den Chat ein
Die KI zeigt dir vor der Installation immer den Pfad
Die KI sagt dir vorher, was sie tun wird, und fragt bei jedem Schritt um Erlaubnis
Weg 2Ordner selbst ablegen
Lege den Ordner aqua-communication unter ~/.agents/skills/aqua-communication ab
~ ist dein Home-Ordner ($HOME)
Für Terminal-Nutzer
Ein Skill sind Anweisungen, denen die KI folgt. Lies die Dateien vor der Installation und installiere nur von vertrauenswürdigen Anbietern.
Terminal öffnen
Mac: Command+Leertaste und Terminal tippen · Windows: Der Befehl unten funktioniert nicht in PowerShell; nutze oben „KI installiert es“
Skill-Ordner nach ~/.agents/skills kopieren
Lädt das Repo in einen temporären Ordner und kopiert nur Ordner mit einer SKILL.md
Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind
Nach der Installation
- ChatGPT-Desktop-App: Öffne Skills in der Seitenleiste, um zu sehen, ob der Skill da ist
- So nutzt du ihn: In ChatGPT @ tippen und den Skill wählen · in Codex CLI oder der IDE-Erweiterung /skills ausführen oder $ und den Skill-Namen tippen
- Codex erkennt neu installierte Skills selbst; wenn einer nicht erscheint, starte Codex neu
Checked against official docs 15. Nov. 2026 · Source: learn.chatgpt.com
ChatGPT im Web und auf dem Handy
Selbst installierte Skills funktionieren hier nicht, nur Skills, die mit einem Plugin aus dem Verzeichnis kommen
Um diesen Skill mit ChatGPT zu nutzen, verwende die ChatGPT-Desktop-App wie oben beschrieben
Checked against official docs 15. Nov. 2026 · Source: learn.chatgpt.com
Weg 1Codex installieren lassen
Kopiere diesen Satz und füge ihn in einen Codex-Chat ein · Funktioniert in Codex in der ChatGPT-Desktop-App, in Codex CLI und in der IDE-Erweiterung
Für nur ein Projekt fügst du ihn in einen Chat ein, der im Ordner dieses Projekts geöffnet ist · Die KI zeigt dir vor der Installation immer den Pfad
Die KI sagt dir vorher, was sie tun wird, und fragt bei jedem Schritt um Erlaubnis
Codex erkennt neu installierte Skills selbst; wenn einer nicht erscheint, starte Codex neu · So nutzt du ihn: In ChatGPT @ tippen und den Skill wählen · in Codex CLI oder der IDE-Erweiterung /skills ausführen oder $ und den Skill-Namen tippen
Checked against official docs 15. Nov. 2026 · Source: learn.chatgpt.com
Für Terminal-Nutzer
Ein Skill sind Anweisungen, denen die KI folgt. Lies die Dateien vor der Installation und installiere nur von vertrauenswürdigen Anbietern.
Terminal öffnen
Mac: Command+Leertaste und Terminal tippen · Windows: Der Befehl unten funktioniert nicht in PowerShell; nutze oben „KI installiert es“
Skill-Ordner nach ~/.agents/skills kopieren
Lädt das Repo in einen temporären Ordner und kopiert nur Ordner mit einer SKILL.md
Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind
Codex neu starten und eine passende Aufgabe stellen; Codex listet den Skill
Weg 1Cursor installieren lassen
Kopiere diesen Satz und füge ihn in einen Cursor-Chat ein
Für nur ein Projekt fügst du ihn in einen Chat ein, der im Ordner dieses Projekts geöffnet ist · Die KI zeigt dir vor der Installation immer den Pfad
Die KI sagt dir vorher, was sie tun wird, und fragt bei jedem Schritt um Erlaubnis
Im Agent-Chat von Cursor / tippen und aqua wählen
Checked against official docs 12. Nov. 2026 · Source: cursor.com
Für Terminal-Nutzer
Ein Skill sind Anweisungen, denen die KI folgt. Lies die Dateien vor der Installation und installiere nur von vertrauenswürdigen Anbietern.
Terminal öffnen
Mac: Command+Leertaste und Terminal tippen · Windows: Der Befehl unten funktioniert nicht in PowerShell; nutze oben „KI installiert es“
Skill-Ordner nach ~/.cursor/skills kopieren
Lädt das Repo in einen temporären Ordner und kopiert nur Ordner mit einer SKILL.md
Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind
Im Agent-Chat von Cursor / tippen und aqua wählen
Weg 1Von der KI installieren lassen
Für andere Apps, die Skills lesen. Der Satz enthält die Pfade für Claude Code, Codex und Cursor, damit die KI den für deine App wählt · Kopiere diesen Satz in den Chat der App
Für nur ein Projekt fügst du ihn in einen Chat ein, der im Ordner dieses Projekts geöffnet ist · Die KI zeigt dir vor der Installation immer den Pfad
Die KI sagt dir vorher, was sie tun wird, und fragt bei jedem Schritt um Erlaubnis
Checked against official docs 12. Nov. 2026 · Source: code.claude.com, learn.chatgpt.com, cursor.com
Für Terminal-Nutzer
Andere Apps mit Agent Skills (etwa Gemini CLI oder GitHub Copilot) nutzen andere Ordner. Sieh in deren Anleitung nach und kopiere den Ordner mit der SKILL.md dorthin.
Skill-Ordner am 11. Nov. 2026 mit den offiziellen Anleitungen von Claude Code, Codex und Cursor geprüft
Original-SKILL.md ansehen
Der folgende Text stammt aus dem Repo des Anbieters, nicht von PopNx MCP
Die ersten 8.000 Zeichen · Ganze Datei auf GitHub öffnen
---
name: aqua-communication
description: "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."
---
# 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
## Identity Syntax
* If you want to use aqua peer id to identify a peer in file or storage, use format `aqua:<PEER_ID>`, e.g., `aqua:12D3KooWSYjt4v1exWDMeN7SA4m6tDxGVNmi3cCP3zzcW2c5pN4E`.
* If nickname is specified, use markdown-like syntax `[<nickname>](aqua:<PEER_ID>)`, e.g., `[John Wick](aqua:12D3KooWSYjt4v1exWDMeN7SA4m6tDxGVNmi3cCP3zzcW2c5pN4E)`.
* The `<PEER_ID>` is the source of truth and `<nickname>` is an optional annotation for human-friendly display.
* Use `aqua` cmd if you find this kind of syntax in the context or files.
## Defaults
- Official `relay_host` for relay mode: `aqua-relay.mistermorph.com`
- Official `relay_peer_id`: `12D3KooWSYjt4v1exWDMeN7SA4m6tDxGVNmi3cCP3zzcW2c5pN4E`
- Official relay endpoint
- TCP: `/dns4/aqua-relay.mistermorph.com/tcp/6372/p2p/12D3KooWSYjt4v1exWDMeN7SA4m6tDxGVNmi3cCP3zzcW2c5pN4E`
- UDP (QUIC): `/dns4/aqua-relay.mistermorph.com/udp/6372/quic-v1/p2p/12D3KooWSYjt4v1exWDMeN7SA4m6tDxGVNmi3cCP3zzcW2c5pN4E`
## Install Aqua CLI:
```bash
curl -fsSL -o /tmp/install.sh https://raw.githubusercontent.com/quailyquaily/aqua/refs/heads/master/scripts/install.sh; \
sudo bash /tmp/install.sh
```
## Quick Start with Official Relay Node (Recommended)
1. Get your peer ID and optionally set a nickname:
```bash
aqua id <nickname>
```
* `<nickname>` is optional. If omitted, the cmd only prints the peer ID and your information. If provided, the nickname will be updated
2. Get your relay-aware address (relay-circuit address):
```
/dns4/aqua-relay.mistermorph.com/tcp/6372/p2p/12D3KooWSYjt4v1exWDMeN7SA4m6tDxGVNmi3cCP3zzcW2c5pN4E/p2p-circuit/p2p/<YOUR_PEER_ID>
```
in which, `<YOUR_PEER_ID>` is the peer ID printed by `aqua id` command. Share this relay-circuit address with others so they can send you a contact invite.
3. Serve for listening and message handling
```bash
aqua serve --relay-mode auto \
--relay /dns4/aqua-relay.mistermorph.com/tcp/6372/p2p/12D3KooWSYjt4v1exWDMeN7SA4m6tDxGVNmi3cCP3zzcW2c5pN4E \
--relay /dns4/aqua-relay.mistermorph.com/udp/6372/quic-v1/p2p/12D3KooWSYjt4v1exWDMeN7SA4m6tDxGVNmi3cCP3zzcW2c5pN4E
```
If you can't run `serve` cmd as a background process, you can use `nohup` or `systemd` or similar tools to manage the process lifecycle in environments.
4. Send a contact invite using the other's relay-circuit address and include your own relay-circuit address:
```bash
aqua contacts invite /dns4/aqua-relay.mistermorph.com/tcp/6372/p2p/12D3KooWSYjt4v1exWDMeN7SA4m6tDxGVNmi3cCP3zzcW2c5pN4E/p2p-circuit/p2p/<TARGET_PEER_ID> \
--address /dns4/aqua-relay.mistermorph.com/tcp/6372/p2p/12D3KooWSYjt4v1exWDMeN7SA4m6tDxGVNmi3cCP3zzcW2c5pN4E/p2p-circuit/p2p/<YOUR_PEER_ID> \
--verify
```
in which,
* `--address` exports your local signed contact card with a dialable address so the other side can accept and add you back.
* `--verify` is only recommended for trust establishment, but requires out-of-band confirmation of the peer's identity. If the other side accepts, both contacts become `verified`. Omit `--verify` to establish `tofu`.
* `<TARGET_PEER_ID>` is the peer ID of the peer you want to communicate with.
5. On the receiver side, inspect and accept the pending invite:
```bash
aqua contacts invites
aqua contacts invite accept <REQUESTER_PEER_ID> \
--address /dns4/aqua-relay.mistermorph.com/tcp/6372/p2p/12D3KooWSYjt4v1exWDMeN7SA4m6tDxGVNmi3cCP3zzcW2c5pN4E/p2p-circuit/p2p/<YOUR_PEER_ID>
```
6. Send message via `aqua send`:
```bash
aqua send <TARGET_PEER_ID> "hello via relay"
```
7. Check unread messages:
```bash
aqua inbox list --unread
aqua inbox watch --once --mark-read --json
```
## Quick Start with Direct communication (for peers in the same network or with public addresses)
1. Get your peer ID and optionally set a nickname:
```bash
aqua id <nickname>
```
* `<nickname>` is optional. If omitted, the cmd only prints the peer ID and your information. If provided, the nickname will be updated
2. check your direct multiaddrs for sharing:
```bash
aqua serve --dryrun
```
this command will print the multiaddrs that your peer is listening on, which usually includes local network addresses (e.g., `/ip4/192.168.x.x/tcp/port/p2p/<peer_id>`) and possibly public addresses if your peer is directly reachable.
3. Start serve for listening and message handling:
```bash
aqua serve
```
If you can't run `serve` cmd as a background process, you can use `nohup` or `systemd` or similar tools to manage the process lifecycle in environments.
4. Send a contact invite using the other's address and include one of your own dialable addresses:
```bash
aqua contacts invite "<TARGET_PEER_ADDR>" --address "<YOUR_PEER_ADDR>" --verify
```
* `--verify` is only recommended for trust establishment, but requires out-of-band confirmation of the peer's identity. If accepted, both contacts become `verified`. Omit `--verify` to establish `tofu`.
* `<TARGET_PEER_ADDR>` is other's direct address. Could be printed by `serve --dryrun`.
* `<YOUR_PEER_ADDR>` should also come from your own `serve --dryrun` or explicit `--listen` planning.
5. On the receiver side, inspect and accept the pending invite:
```bash
aqua contacts invites
aqua contacts invite accept <REQUESTER_PEER_ID> --address "<YOUR_PEER_ADDR>"
```
6. Send:
```bash
aqua send <PEER_ID> "hello"
```
7. Check unread messages:
```bash
aqua inbox list --unread
aqua inbox watch --once --mark-read --json
```
## Sending Message Operations
Send message:
```bash
aqua send <PEER_ID> "message content"
```
Use explicit topic/content type when needed:
```bash
aqua send <PEER_ID> "{\"event\":\"greeting\"}" \
--content-type application/json
```
Reply threading metadata (optional):
```bash
aqua send <PEER_ID> "reply text" --reply-to <MESSAGE_ID>
```
Send message in a session (optional, for dialogue semantics):
```bash
aqua send <PEER_ID> "message content" --session-id <SESSION_ID>
```
## Group Operations
Create and inspect groups:
```bash
aqua group create --json
aqua group list --json
aqua group show <GROUP_ID> --json
```
Manage invites and membership:
```bash
aqua group invite <GROUP_ID> <PEER_ID> --json
aqua group invites --json
aqua group invite accept <GROUP_ID> --json
aqua group invite reject <GROUP_ID> --json
```
Send a group message:
```bash
aqua group send <GROUP_ID> "hello group" --json
```
Notes:
- `aqua group invite` now creates a local pending invite and also delivers it over Aqua transport by default.
- Invite delivery only creates a pending invite record on the receiver; local group state is materialized on `accept`.
- Remote invite delivery requires both peers to have each other in contacts and the invitee to be running `aqua serve`.
- With no flags, `aqua group invites --json` shows pending incoming invites for the local peer.
- `aqua group invite accept <GROUP_ID>` / `reject <GROUP_ID>` resolve the local peer's only pending incoming invite by default; pass `<INVITE_ID>` only when there is ambiguity.
- `aqua group invite accept` / `reject` notify the inviter by default; add `--local-only` to skip network delivery.
- Current `aqua group send` is sender-side fanout to known members.
- Incoming group messages use topic `group.message.v1`.
- For agent mailbox processing, filter group traffic with:
``Diskussion
Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.
Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.
Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.
Von GitHub
- GitHub-Sterne
- 259
- Anbieter
- quailyquaily
- Lizenz
- Apache-2.0
- Letzte Codeänderung
- 24. März 2026
- SKILL.md-Dateien im Repo (mit Übersetzungen und Vorlagen)
- 1
- Themen
- agent-skills, agent-tools, ai-agents