degausai/wonda

Wonda CLI

Wonda CLIは、端末ベースのエージェント向けコンテンツ作成ツールキットです。画像、動画、音楽、音声の生成、メディアの編集と合成、ソーシャルプラットフォームへの公開、LinkedIn、Reddit、X/Twitterでのリサーチと自動化に使用します。

インストール

wondaがPATHに見つからない場合は、最初にインストールします。推奨されるインストール方法は署名付きデスクトップインストーラー（CLI＋トレイアイコン＋常時オンリレー、追加手順不要）です：macOS brew install --cask degausai/tap/wonda-app（またはリリースページのwonda-macos.pkg）、Windows winget/wonda-windows-setup.exe。以下のCLI限定チャンネルはどこでも動作し、後からwonda app installでデスクトップアプリを追加できます：

# npm
npm i -g @degausai/wonda

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

セットアップ

• 認証: wonda auth login（ブラウザを開く、推奨）またはWONDA_API_KEY環境変数を設定
• 確認: wonda auth check

OAuthコネクター認証

Claude WebおよびCoworkコネクターは、CLIのAPIキーフィールドの代わりにWondaのOAuth 2.1フローを使用します。コネクターはブラウザでWondaにサインインし、要求されたアカウントアクセスを許可し、Wonda APIリソースにバインドされたOAuthトークンを受け取ります。サーバーはそれらのトークンをアカウントの内部APIキーに交換する処理をWonda内部でのみ行うため、エージェントやコネクターホストがsk_...キーを目にすることはありません。CLIおよびローカルのstdio MCPパスでは、引き続きwonda auth loginまたはWONDA_API_KEYを使用してください。

Claude Coworkローカルリレー

Claude Cowork（デスクトップアプリ）はホスト上でローカルMCPサーバーを実行するため、.mcpbバンドルまたはローカルのstdio wonda-mcp設定を直接読み込むことができ、WAB書き込みも含まれます（2026-07-07確認済み）。Claude Webはそれができません。Wondaローカルリレーは代替パスです。これにより、リモートコネクター（WebまたはCowork）が、ローカルMCP設定なしでユーザー自身のMacと住宅用IP上でアクションを実行できるようになります：

1. サインインした状態でhttps://wonda.sh/downloadを開き、公証済みのMacパッケージをインストールします。
2. wonda relay pairまたは初回実行時のブラウザハンドオフでリレーをペアリングします。これは既存のcli-authフローを使用し、macOSキーチェーンに保存されたリレースコープのwrelay_...資格情報を使用します。ユーザーにAPIキーやデバイスコードを貼り付けさせる必要はありません。
3. https://wonda.sh/setupを開き、ヘッドフルなローカルWABを通じてLinkedIn、X、Redditを接続し、ClaudeでWondaコネクターを一度承認します。

エンジンポリシーはauto | my_machine | cloudです。autoはローカルリレーがオンラインの場合はそれを使用し、そうでない場合はクラウドを使用します。my_machineは静かにフォールバックしてはいけません：リレーがオフラインの場合は、クラウドに切り替えるかどうかを確認してください。

組織と支出コンテキスト

Wondercat組織は、独自のシートと課金を持つ共有ウォレットです。メンバーはコンテキストを切り替えることで、個人クレジットではなく組織ウォレットから支出できます：

• wonda organizations list（エイリアス：wonda orgs list、wonda org list）— 所属するすべての組織と、それぞれにおける役割とシートプランを表示します。
• wonda use --org <slug> — このマシンでのスティッキーな組織コンテキスト。すべてのリクエストにX-Wonda-Orgを設定し、保留、課金、wonda balanceは組織ウォレットを経由します。
• wonda use --personal — 個人に戻します。
• wonda usage — 期間指定可能な支出のみの使用状況サマリー（合計＋モデル別＋プロジェクト別の内訳）（--month 2026-05、または--from/--to；デフォルトは現在の月、UTC）。--project <name>はレポートを1つのプロジェクトに制限します。組織コンテキストでは、メンバー別内訳を含む組織全体の使用状況をレポートします — 管理者/オーナーの役割が必要です。管理者はウェブの組織ページから完全なExcelレポートをダウンロードすることもできます。

プロジェクト（支出タグ付け）

プロジェクトは、支出を名前付きのワークストリームに属性付けして監視します。エージェントはタスク開始時にアクティブなプロジェクトを確認し（wonda useがそれを表示）、オペレーターがプロジェクトごとに支出を監視する場合にタスクごとにプロジェクトを設定する必要があります：

• wonda use --project <name> — スティッキー：以降のすべての課金にプロジェクトが付与されます（wonda usage、API、組織Excelレポートで）。wonda use --no-projectでタグ付けを停止します。組織/個人コンテキストの切り替えはプロジェクトを自動的にクリアします（プロジェクトはスコープごとです）。
• 任意のコマンドに--project <name> — その呼び出しの一時的なオーバーライド。
• wonda project list|create|delete — アクティブスコープ内のレジストリを管理します。組織プロジェクトは組織の管理者/オーナーのみが作成できます。個人プロジェクトはセルフサービスです。存在しない名前に対するタグ付けはunknown_projectで失敗します（サイレントな新しいバケットは作成されないため、タイプミスが監視データを分割することはありません）。

