degausai/wonda

Wonda CLI

Die Wonda CLI ist ein Content-Erstellungs-Toolkit für terminalbasierte Agenten. Verwenden Sie es, um Bilder, Videos, Musik und Audio zu generieren; Medien zu bearbeiten und zu komponieren; auf sozialen Plattformen zu veröffentlichen; und auf LinkedIn, Reddit sowie X/Twitter zu recherchieren/automatisieren.

Installation

Wenn wonda nicht im PATH gefunden wird, installieren Sie es zuerst. Die empfohlenen Installationen sind die signierten Desktop-Installer (CLI + Tray-Symbol + Always-On-Relay, null zusätzliche Schritte): macOS brew install --cask degausai/tap/wonda-app (oder die wonda-macos.pkg aus den Releases), Windows winget/wonda-windows-setup.exe. Die reinen CLI-Kanäle unten funktionieren überall und können die Desktop-App später mit wonda app install hinzufügen:

# npm
npm i -g @degausai/wonda

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

Einrichtung

• Auth: wonda auth login (öffnet Browser, empfohlen) oder WONDA_API_KEY-Umgebungsvariable setzen
• Verifizieren: wonda auth check

OAuth-Connector-Authentifizierung

Claude Web- und Cowork-Connectors verwenden den OAuth 2.1-Flow von Wonda anstelle eines CLI-API-Key-Felds. 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-Key des Kontos ein, sodass Agenten und Connector-Hosts den sk_...-Key nie sehen. Für den CLI- und lokalen stdio-MCP-Pfad verwenden Sie weiterhin wonda auth login oder WONDA_API_KEY.

Claude Cowork Local Relay

Claude Cowork (die Desktop-App) führt lokale MCP-Server auf dem Host aus, daher kann sie das .mcpb-Bundle oder eine lokale stdio-wonda-mcp-Konfiguration direkt laden (WAB-Schreibvorgänge enthalten, verifiziert am 2026-07-07). Claude Web kann das nicht. Der Wonda Local Relay ist der alternative Pfad: Er ermöglicht es dem REMOTE-Connector (Web oder Cowork), Aktionen auf dem eigenen Mac des Benutzers und der eigenen IP auszuführen, ohne lokale MCP-Konfiguration:

1. Öffnen Sie https://wonda.sh/download während Sie angemeldet sind, und installieren Sie das notarielle Mac-Paket.
2. Koppeln Sie den Relay mit wonda relay pair oder der Browser-Übergabe beim ersten Start. Dabei wird der vorhandene cli-auth-Flow mit einem Relay-spezifischen wrelay_...-Credential verwendet, das in der macOS-Keychain gespeichert wird. Bitten Sie den Benutzer nicht, einen API-Key oder Gerätecode einzufügen.
3. Öffnen Sie https://wonda.sh/setup, verbinden Sie LinkedIn, X und Reddit über den lokalen WAB-Client, und genehmigen Sie dann den Wonda-Connector einmal in Claude.

Die Engine-Policy ist auto | my_machine | cloud. auto verwendet den lokalen Relay, wenn er online ist, und andernfalls Cloud. my_machine darf nicht stillschweigend zurückfallen: Wenn der Relay offline ist, fragen Sie, ob auf Cloud umgeschaltet werden soll.

Organisationen und Ausgabenkontext

Wondercat-Organisationen sind gemeinsame Wallets mit eigenen Sitzplätzen 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) – sehen Sie jede Organisation, der Sie angehören, mit Ihrer Rolle und Ihrem Sitzplatzplan.
• wonda use --org <slug> – dauerhafter Organisationskontext für diesen Rechner. Setzt X-Wonda-Org bei jeder Anfrage; Guthaben, Belastungen und wonda balance laufen über das Organisations-Wallet.
• wonda use --personal – zurück zu persönlich.
• wonda usage – ausgabenbezogene Nutzungsübersicht (Gesamt + Aufschlüsselung nach Modell + nach Projekt) für einen Zeitraum (--month 2026-05, oder --from/--to; standardmäßig der aktuelle Monat, UTC). --project <name> schränkt den Bericht auf ein Projekt ein. Im Organisationskontext wird die organisationsweite Nutzung einschließlich einer Aufschlüsselung pro Mitglied gemeldet – Admin/Owner-Rolle erforderlich. Admins können außerdem einen vollständigen Excel-Bericht von der Org-Seite im Web herunterladen.

