degausai/wonda

Wonda CLI

Wonda CLI est une boîte à outils de création de contenu pour les agents terminaux. Utilisez-la pour générer des images, vidéos, musique et audio ; éditer et composer des médias ; publier sur les plateformes sociales ; et rechercher/automatiser sur LinkedIn, Reddit et X/Twitter.

Installation

Si wonda n'est pas trouvé dans le PATH, installez-le d'abord. Les installations recommandées sont les installateurs de bureau signés (CLI + icône de la barre d'état + relais toujours actif, zéro étape supplémentaire) : macOS brew install --cask degausai/tap/wonda-app (ou le wonda-macos.pkg depuis les releases), Windows winget/wonda-windows-setup.exe. Les canaux CLI uniquement ci-dessous fonctionnent partout et peuvent ajouter l'application de bureau plus tard avec wonda app install :

# npm
npm i -g @degausai/wonda

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

Configuration

• Authentification : wonda auth login (ouvre le navigateur, recommandé) ou définir la variable d'environnement WONDA_API_KEY
• Vérification : wonda auth check

Authentification du connecteur OAuth

Les connecteurs Claude Web et Cowork utilisent le flux OAuth 2.1 de Wonda au lieu d'un champ de clé API CLI. Le connecteur se connecte via Wonda dans le navigateur, accorde l'accès au compte demandé et reçoit des jetons OAuth liés à la ressource API Wonda. Le serveur échange ces jetons pour la clé API interne du compte uniquement à l'intérieur de Wonda, de sorte que les agents et les hôtes du connecteur ne voient jamais la clé sk_.... Pour le CLI et le chemin MCP stdio local, continuez à utiliser wonda auth login ou WONDA_API_KEY.

Relais local Claude Cowork

Claude Cowork (l'application de bureau) exécute des serveurs MCP locaux sur l'hôte, il peut donc charger le bundle .mcpb ou une configuration wonda-mcp stdio locale directement, les écritures WAB incluses (vérifié le 2026-07-07). Claude Web ne le peut pas. Le relais local Wonda est le chemin alternatif : il permet au connecteur DISTANT (Web ou Cowork) d'exécuter des actions sur le propre Mac de l'utilisateur et sur son IP résidentielle sans aucune configuration MCP locale :

1. Ouvrez https://wonda.sh/download connecté et installez le package Mac notarié.
2. Associez le relais avec wonda relay pair ou la transmission initiale du navigateur. Cela utilise le flux cli-auth existant avec un crédentiel wrelay_... à portée de relais stocké dans le trousseau macOS. Ne demandez pas à l'utilisateur de coller une clé API ou un code d'appareil.
3. Ouvrez https://wonda.sh/setup, connectez LinkedIn, X et Reddit via le WAB local complet, puis approuvez le connecteur Wonda une fois dans Claude.

La politique du moteur est auto | my_machine | cloud. auto utilise le relais local lorsqu'il est en ligne et le cloud sinon. my_machine ne doit pas basculer silencieusement : si le relais est hors ligne, demandez s'il faut passer au cloud.

Organisations & contexte de dépenses

Les organisations Wondercat sont des portefeuilles partagés avec leurs propres sièges et facturation. Les membres peuvent dépenser à partir du portefeuille de l'organisation (au lieu de leurs crédits personnels) en changeant de contexte :

• wonda organizations list (alias : wonda orgs list, wonda org list) — voir chaque organisation à laquelle vous appartenez avec votre rôle et votre plan de siège respectifs.
• wonda use --org <slug> — contexte d'organisation persistant pour cette machine. Définit X-Wonda-Org sur chaque requête ; les prélèvements, les frais et wonda balance passent par le portefeuille de l'organisation.
• wonda use --personal — retour au contexte personnel.
• wonda usage — résumé de l'utilisation uniquement des dépenses (total + répartition par modèle + par projet) pour une période (--month 2026-05, ou --from/--to ; par défaut le mois en cours, UTC). --project <nom> limite le rapport à un seul projet. Dans le contexte de l'organisation, il rapporte l'utilisation à l'échelle de l'organisation avec une répartition par membre — rôle admin/propriétaire requis. Les administrateurs peuvent également télécharger un rapport Excel complet depuis la page de l'organisation sur le web.

Projets (étiquetage des dépenses)

Les projets attribuent les dépenses à un flux de travail nommé pour le suivi. Les agents doivent vérifier le projet actif au début de la tâche (wonda use l'affiche) et en définir un par tâche lorsque l'opérateur surveille les dépenses par projet :

• wonda use --project <nom> — persistant : chaque charge ultérieure porte le projet (dans wonda usage, l'API et le rapport Excel de l'organisation). wonda use --no-project arrête l'étiquetage ; le changement de contexte organisation/personnel efface automatiquement le projet (les projets sont par portée).
• --project <nom> sur n'importe quelle commande — remplacement ponctuel pour cette invocation.
• wonda project list|create|delete — gérer le registre dans la portée active. Les projets d'organisation sont créés uniquement par les administrateurs/propriétaires de l'organisation ; les projets personnels sont en libre-service. L'étiquetage avec un nom qui n'existe pas échoue avec unknown_project (pas de nouveaux buckets silencieux, donc les fautes de frappe ne peuvent pas diviser les données de suivi).

wonda topup rechargé toujours votre portefeuille personnel, quel que soit le contexte. Le rechargement du portefeuille de l'organisation (et la configuration du rechargement automatique) est réservé aux administrateurs et se fait sur le web à /organizations/<slug>. Si un membre manque de crédits d'organisation, l'erreur lui demande de contacter un administrateur ou de revenir au personnel — il ne peut pas recharger le portefeuille de l'organisation depuis le CLI.

Les rôles au sein d'une organisation sont distincts du plan de siège :

• Propriétaire : le créateur original. Ne peut pas être rétrogradé ou expulsé. Peut transférer la propriété à un autre membre depuis la page de l'organisation (rare).
• Administrateur : peut inviter (unique ou en masse via copier-coller), expulser, changer les rôles, changer les sièges, recharger, configurer le rechargement automatique, modifier les limites mensuelles.
• Utilisateur : peut seulement dépenser dans le portefeuille de l'organisation (sous réserve d'une limite mensuelle par membre si l'administrateur en a défini une).

Un siège d'organisation payant (WONDA / WONDA_PREMIUM) accorde le même accès aux fonctionnalités payantes (skills, etc.) qu'un plan personnel payant, mais seulement dans le contexte de l'organisation. wonda use --personal revient au plan du compte personnel de l'utilisateur.

Niveaux d'accès

Wonda est uniquement payant : chaque surface de produit nécessite un plan payant, y compris les appels API, les lectures locales de plateformes, l'automatisation du navigateur, la composition multimédia, l'édition de fichiers, les diagnostics, la génération, la publication, le scraping, l'analyse, les compétences, le fonctionnement du relais et le jumeau cloud. Avant que toute commande produit ne fasse du travail, le CLI effectue une vérification des droits en direct contre Wonda. La vérification échoue en mode fermé lorsque l'accès ne peut pas être vérifié. Les nouveaux comptes n'ont aucun accès produit jusqu'à ce qu'ils s'abonnent, et un solde de crédit positif ne remplace pas un plan.

Niveau	Accès
Anonyme (non connecté)	Aucun accès produit. Les commandes d'authentification, de configuration, de tarification, de découverte/sélection d'organisation, de complétion de shell et d'arrêt local restent disponibles afin que l'utilisateur puisse s'abonner, récupérer ou arrêter les services en arrière-plan. Exécutez wonda auth login, puis abonnez-vous.
Gratuit (connecté, sans plan payant)	Aucun accès produit. Abonnez-vous à https://wonda.sh/account pour utiliser le produit.
WONDA (19,99 $/mo, "Pro")	Tout sauf le jumeau cloud : génération (image/generate, video/generate, ...), téléchargement/téléchargement de médias, publication, scraping, analyse, analyse vidéo, compétences (wonda skill install/list/get), transitions, clipping, email, création de compte reddit/linkedin, styles, marque.
WONDA_PREMIUM (49,99 $/mo, "Premium")	Tout dans WONDA, plus jumeau cloud (wonda twin : provisionnement, exécutions planifiées, connexion diffusée) avec protection anti-détection / anti-shadowban, sans plafond et création de compte américain.
Signalé (interrupteurs de sécurité PostHog par compte)	Inclus dans le plan payant mais toujours verrouillable par un indicateur par compte : wonda reddit signup (redditAccountCreationEnabled), wonda email (emailServerApiEnabled), enrichissement public du profil LinkedIn (linkedinProfileEnrichmentEnabled).

Si une commande renvoie une erreur 403 (paid_plan_required), abonnez-vous à https://wonda.sh/account.

Ceci s'applique également au chemin MCP stdio local car MCP exécute le même CLI. Les cookies et données de la plateforme restent sur l'appareil, mais la commande doit d'abord recevoir une décision d'accès payant réussie de GET /api/v1/auth/access. Une installation uniquement relais peut utiliser son crédentiel wrelay_... à portée limitée pour cette sonde de droits. Le crédentiel à portée limitée ne peut toujours pas appeler les API de compte ordinaires.

Clonage vocal

Clonez une voix à partir d'un clip audio de 10 s+ et utilisez-la dans le TTS. Limite stricte : 20 voix clonées par compte. Coût : 1,50 $ par clone.

# Cloner à partir d'un fichier local (télécharge automatiquement dans la médiathèque d'abord)
wonda voice create "Andu" --file ./sample.mp3 --description "Ma voix"

# Cloner à partir d'un média wonda existant
wonda voice create "Brand" --media-id <uuid>

# Prétraitement optionnel de l'audio source
wonda voice create "Clean" --file ./raw.wav --noise-reduction --normalize-volume

# Lister les voix clonées (chaque ligne indique isExpired et expiresInDays)
wonda voice list

# Une voix
wonda voice get <voice-id>

# Renommer / redécrire (local uniquement, sans appel au fournisseur)
wonda voice update <voice-id> --name "Nouveau nom" --description "..."

# Supprimer
wonda voice delete <voice-id>

Utiliser une voix clonée dans TTS en passant le providerVoiceId de voice get comme voiceId à /audio/speech :

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

Expiration de 7 jours : les voix clonées qui n'ont pas été utilisées dans TTS pendant 7 jours sont automatiquement expirées. L'exécution de TTS avec une voix clonée renouvelle automatiquement son expiration. Les voix inactives qui expirent doivent être reclonées (1,50 $ à nouveau).

Coffre-fort d'identifiants

Conservez les connexions créées sur des plateformes externes (Instagram, TikTok, Twitter, etc.) afin qu'elles puissent être réutilisées lors de la prochaine exécution. Les mots de passe sont chiffrés avec AES-256-GCM à l'aide d'une clé côté serveur et ne sont déchiffrés que lors du get.

# Créer
wonda credentials create --website instagram.com --username monpseudo \
  --email [email protected] --password-stdin <<< "hunter2" \
  --metadata '{"signup_source":"wonda-email"}'

# Lister (mots de passe omis)
wonda credentials list --website instagram.com

# Obtenir l'enregistrement complet, y compris le mot de passe déchiffré
wonda credentials get <id>

# Mettre à jour n'importe quel champ (utiliser --password-stdin pour faire pivoter ; --username "" pour effacer)
wonda credentials update <id> --username nouveaupseudo

# Supprimer
wonda credentials delete <id>

# Récupérer + enregistrer la raison pour laquelle vous l'utilisez en un seul appel — POST, pas GET, car
# il écrit un événement 'utilisé' avec la raison. Préférez ceci à `get` chaque fois que
# vous pouvez articuler la raison.
wonda credentials use <id> --reason "flux d'inscription instagram"

# Voir les événements récents (créé / utilisé / pivoté / mis à jour) pour audit
wonda credentials events <id>

Champs : website (requis — la saisie typée comme insta est canoniquée en instagram.com), username, email, password (requis), metadata (JSON arbitraire). Au moins un de username / email doit être présent. Plusieurs enregistrements par (website, username) sont autorisés — dédupliquez de votre côté si nécessaire.

Journal des événements : chaque credentials get/use, create, rotation de mot de passe et autres mises à jour sont enregistrés comme événements sur l'identifiant (acteur : cli | web | system). Utilisez credentials events <id> ou l'icône d'historique de l'interface Web pour auditer. Le journal des événements est en ajout seul et se propage lors de la suppression de l'identifiant.

Indicateurs de sortie globaux

Toutes les commandes prennent en charge ces indicateurs de contrôle de sortie :

• --json — Forcer la sortie JSON (activé automatiquement lorsque stdout est redirigé)
• --quiet — Sortir uniquement l'identifiant principal (ID de tâche, ID de média, etc.) — idéal pour les scripts
• -o <chemin> — Télécharger la sortie vers un fichier (implique --wait)
• --fields status,outputs — Sélectionner des champs JSON spécifiques
• --jq '.outputs[0].media.url' — Filtrer la sortie JSON avec une expression jq

Annonces CLI et avertissements d'obsolescence

Sur chaque commande, le CLI interroge GET /api/v1/updates (anonyme, mise en cache de 1 h dans ~/.wonda/state.json) pour les annonces actives : avis d'obsolescence, alertes d'incident, invites de mise à niveau. Les messages sont imprimés sur stderr uniquement, donc stdout/JSON reste propre pour le piping.

Les indicateurs d'obsolescence par requête arrivent sous la forme de l'en-tête HTTP standard Warning: 299 - "<message>" et sont affichés sur stderr par le client HTTP du CLI sous la forme [obsolète METHOD /path] <message>.

Silencez les deux canaux avec WONDA_QUIET=1 (variable d'environnement) ou --quiet (indicateur). Désactivez uniquement les vérifications réseau avec WONDA_NO_UPDATE_CHECK=1.

WAB / Navigateur d'automatisation Wonda (wonda wab)

1Password est inclus dans les profils WAB locaux. WAB télécharge l'extension de navigateur 1Password stable officielle, vérifie sa signature d'éditeur et l'épingle à la barre d'outils lors de la première configuration. Ouvrez le WAB avec wonda wab show <persona>, puis cliquez sur 1Password pour vous connecter. Chaque persona conserve sa propre session 1Password. L'application de bureau peut vous demander d'approuver WAB comme navigateur supplémentaire ; la connexion directement dans l'extension fonctionne également. Les fichiers d'extension mis en cache fonctionnent hors ligne. WAB vérifie les extensions mises en cache pour les mises à jour au maximum une fois par jour lorsqu'un persona démarre, y compris les vérifications échouées ; le changement de version de Chromium déclenche une autre vérification de compatibilité. Si l'extension n'a jamais été installée avec succès, chaque démarrage réessaie l'installation. Un navigateur déjà en cours d'exécution prend en compte une mise à jour de l'extension lors de son prochain démarrage. Le démarrage et wab install suppriment les versions mises en cache inutilisées de plus de sept jours ; les versions utilisées par un processus WAB en direct sont conservées. Définissez WAB_ONEPASSWORD=0 avant de démarrer WAB pour ignorer l'extension fournie. Les captures anonymes, les sessions temporaires et les jumeaux cloud ne la chargent pas. Un chemin de données Wonda contenant une virgule ignore également 1Password avec un avertissement.