manodhithyaa-dev/GraphCode

wonda-cli

Übersicht

Nutze die Wonda CLI, um Bilder, Videos, Musik und Audio direkt vom Terminal zu generieren – plus LinkedIn-, Reddit- und X/Twitter-Recherche und -Automatisierung.

Arbeitsablauf

---

name: wonda-cli beschreibung: Nutze die Wonda CLI, um Bilder, Videos, Musik und Audio direkt vom Terminal zu generieren – plus LinkedIn-, Reddit- und X/Twitter-Recherche und -Automatisierung.

Wonda CLI

Wonda CLI ist eine Content-Erstellungs-Werkzeugkiste für terminalbasierte Agenten. Verwende sie, um Bilder, Videos, Musik und Audio zu generieren; Medien zu bearbeiten und zu komponieren; auf sozialen Plattformen zu veröffentlichen; und auf LinkedIn, Reddit und X/Twitter zu recherchieren/automatisieren.

Installation

Wenn wonda nicht im PATH gefunden wird, installiere es zuerst:

# npm
npm i -g @degausai/wonda

# Homebrew
brew tap degausai/tap && brew install wonda

Einrichtung

• Authentifizierung: wonda auth login (öffnet Browser, empfohlen) oder setze die Umgebungsvariable WONDA_API_KEY
• Überprüfung: wonda auth check

OAuth-Connector-Authentifizierung

Claude-Web- und Cowork-Connector verwenden den Wonda OAuth 2.1-Ablauf anstelle eines CLI-API-Schlüsselfeldes. Der Connector meldet sich über Wonda im Browser an, gewährt den angeforderten Kontozugriff und erhält OAuth-Tokens, die an die Wonda-API-Ressource gebunden sind. Der Server tauscht diese Tokens nur innerhalb von Wonda gegen den internen API-Schlüssel des Kontos aus, sodass Agenten und Connector-Hosts nie den sk_...-Schlüssel sehen. Für den CLI- und lokalen stdio MCP-Pfad verwende weiterhin wonda auth login oder WONDA_API_KEY.

Claude Cowork lokales Relay

Claude Cowork (die Desktop-App) führt lokale MCP-Server auf dem Host aus, sodass es das .mcpb-Bundle oder eine lokale stdio-Konfiguration von wonda-mcp direkt laden kann, inklusive WAB-Schreibzugriff (überprüft 2026-07-07). Claude Web kann das nicht. Das lokale Wonda-Relay ist der alternative Pfad: Es ermöglicht dem REMOTE-Connector (Web oder Cowork), Aktionen auf dem eigenen Mac und der privaten IP-Adresse des Benutzers auszuführen, ohne eine lokale MCP-Konfiguration:

1. Öffne https://wonda.sh/download während du angemeldet bist und installiere das notarisierte Mac-Paket.
2. Kopple das Relay mit wonda relay pair oder der Browser-Übergabe beim ersten Start. Dies verwendet den vorhandenen cli-auth-Ablauf mit einem auf das Relay beschränkten wrelay_...-Credential, das in der macOS Schlüsselbund gespeichert wird. Bitte den Benutzer nicht, einen API-Schlüssel oder Gerätecode einzugeben.
3. Öffne https://wonda.sh/setup, verbinde LinkedIn, X und Reddit über das lokale WAB im Vollbildmodus, und genehmige dann den Wonda-Connector einmal in Claude.

Die Engine-Richtlinie ist auto | my_machine | cloud. auto verwendet das lokale Relay, wenn es online ist, andernfalls die Cloud. my_machine darf nicht stillschweigend zurückfallen: Wenn das Relay offline ist, frage, ob zur Cloud gewechselt werden soll.

Organisationen und Ausgabenkontext

Wondercat-Organisationen sind gemeinsame Wallets mit eigenen Sitzen und Abrechnung. Mitglieder können aus dem Organisations-Wallet ausgeben (anstelle ihrer persönlichen Credits), indem sie den Kontext wechseln:

