Wonda CLI

What does this agent do, and when should you use it?

Wonda is a proprietary command-line tool that brings AI content generation to the terminal, covering images, video, music, speech, and direct social publishing. Every command outputs JSON to stdout, making it trivially consumable by shell scripts and AI coding agents such as Claude Code and Codex; it also ships skill files and native plugins so agents learn every command and workflow automatically. Generation jobs run in the wonda.sh cloud on a credit basis, while publishing connects directly to TikTok, Instagram, X, Reddit, and LinkedIn. Editing targets TikTok/Reels-style short-form video with more than 20 operations including animatedCaptions, splitScreen, lipsync, background removal, and upscaling. Installation is available via npm, Homebrew, and native agent plugins.

Wonda organizes capabilities into subcommands: generate image|video|text|music creates content from text prompts or reference images (example models include nano-banana-2, sora2, and suno-music); audio speech|transcribe|dialogue handles speech; edit video --operation ... offers editing ops such as animatedCaptions, textOverlay, merge, splitScreen, trim, speed, skipSilence, birefnet-bg-removal, topaz-video-upscale, and sync-lipsync-v2-pro; analyze video produces a composite frame grid plus an audio transcript for video understanding; publish instagram|tiktok (with carousel variants) posts directly; the linkedin, x, and reddit command families cover search, browsing, posting, likes, and messaging; scrape social|ads pulls competitor profiles and Meta Ads Library data; and blueprint manages reusable workflows. All output is JSON with built-in --jq field selection; --quiet returns only job IDs for piping, and JSON mode engages automatically when stdout is piped.

1. An indie e-commerce seller asks Claude Code to turn one product photo into a sora2 product video, add music and animated captions, then publish it to TikTok in one pipeline.
2. A social media manager batch-produces Reels-style clips: merging segments, burning animated captions, removing silence, and adjusting speed.
3. A marketing team uses scrape ads to search the Meta Ads Library for competitor ad creatives.
4. A personal brand operator manages LinkedIn and X posting, replies, likes, and DMs directly from the CLI.
5. A podcast/short-form creator uses transcribe, enhanceAudio, and voiceExtractor to clean up and extract audio tracks.

How do you install or deploy this agent?

Install via npm or Homebrew:

bash

npm i -g @degausai/wonda

or:

bash

brew tap degausai/tap && brew install wonda

Then authenticate and install the agent skill file (a wonda.sh account is required):

bash

wonda auth login

wonda skill install -o .

Plugin installs for AI agents:

bash

npx skills add degausai/wonda

Claude Code:

bash

/plugin marketplace add degausai/wonda
/plugin install wonda@degausai

Gemini CLI:

bash

gemini extensions install https://github.com/degausai/wonda

How do you use this agent?

Authenticate and top up first (account at wonda.sh; generation costs credits):

bash

wonda auth login
wonda topup
wonda balance

Generate an image:

bash

wonda generate image \
--model nano-banana-2 \
--prompt "Product photo of headphones on marble" \
--wait -o photo.png

Generate a video from a reference image:

bash

MEDIA=$(wonda media upload ./product.jpg --quiet)
wonda generate video --model sora2 \
--prompt "Slow orbit, dramatic lighting" \
--attach "$MEDIA" --duration 8 --wait -o video.mp4

Add TikTok-style animated captions:

bash

wonda edit video --operation animatedCaptions --media "$VID_MEDIA" \
--params '{"fontFamily":"TikTok Sans","position":"bottom-center","highlightColor":"#FFD700"}' \
--wait -o captioned.mp4

Publish to Instagram:

bash

wonda publish instagram \
--media med_abc123 \
--account ig_acct_456 \
--caption "New drop. Link in bio."

Extract fields with built-in jq:

bash

wonda generate image --model nano-banana-2 --prompt "A cat" --wait \
--jq '.outputs[0].media.url'

What are this agent's strengths and limitations?

How does this agent compare with similar options?

Key facts side by side with the most closely related agents.

How does FollowAgents rate this agent?

FAQ