wonda topupは、コンテキストに関係なく、常に個人のウォレットにチャージします。組織ウォレットへのチャージ（および自動チャージの設定）は管理者専用であり、ウェブの/organizations/<slug>で行われます。メンバーが組織クレジットを使い果たした場合、エラーは管理者に依頼するか個人に戻すよう指示します — メンバーはCLIから組織ウォレットにチャージできません。

組織内の役割はシートプランとは別です：

• オーナー: 元の作成者。降格や追放はできません。組織ページから別のメンバーに所有権を移譲できます（稀）。
• 管理者: 招待（単一または一括貼り付け）、追放、役割変更、シート変更、チャージ、自動チャージ設定、月間制限変更ができます。
• ユーザー: 組織ウォレット内でのみ支出できます（管理者が設定した場合、メンバーごとの月間制限の対象となります）。

有料組織シート（WONDA / WONDA_PREMIUM）は、組織コンテキスト内でのみ、個人の有料プランと同じ有料機能（スキルなど）へのアクセスを提供します。wonda use --personalはユーザーの個人アカウントプランにフォールバックします。

アクセスティア

Wondaは有料専用です：API呼び出し、ローカルプラットフォーム読み取り、ブラウザ自動化、メディア合成、ファイル編集、診断、生成、公開、スクレイピング、分析、スキル、リレー運用、クラウドツインを含むすべてのプロダクトサーフェスには有料プランが必要です。プロダクトコマンドが作業を行う前に、CLIはWondaに対してライブのエンタイトルメントチェックを実行します。アクセスが確認できない場合、チェックはクローズドで失敗します。新しいアカウントはサブスクライブするまでプロダクトアクセスがなく、プラスチックのクレジット残高はプランの代わりにはなりません。

ティア	アクセス
匿名（ログインなし）	プロダクトアクセスなし。認証、設定、価格、組織の検出/選択、シェル補完、ローカルシャットダウンコマンドは、ユーザーがサブスクライブ、復旧、またはバックグラウンドサービスの停止ができるように利用可能なままです。wonda auth loginを実行し、サブスクライブしてください。
無料（ログイン済み、有料プランなし）	プロダクトアクセスなし。https://wonda.sh/account でサブスクライブしてプロダクトを使用してください。
WONDA（$19.99/月、「Pro」）	クラウドツイン以外のすべて：生成（image/generate、video/generate、...）、メディアアップロード/ダウンロード、公開、スクレイピング、分析、動画分析、スキル（wonda skill install/list/get）、トランジション、クリッピング、メール、Reddit/LinkedInアカウント作成、スタイル、ブランド。
WONDA_PREMIUM（$49.99/月、「Premium」）	WONDAのすべてに加え、クラウドツイン（wonda twin：プロビジョニング、スケジュール実行、ストリームログイン）とアンチディテクト/シャドウバン保護、上限なし、米国アカウント作成。
フラグ付き（アカウントごとのPostHogキルスイッチ）	有料プランに含まれますが、アカウントごとのフラグでゲート可能：wonda reddit signup（redditAccountCreationEnabled）、wonda email（emailServerApiEnabled）、公開LinkedInプロファイルエンリッチメント（linkedinProfileEnrichmentEnabled）。

コマンドが403（paid_plan_required）を返した場合は、https://wonda.sh/account でサブスクライブしてください。

これはローカルのstdio MCPパスにも適用されます。なぜならMCPは同じCLIを実行するからです。プラットフォームのCookieとデータはデバイス上に残りますが、コマンドは最初にGET /api/v1/auth/accessから正常な有料アクセス判定を受け取る必要があります。リレーのみのインストールでは、そのエンタイトルメントプローブにスコープ付きのwrelay_...資格情報を使用できます。スコープ付き資格情報は通常のアカウントAPIを呼び出すことはできません。

音声クローン

10秒以上のオーディオクリップから音声をクローンし、TTSで使用します。ハードリミット：アカウントあたり20個のクローン音声。費用：クローン1つあたり$1.50。

# ローカルファイルからクローン（最初に自動的にメディアライブラリにアップロード）
wonda voice create "Andu" --file ./sample.mp3 --description "私の声"

# 既存のWondaメディアからクローン
wonda voice create "ブランド" --media-id <uuid>

# ソースオーディオの前処理（オプション）
wonda voice create "クリーン" --file ./raw.wav --noise-reduction --normalize-volume

# クローン音声の一覧表示（各行はisExpiredとexpiresInDaysを報告）
wonda voice list

# 1つの音声
wonda voice get <voice-id>

# 名前の変更 / 説明の再設定（ローカルのみ、プロバイダー呼び出しなし）
wonda voice update <voice-id> --name "新しい名前" --description "..."

# 削除
wonda voice delete <voice-id>

クローン音声をTTSで使用するには、voice getからのproviderVoiceIdをvoiceIdとして/audio/speechに渡します：