• wonda organizations list (Aliase: wonda orgs list, wonda org list) – zeige jede Organisation an, in der du Mitglied bist, mit deiner Rolle und deinem Sitzplan.
• wonda use --org <slug> – bleibender Organisationskontext für diesen Rechner. Setzt X-Wonda-Org bei jeder Anfrage; Kontostand, Abrechnungen und wonda balance laufen über das Organisations-Wallet.
• wonda use --personal – zurück zu persönlich.
• wonda usage – ausgabenbezogene Nutzungsübersicht (Gesamt + pro Modell + pro Projekt aufgeschlüsselt) für einen Zeitraum (--month 2026-05 oder --from/--to; Standard ist der aktuelle Monat, UTC). --project <name> schränkt den Bericht auf ein Projekt ein. Im Organisationskontext meldet es die organisationsweite Nutzung mit einer Aufschlüsselung pro Mitglied – Admin-/Besitzerrolle erforderlich. Admins können auch einen vollständigen Excel-Bericht von der Organisationsseite im Web herunterladen.

Projekte (Ausgaben-Tagging)

Projekte ordnen Ausgaben einem benannten Arbeitsstrom zur Überwachung zu. Agenten sollten das aktive Projekt zu Beginn der Aufgabe überprüfen (wonda use zeigt es an) und pro Aufgabe eines setzen, wenn der Betreiber die Ausgaben nach Projekt überwacht:

• wonda use --project <name> – bleibend: Jede nachfolgende Abbuchung trägt das Projekt (in wonda usage, der API und dem Organisations-Excel-Bericht). wonda use --no-project stoppt das Tagging; das Wechseln des Organisations-/persönlichen Kontexts löscht das Projekt automatisch (Projekte sind pro Bereich).
• --project <name> bei jedem Befehl – einmalige Überschreibung für diesen Aufruf.
• wonda project list|create|delete – verwalte das Register im aktiven Bereich. Organisationsprojekte werden nur von Organisations-Admins/Besitzern erstellt; persönliche Projekte sind selbstverwaltet. Das Tagging gegen einen nicht existierenden Namen schlägt mit unknown_project fehl (keine stillen neuen Buckets, damit Tippfehler die Überwachungsdaten nicht aufteilen).

wonda topup lädt immer dein persönliches Wallet auf, unabhängig vom Kontext. Das Aufladen des Organisations-Wallets (und die Konfiguration der automatischen Aufladung) ist nur für Admins und erfolgt im Web unter /organizations/<slug>. Wenn einem Mitglied die Organisations-Credits ausgehen, sagt der Fehler, es solle einen Admin fragen oder zurück zu persönlich wechseln – es kann das Organisations-Wallet nicht über die CLI aufladen.

Rollen innerhalb einer Organisation sind vom Sitzplan getrennt:

• Besitzer: der ursprüngliche Ersteller. Kann nicht herabgestuft oder entfernt werden. Kann das Eigentum von der Organisationsseite an ein anderes Mitglied übertragen (selten).
• Admin: kann einladen (einzeln oder per Masseneinfügung), entfernen, Rollen ändern, Sitze ändern, aufladen, automatische Aufladung konfigurieren, monatliche Limits ändern.
• Benutzer: kann nur innerhalb des Organisations-Wallets ausgeben (vorbehaltlich eines vom Admin festgelegten monatlichen Limits pro Mitglied).

Ein kostenpflichtiger Organisationssitz (WONDA / WONDA_PREMIUM) gewährt den gleichen Zugriff auf kostenpflichtige Funktionen (Fähigkeiten usw.) wie ein persönlicher kostenpflichtiger Plan, jedoch nur im Organisationskontext. wonda use --personal fällt auf den persönlichen Kontoplan des Benutzers zurück.

Zugriffsstufen

Wonda ist nur kostenpflichtig: Jede Produktoberfläche (Generierung, Medien, Veröffentlichung, Scraping, Analyse, Fähigkeiten, Cloud Twin) erfordert einen kostenpflichtigen Plan. Neue Konten erhalten keine Credits und keinen Produktzugriff, bis sie ein Abonnement abschließen.