Projekte (Ausgaben-Tagging)

Projekte ordnen Ausgaben einem benannten Arbeitsstrom zu, um sie zu überwachen. Agenten sollten zu Beginn einer Aufgabe das aktive Projekt überprüfen (wonda use gibt es aus) und eines pro Aufgabe setzen, wenn der Betreiber die Ausgaben nach Projekt verfolgt:

• wonda use --project <name> – dauerhaft: Jede nachfolgende Belastung trägt das Projekt (in wonda usage, der API und dem Org-Excel-Bericht). wonda use --no-project stoppt das Tagging; das Wechseln des Org-/Personalkontexts 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 – Verwaltung des Registers im aktiven Bereich. Org-Projekte werden nur von Org-Admins/Ownern erstellt; persönliche Projekte sind Self-Service. Das Taggen gegen einen nicht vorhandenen Namen schlägt mit unknown_project fehl (keine stillen neuen Buckets, daher können Tippfehler die Überwachungsdaten nicht aufteilen).

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

Rollen innerhalb einer Organisation sind vom Sitzplatzplan getrennt:

• Owner: Der ursprüngliche Ersteller. Kann nicht herabgestuft oder entfernt werden. Kann das Eigentum von der Org-Seite aus an ein anderes Mitglied übertragen (selten).
• Admin: Kann einladen (einzeln oder per Masseneinfügung), entfernen, Rollen ändern, Sitzplätze ändern, aufladen, automatisches Aufladen konfigurieren, monatliche Limits ändern.
• User: Kann nur innerhalb des Organisations-Wallets ausgeben (vorbehaltlich eines vom Admin festgelegten monatlichen Limits pro Mitglied).

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

Zugriffsstufen

Wonda ist kostenpflichtig: Jede Produktoberfläche erfordert einen kostenpflichtigen Plan, einschließlich API-Aufrufe, lokale Plattformlesevorgänge, Browser-Automatisierung, Medienkomposition, Dateibearbeitung, Diagnose, Generierung, Veröffentlichung, Scraping, Analyse, Skills, Relay-Betrieb und Cloud Twin. Bevor ein Produktbefehl Arbeit verrichtet, führt die CLI eine Live-Berechtigungsprüfung gegen Wonda durch. Die Prüfung schlägt fehl, wenn der Zugriff nicht verifiziert werden kann. Neue Konten erhalten keinen Produktzugriff, bis sie ein Abonnement abschließen, und ein positives Credit-Guthaben ersetzt keinen Plan.

Stufe	Zugriff
Anonym (kein Login)	Kein Produktzugriff. Authentifizierung, Konfiguration, Preise, Organisationserkennung/-auswahl, Shell-Vervollständigung und lokale Shutdown-Befehle bleiben verfügbar, damit der Benutzer ein Abonnement abschließen, wiederherstellen oder Hintergrunddienste stoppen kann. Führen Sie wonda auth login aus, dann abonnieren.
Free (eingeloggt, kein kostenpflichtiger Plan)	Kein Produktzugriff. Abonnieren Sie 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, Skills (wonda skill install/list/get), Übergänge, Clip-Erstellung, E-Mail, Reddit-/LinkedIn-Kontoerstellung, Stile, 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 Limits und US-Kontoerstellung.
Flagged (pro-Konto PostHog-Kill-Switches)	Im kostenpflichtigen Plan enthalten, aber dennoch durch ein pro-Konto-Flag steuerbar: wonda reddit signup (redditAccountCreationEnabled), wonda email (emailServerApiEnabled), öffentliche LinkedIn-Profilanreicherung (linkedinProfileEnrichmentEnabled).

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

Dies gilt auch für den lokalen stdio-MCP-Pfad, da MCP dieselbe CLI ausführt. Plattform-Cookies und -Daten bleiben auf dem Gerät, aber der Befehl muss zuerst eine erfolgreiche Zugriffsentscheidung von GET /api/v1/auth/access erhalten. Eine reine Relay-Installation darf ihr bereichsspezifisches wrelay_...-Credential für diese Berechtigungssonde verwenden. Das bereichsspezifische Credential kann immer noch keine gewöhnlichen Konten-APIs aufrufen.