wonda audio speech "こんにちは世界" \
  --model minimax-speech-2-8-hd \
  --params '{"voiceId":"<providerVoiceId>"}'

7日間の有効期限：TTSで7日間使用されていないクローン音声は自動的に期限切れになります。クローン音声でTTSを実行すると、その有効期限が自動的にリフレッシュされます。アイドル状態で期限切れになった音声は、再クローンする必要があります（再度$1.50かかります）。

資格情報保管庫

外部プラットフォーム（Instagram、TikTok、Twitterなど）で作成したログイン情報を永続化し、次回の実行で再利用できるようにします。パスワードはサーバーサイドキーでAES-256-GCM暗号化され、get時のみ復号化されます。

# 作成
wonda credentials create --website instagram.com --username 私のハンドル \
  --email [email protected] --password-stdin <<< "hunter2" \
  --metadata '{"signup_source":"wonda-email"}'

# 一覧表示（パスワードは省略）
wonda credentials list --website instagram.com

# 復号化されたパスワードを含む完全なレコードを取得
wonda credentials get <id>

# 任意のフィールドを更新（パスワードローテーションには--password-stdinを使用、--username ""でクリア）
wonda credentials update <id> --username 新しいハンドル

# 削除
wonda credentials delete <id>

# 1回の呼び出しで取得＋使用理由を記録 — GETではなくPOST。理由を明確にできる場合は、`get`よりもこちらを推奨。
wonda credentials use <id> --reason "instagramサインアップフロー"

# 監査用に最近のイベント（作成/使用/ローテーション/更新）を表示
wonda credentials events <id>

フィールド：website（必須 — instaのようなタイプ入力はinstagram.comに正規化されます）、username、email、password（必須）、metadata（任意のJSON）。username/emailの少なくとも1つが存在する必要があります。(website, username)ごとに複数のレコードが許可されます — 必要に応じて各自で重複排除してください。

イベントログ：すべてのcredentials get/use、create、パスワードローテーション、その他の更新は、資格情報のイベントとして記録されます（アクター：cli | web | system）。監査にはcredentials events <id>またはWeb UIの履歴アイコンを使用してください。イベントログは追記専用であり、資格情報の削除時にカスケード削除されます。

グローバル出力フラグ

すべてのコマンドは以下の出力制御フラグをサポートしています：

• --json — JSON出力を強制（stdoutがパイプされている場合は自動的に有効）
• --quiet — プライマリ識別子（ジョブID、メディアIDなど）のみを出力 — スクリプトに最適
• -o <path> — 出力をファイルにダウンロード（--waitを暗黙的に含む）
• --fields status,outputs — 特定のJSONフィールドを選択
• --jq '.outputs[0].media.url' — jq式でJSON出力をフィルタリング

CLIお知らせと非推奨警告

コマンド実行のたびに、CLIはGET /api/v1/updatesをポーリングし（匿名、~/.wonda/state.jsonに1時間キャッシュ）、アクティブなお知らせ（非推奨通知、インシデント注意喚起、アップグレードプロンプトなど）を取得します。メッセージはstderrにのみ出力されるため、stdout/JSONはパイプ用にクリーンなままです。

リクエストごとの非推奨ヒントは、標準のWarning: 299 - "<message>" HTTPヘッダーとして到着し、CLIのHTTPクライアントによって[deprecated METHOD /path] <message>としてstderrに表示されます。

両方のチャンネルをWONDA_QUIET=1（環境変数）または--quiet（フラグ）で抑制します。ネットワークチェックのみを無効にするにはWONDA_NO_UPDATE_CHECK=1を使用します。

WAB / Wonda Automation Browser（wonda wab）

1PasswordはローカルWABプロファイルに含まれています。 WABは公式の安定版1Passwordブラウザ拡張機能をダウンロードし、そのパブリッシャー署名を検証し、初回セットアップ時にツールバーにピン留めします。wonda wab show <persona>でWABを開き、1Passwordをクリックしてサインインします。各ペルソナは独自の1Passwordセッションを保持します。デスクトップアプリがWABを追加のブラウザとして承認するよう要求する場合がありますが、拡張機能で直接サインインしても機能します。キャッシュされた拡張機能ファイルはオフラインでも動作します。WABはキャッシュされた拡張機能の更新を、ペルソナが起動するときに1日最大1回チェックします（失敗したチェックも含む）。Chromiumのバージョンを変更すると、別の互換性チェックがトリガーされます。拡張機能が正常にインストールされたことがない場合、起動のたびにインストールを再試行します。すでに実行中のブラウザは、次回の起動時に拡張機能の更新を取得します。起動時とwab installは、7日以上経過した未使用のキャッシュバージョンを削除します。稼働中のWABプロセスが使用するバージョンは保持されます。WABを起動する前にWAB_ONEPASSWORD=0を設定すると、バンドルされた拡張機能をスキップします。匿名キャプチャ、スクラッチセッション、クラウドツインはそれを読み込みません。カンマを含むWondaデータパスも、ドライバー警告とともに1Passwordをスキップします。