
degausai / wonda
★ 133A skill package that teaches your agent 1 capability — every one documented and browsable below, no GitHub required · by degausai.
Each skill below is one capability this package teaches your agent. Install the whole package, or open a skill to install just that one.
AI-powered content generation from your terminal
Images, video, music, audio, editing, and social publishing — all via CLI.
You don't need to learn this CLI. Your agent already knows how to use it.
and any agent that can run shell commands.
<br /> <img src="assets/terminal.gif" alt="wonda in action" width="560" /> </div>Install
npm i -g @degausai/wondabrew tap degausai/tap && brew install wondaGet started
wonda auth login # Authenticate (opens browser)
wonda skill install -o . # Install skill file for your AI assistantThen ask your agent: "Use wonda to generate a product video of this image."
Agent plugin
Wonda ships as a native plugin for AI coding agents. Install it once and your agent learns every command, model, and workflow automatically.
| Agent | Install |
|---|---|
| Any agent | npx skills add degausai/wonda |
| Claude Code | /plugin marketplace add degausai/wonda then /plugin install wonda@degausai |
| Gemini CLI | gemini extensions install https://github.com/degausai/wonda |
| Project-local | wonda skill install -o . |
Made with wonda
<p align="center"> <img src="assets/example-1.webp" alt="Product content" width="140" /> <img src="assets/example-3.webp" alt="AI-generated content" width="140" /> <img src="assets/example-5.webp" alt="Ad creative" width="140" /> <img src="assets/example-4.webp" alt="Product ad" width="140" /> </p> <p align="center"><em>Product videos, UGC-style content, ad creatives — generated, edited, and published from the terminal.</em></p>Pricing
An account is required. Sign up at wonda.sh.
Generations cost credits. Top up anytime:
wonda topup # Add credits
wonda balance # Check remaining creditsUse wonda pricing estimate to check costs before generating.
Commands
Generation
| Command | Description |
|---|---|
generate image | Generate an image from a text prompt |
generate video | Generate a video from a text prompt or reference image |
generate text | Generate text content |
generate music | Generate a music track from a text prompt |
audio speech | Text-to-speech |
audio transcribe | Speech-to-text |
audio dialogue | Multi-speaker dialogue generation |
Editing
TikTok/Reels-style video editing operations — designed for short-form social content.
| Operation | What it does |
|---|---|
animatedCaptions | Auto-transcribe and burn animated word-by-word captions |
textOverlay | Add styled text with custom fonts, positions, and sizing |
editAudio | Mix background music with video audio (volume control) |
merge | Stitch multiple clips into one video |
overlay | Picture-in-picture — layer one video over another |
splitScreen | Side-by-side or top-bottom split of two videos |
trim | Cut to a specific time range |
speed | Speed up or slow down |
splitScenes | Auto-detect and split scenes (or omit a scene) |
extractAudio | Pull the audio track from a video |
extractFrame | Extract a single frame at a specific timestamp |
reverseVideo | Play backwards |
skipSilence | Remove silent gaps |
motionDesign | Motion design and animation |
enhanceAudio | Enhance audio quality |
voiceExtractor | Isolate vocals from audio |
audioTrim | Trim audio files |
imageToVideo | Convert images to video |
imageCrop | Crop to a target aspect ratio |
birefnet-bg-removal | Remove image background |
bria-video-background-removal | Remove video background |
topaz-video-upscale | Upscale video resolution (1-4x) |
sync-lipsync-v2-pro | Sync lip movements to audio |
Analysis
| Command | Description |
|---|---|
analyze video | Extract composite frame grid + audio transcript for video understanding |
Publishing
| Command | Description |
|---|---|
publish instagram | Publish a single post |
publish tiktok | Publish a single post |
publish instagram-carousel | Publish a carousel (2-10 images) |
publish tiktok-carousel | Publish a photo carousel (2-35 images) |
publish history | View publish history |
Supports search, profiles, companies, messaging, and engagement.
| Command | Description |
|---|---|
linkedin auth set | Store LinkedIn session credentials (see wonda linkedin auth --help) |
linkedin auth check | Verify stored session validity |
linkedin me | Your LinkedIn identity |
linkedin search | Search people, companies, or all (--type PEOPLE|COMPANIES|ALL) |
linkedin profile | View a profile by vanity name or URL (includes follower count) |
linkedin posts | Recent posts with engagement stats (--comments to include top comments) |
linkedin comments | Get comments on a specific post |
linkedin company | View a company page |
linkedin conversations | List message threads |
linkedin messages | Read messages in a thread |
linkedin notifications | Recent notifications |
linkedin connections | Your connections |
linkedin like | Like a post |
linkedin unlike | Remove a like |
linkedin send-message | Send a message in a conversation |
linkedin post | Create a LinkedIn post (--visibility ANYONE|CONNECTIONS_ONLY) |
linkedin delete-post | Delete a post |
X/Twitter
Supports search, timelines, tweets, and social graph.
| Command | Description |
|---|---|
x auth set | Store X session credentials (see wonda x auth --help) |
x auth check | Verify stored session validity |
x search | Search tweets |
x user | User profile |
x user-tweets | User's recent tweets |
x read | Read a single tweet |
x replies | Replies to a tweet |
x thread | Full thread (author's self-replies) |
x home | Home timeline (--following for Following tab) |
x bookmarks | Your bookmarks |
x likes | Your liked tweets |
x following | Who a user follows |
x followers | A user's followers |
x lists | User's lists (--member-of for memberships) |
x list-timeline | Tweets from a list |
x news | Trending topics (--tab trending|for_you|news|sports|entertainment) |
x tweet | Post a tweet |
x reply | Reply to a tweet |
x like | Like a tweet |
x unlike | Unlike a tweet |
x retweet | Retweet |
x unretweet | Unretweet |
x follow | Follow a user |
x unfollow | Unfollow a user |
| Command | Description |
|---|---|
reddit submit | Submit a self or link post to a subreddit |
reddit comment | Reply to a post or comment |
reddit vote | Upvote or downvote |
reddit subscribe | Subscribe to a subreddit |
reddit save | Save a post |
reddit delete | Delete your post |
reddit chat inbox | List DM conversations |
reddit chat messages | Fetch messages from a conversation |
reddit chat send | Send a DM |
reddit chat accept-all | Accept pending chat requests |
Marketing & Analytics
| Command | Description |
|---|---|
scrape social | Scrape Instagram/TikTok/Reddit profiles (posts, engagement, bio) |
scrape ads | Search the Meta Ads Library for competitor ads |
analytics instagram|tiktok | Performance metrics for connected accounts |
brand | View brand identity, products, website data |
Media & Workflows
| Command | Description |
|---|---|
media upload|download|list | Media library management |
blueprint list|create|run | Blueprint workflow management |
skill list|get|install | AI agent skill files and content guides |
models list|info | Available models and their parameters |
pricing list|estimate | Pricing info and cost estimates |
Examples
Generate an image
wonda generate image \
--model nano-banana-2 \
--prompt "Product photo of headphones on marble" \
--wait -o photo.pngGenerate a video from a reference image
MEDIA=$(wonda media upload ./product.jpg --quiet)
wonda generate video --model sora2 \
--prompt "Slow orbit, dramatic lighting" \
--attach "$MEDIA" --duration 8 --wait -o video.mp4Add animated captions (TikTok-style)
wonda edit video --operation animatedCaptions --media "$VID_MEDIA" \
--params '{"fontFamily":"TikTok Sans","position":"bottom-center","highlightColor":"#FFD700"}' \
--wait -o captioned.mp4Full pipeline: generate → music → captions → publish
# Generate a product video
VID=$(wonda generate video --model sora2 --prompt "Ocean waves" --wait --quiet)
VID_MEDIA=$(wonda jobs get inference "$VID" --jq '.outputs[0].media.mediaId')
# Add background music
MUSIC=$(wonda generate music --model suno-music --prompt "lo-fi ambient" --wait --quiet)
MUSIC_MEDIA=$(wonda jobs get inference "$MUSIC" --jq '.outputs[0].media.mediaId')
MIXED=$(wonda edit video --operation editAudio --media "$VID_MEDIA" --audio-media "$MUSIC_MEDIA" \
--params '{"videoVolume":80,"audioVolume":30}' --wait --quiet)
MIXED_MEDIA=$(wonda jobs get editor "$MIXED" --jq '.outputs[0].mediaId')
# Burn in animated captions
FINAL=$(wonda edit video --operation animatedCaptions --media "$MIXED_MEDIA" \
--params '{"fontFamily":"Montserrat","position":"bottom-center"}' --wait --quiet)
FINAL_MEDIA=$(wonda jobs get editor "$FINAL" --jq '.outputs[0].mediaId')
# Publish
wonda publish tiktok --media "$FINAL_MEDIA" --account tiktok_acct_123 \
--caption "Summer vibes" --privacy-level PUBLIC_TO_EVERYONEPublish to Instagram
wonda publish instagram \
--media med_abc123 \
--account ig_acct_456 \
--caption "New drop. Link in bio."Output formats
All commands output JSON to stdout. Errors go to stderr.
# Default — formatted JSON
wonda generate image --model nano-banana-2 --prompt "A cat"
# Quiet — just the ID, useful for shell variables
JOB=$(wonda generate image --model nano-banana-2 --prompt "A cat" --quiet)
# Field selection
wonda jobs get inference "$JOB" --fields status,outputs
# Built-in jq (no external dependency)
wonda generate image --model nano-banana-2 --prompt "A cat" --wait \
--jq '.outputs[0].media.url'When stdout is piped, JSON mode is enabled automatically.
AI agent integration
Just point your agent at wonda — it reads --help, finds the built-in skill file, and figures out model selection, prompt strategies, and content workflows on its own.
wonda skill install # Sync skill file to ~/.wonda/skill/
wonda skill install --all -o . # Install main + all content skills locally
wonda skill list # Browse available content skills
wonda skill get product-b-roll # Fetch a specific content guideThe skill file auto-syncs in the background. No configuration needed — your agent discovers it automatically.
Platforms
macOS · Linux · Windows — x64 + ARM64
License
Proprietary — see wonda.sh for terms.
Install the whole package (1 skills):
npx skills add https://github.com/degausai/wondaOr install a single skill:
npx skills add https://github.com/degausai/wonda --skill <name>Pick the skill name from the Skills tab — each entry there installs independently.