Stufe	Zugriff
Anonym (temporäres Konto, kein Login)	Kein Produktzugriff. Die CLI erstellt beim ersten Start ein temporäres Konto, erreicht aber nur die lokalen Befehle unten plus die Authentifizierungs-/Abrechnungsendpunkte. Führe wonda auth login aus und schließe dann ein Abonnement ab.
Kostenlos (eingeloggt, kein kostenpflichtiger Plan)	Kein Produktzugriff. Abonniere unter https://wonda.sh/account, um das Produkt zu nutzen.
WONDA (19,99 $/Monat, "Pro")	Alles außer Cloud Twin: Generierung (image/generate, video/generate, ...), Medien-Upload/Download, Veröffentlichung, Scraping, Analysen, Videoanalyse, Fähigkeiten (wonda skill install/list/get), Übergänge, Clipping, E-Mail, Reddit/LinkedIn-Kontoerstellung, Styles, Marke.
WONDA_PREMIUM (49,99 $/Monat, "Premium")	Alles in WONDA, plus Cloud Twin (wonda twin: Bereitstellung, geplante Ausführungen, gestreamter Login) mit Antidetect-/Shadowban-Schutz, keine Obergrenzen und US-Kontoerstellung.
Gekennzeichnet (pro Konto PostHog-Kill-Schalter)	Im kostenpflichtigen Plan enthalten, aber dennoch durch ein pro Konto Flag abschaltbar: wonda reddit signup (redditAccountCreationEnabled), wonda email (emailServerApiEnabled), öffentliche LinkedIn-Profilanreicherung (linkedinProfileEnrichmentEnabled).
Lokal (kein API-Aufruf, keine Credits, kein Plan)	Läuft vollständig auf deinem Rechner, funktioniert daher ohne Plan: wonda brand extract <url> (ohne --save), wonda compose motion/wonda compose text, wonda wab record <url>, wonda edit ... ffmpeg-Primitivtransformationen auf lokalen Dateien und wonda doctor. Die Chromium-basierten benötigen eine einmalige wonda wab install.

Wenn ein Befehl einen 403 (paid_plan_required) zurückgibt, abonniere unter https://wonda.sh/account.

Sprachklonen

Klonen einer Stimme aus einem 10s+ Audio-Clip und Verwendung in TTS. Hartes Limit: 20 geklonte Stimmen pro Konto. Kosten: 1,50 $ pro Klon.

# Klonen aus einer lokalen Datei (wird automatisch zuerst in die Medienbibliothek hochgeladen)
wonda voice create "Andu" --file ./sample.mp3 --description "Meine Stimme"

# Klonen aus vorhandenen Wonda-Medien
wonda voice create "Marke" --media-id <uuid>

# Optionale Quell-Audio-Vorverarbeitung
wonda voice create "Sauber" --file ./raw.wav --noise-reduction --normalize-volume

# Liste der geklonten Stimmen (jede Zeile zeigt isExpired und expiresInDays)
wonda voice list

# Eine Stimme
wonda voice get <voice-id>

# Umbenennen / Neubeschreiben (lokal, kein Provider-Aufruf)
wonda voice update <voice-id> --name "Neuer Name" --description "..."

# Löschen
wonda voice delete <voice-id>

Verwende eine geklonte Stimme in TTS, indem du providerVoiceId von voice get als voiceId an /audio/speech übergibst:

wonda audio speech "Hallo Welt" \
  --model minimax-speech-2-8-hd \
  --params '{"voiceId":"<providerVoiceId>"}'

7-Tage-Ablauf: Geklonte Stimmen, die nicht innerhalb von 7 Tagen in TTS verwendet wurden, laufen automatisch ab. Das Ausführen von TTS mit einer geklonten Stimme verlängert deren Ablauf automatisch. Stimmen, die inaktiv bleiben und ablaufen, müssen erneut geklont werden (wieder 1,50 $).

Credential-Tresor

Speichere Logins, die auf externen Plattformen (Instagram, TikTok, Twitter, usw.) erstellt wurden, sodass sie beim nächsten Durchlauf wiederverwendet werden können. Passwörter werden mit AES-256-GCM mit einem serverseitigen Schlüssel verschlüsselt und nur bei get entschlüsselt.

# Erstellen
wonda credentials create --website instagram.com --username meinbenutzername \
  --email [email protected] --password-stdin <<< "geheim123" \
  --metadata '{"signup_source":"wonda-email"}'

# Auflisten (Passwörter ausgelassen)
wonda credentials list --website instagram.com

# Vollständigen Datensatz inklusive entschlüsseltem Passwort abrufen
wonda credentials get <id>

# Beliebiges Feld aktualisieren (verwende --password-stdin zum Drehen; --username "" zum Löschen)
wonda credentials update <id> --username neuerbenutzername

# Löschen
wonda credentials delete <id>