Stimmklonierung

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

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

# Aus vorhandenen Wonda-Medien klonen
wonda voice create "Marke" --media-id <uuid>

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

# Geklonte Stimmen auflisten (jede Zeile meldet 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>

Eine geklonte Stimme in TTS verwenden, indem Sie die providerVoiceId aus voice get als voiceId an /audio/speech übergeben:

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. Die Ausführung von TTS mit einer geklonten Stimme verlängert deren Ablauf automatisch. Untätige Stimmen, die verfallen, müssen erneut geklont werden (erneut 1,50 $).

Anmeldedaten-Tresor

Speichern Sie Logins, die auf externen Plattformen erstellt wurden (Instagram, TikTok, Twitter usw.), damit sie beim nächsten Lauf 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 myhandle \
  --email [email protected] --password-stdin <<< "hunter2" \
  --metadata '{"signup_source":"wonda-email"}'

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

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

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

# Löschen
wonda credentials delete <id>

# Abrufen + Grund der Verwendung in einem Aufruf erfassen – POST, nicht GET, weil
es ein 'used'-Ereignis mit dem Grund schreibt. Bevorzugen Sie dies gegenüber `get`, wann immer
Sie den Grund formulieren können.
wonda credentials use <id> --reason "instagram-signup-flow"

# Aktuelle Ereignisse anzeigen (erstellt / verwendet / rotiert / aktualisiert) für die Prüfung
wonda credentials events <id>

Felder: website (erforderlich – getippte Eingabe 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 zulässig – deduplizieren Sie auf Ihrer Seite, falls erforderlich.

Ereignisprotokoll: Jedes credentials get/use, create, Passwort-Rotation und andere Aktualisierungen werden als Ereignisse auf dem Credential aufgezeichnet (Akteur: cli | web | system). Verwenden Sie credentials events <id> oder das Verlaufssymbol in der Weboberfläche zur Prüfung. Das Ereignisprotokoll ist nur zum Anhängen und kaskadiert beim Löschen des Credentials.

Globale Ausgabeflags

Alle Befehle unterstützen diese Ausgabesteuerungsflags:

• --json — JSON-Ausgabe erzwingen (automatisch aktiviert, wenn stdout weitergeleitet 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 Veraltungshinweise

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

Pro-Anfrage-Veraltungshinweise kommen als standardmäßiger Warning: 299 - "<message>" HTTP-Header und werden vom CLI-HTTP-Client auf stderr als [deprecated METHOD /path] <message> ausgegeben.

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

WAB / Wonda Automation Browser (wonda wab)

1Password ist in lokalen WAB-Profilen enthalten. WAB lädt die offizielle stabile 1Password-Browsererweiterung herunter, überprüft ihre Herausgebersignatur und heftet sie beim ersten Setup an die Symbolleiste. Öffnen Sie den WAB mit wonda wab show <persona>, klicken Sie dann auf 1Password, um sich anzumelden. Jede Persona behält ihre eigene 1Password-Sitzung. Die Desktop-App erfordert möglicherweise, dass Sie WAB als zusätzlichen Browser genehmigen; die direkte Anmeldung in der Erweiterung funktioniert ebenfalls. Zwischengespeicherte Erweiterungsdateien funktionieren offline. WAB sucht höchstens einmal täglich nach Updates für zwischengespeicherte Erweiterungen, wenn eine Persona gestartet wird, einschließlich fehlgeschlagener Prüfungen; das Ändern der Chromium-Version löst eine weitere Kompatibilitätsprüfung aus. Wenn die Erweiterung noch nie erfolgreich installiert wurde, wird die Installation bei jedem Start wiederholt. Ein bereits laufender Browser nimmt ein Erweiterungs-Update beim nächsten Start auf. Startup und wab install bereinigen ungenutzte zwischengespeicherte Versionen, die älter als sieben Tage sind; Versionen, die von einem aktiven WAB-Prozess verwendet werden, werden behalten. Setzen Sie WAB_ONEPASSWORD=0 vor dem Starten von WAB, um die gebündelte Erweiterung zu überspringen. Anonyme Aufnahmen, Scratch-Sitzungen und Cloud Twins laden sie nicht. Ein Wonda-Datenpfad, der ein Komma enthält, überspringt 1Password ebenfalls mit einem dr...