# Abrufen + Grund für die Verwendung in einem Aufruf erfassen – POST, nicht GET, da
es ein 'used'-Ereignis mit dem Grund schreibt. Bevorzuge dies gegenüber `get`, wann immer du
    den Grund angeben kannst.
wonda credentials use <id> --reason "instagram-anmeldeablauf"

# Aktuelle Ereignisse (erstellt / verwendet / gedreht / aktualisiert) zur Prüfung anzeigen
wonda credentials events <id>

Felder: website (erforderlich – Texteingabe wie insta wird zu instagram.com kanonisiert), username, email, password (erforderlich), metadata (beliebiges JSON). Mindestens eines von username / email muss vorhanden sein. Mehrere Datensätze pro (website, username) sind erlaubt – dedupliziere bei Bedarf selbst.

Ereignisprotokoll: Jede credentials get/use, create, Passwortdrehung und andere Aktualisierungen werden als Ereignisse im Credential aufgezeichnet (Akteur: cli | web | system). Verwende credentials events <id> oder das Verlaufssymbol der Weboberfläche zur Prüfung. Das Ereignisprotokoll ist nur anhängbar und wird beim Löschen von Credentials kaskadiert.

Globale Ausgabeflags

Alle Befehle unterstützen diese Ausgabesteuerungsflags:

• --json – JSON-Ausgabe erzwingen (automatisch aktiviert, wenn stdout umgeleitet wird)
• --quiet – Nur die primäre Kennung ausgeben (Job-ID, Medien-ID usw.) – ideal für Skripting
• -o <pfad> – Ausgabe in Datei herunterladen (impliziert --wait)
• --fields status,outputs – Bestimmte JSON-Felder auswählen
• --jq '.outputs[0].media.url' – JSON-Ausgabe mit einem jq-Ausdruck filtern

CLI-Ankündigungen und Veraltungswarnungen

Bei jedem Befehl fragt die CLI GET /api/v1/updates ab (anonym, 1h Cache in ~/.wonda/state.json) nach aktiven Ankündigungen: Veraltungshinweise, Vorfallwarnungen, Upgrade-Aufforderungen. Nachrichten werden nur auf stderr ausgegeben, sodass stdout/JSON für Piping sauber bleibt.

Pro-Anfrage-Veraltungshinweise treffen als Standard-HTTP-Header Warning: 299 - "<message>" ein und werden vom HTTP-Client der CLI als [deprecated METHOD /path] <message> auf stderr ausgegeben.

Beide Kanäle mit WONDA_QUIET=1 (Umgebungsvariable) oder --quiet (Flag) stummschalten. Nur die Netzwerkprüfungen mit WONDA_NO_UPDATE_CHECK=1 deaktivieren.

WAB / Wonda Automation Browser (wonda wab)

Der Wonda Automation Browser (WAB) ist ein Premium-Stealth-Antidetect-Browser, der so gehärtet ist, dass Plattformen ihn nicht als Automatisierung erkennen können. wonda wab ist der eine Befehl für den Antidetect-Chromium-Stapel (ein unerkannter Playwright-Fork). Er hat zwei Gesichter:

• Authentifizierte Sitzungen. Ein dauerhafter, sichtbarer Chromium pro Persona, der angemeldete Sitzungen für LinkedIn, X, Reddit und andere hält. Die CLI startet ihn bei Bedarf, lässt ihn im Leerlauf auslaufen und leitet Plattform-Lese-/Schreibzugriffe durch ihn, wenn ein Befehl mit --via wab ausgeführt wird. Cookies leben im Chromium-Profil der Persona, nicht in ~/.wonda/config.json.
• Anonyme Erfassung. wonda wab record <url> (und wonda brand extract) verwenden einen flüchtigen Chromium mit einem frischen Fingerabdruck, ohne Persona, ohne Cookies. Siehe den record-Block unten.

Das mentale Modell: Du hast Konten (eine Identität pro Plattform). Jeder Plattformbefehl leitet zu den Cookies dieses Kontos entweder über den flachen JSON-Speicher (--via cookies, schnell, kein Chromium) oder die Persona des Kontos (--via wab, Live-Antidetect-Chromium). Eine Persona ist die Chromium-Hülle, die mehrere Konten unter einem Fingerabdruck halten kann. In fast jedem Fall ist die Persona autark. Ein direkter Aufruf von wonda wab erfordert ein Unterkommando (z. B. record). Ohne Unterkommando oder mit --help wird die Hilfe angezeigt.