CLI
UGC video ads from your terminal.
Last updated: May 2026
npm install -g agent-media-cli and you're shipping. 30 commands cover UGC video, ShowYourApp, ProductActing, LaptopUgc, dubbing, subtitle generation, and account management. Works on macOS, Linux, and Windows.
60-second quickstart
# 1 — install
$ npm install -g agent-media-cli
# 2 — log in (opens browser)
$ agent-media login
# 3 — generate your first UGC ad
$ agent-media ugc \
--actor sofia \
--script "Try this AI tool that builds your UGC ads in seconds" \
--duration 10 \
--sync
# → outputs MP4 URL when done
30 commands
Every generator exposed as a CLI command, plus account, profile, alias, debug, and doctor utilities. Tab-completion via agent-media completions.
agent-media generate (UGC)
ugc, show-your-app, product-acting, laptop-ugc
agent-media video
inspect, download, subtitle, review
agent-media actor
list, get (via actor command group)
agent-media jobs
list, status, cancel, delete
agent-media account
login, logout, whoami, plan, credits, subscribe, usage, apikey
agent-media config + utils
config, profile, alias, doctor, debug, completions, persona, update, version
Built for pipelines
Sync or async flag
--sync polls until done and prints the video URL. Default returns the job ID for async workflows.
JSON output mode
--json on every command. Pipe to jq, save to file, post to your service.
Webhook delivery
--webhook-url posts a completion event to your HTTPS endpoint when the video is ready.
Profile switching
agent-media profile lets you keep multiple API keys and environments side by side.
Doctor command
agent-media doctor diagnoses common setup issues — auth, env vars, network, and version.
Tab completion
agent-media completions emits bash/zsh/fish completion scripts for your shell.
Frequently Asked Questions
Is there a CLI for AI UGC video generation?
Yes. agent-media ships agent-media-cli on npm — 30 commands covering UGC video, ShowYourApp, ProductActing, LaptopUgc, dubbing, and account management. None of the major UGC video competitors (MakeUGC, Arcads, Creatify) ship a CLI today.
Does the CLI work on Windows?
Yes. The CLI is pure Node.js and runs on macOS, Linux, and Windows (PowerShell + cmd + Git Bash). Auth flow uses your default browser regardless of platform.
Can I use the CLI in CI/CD?
Yes. Set AGENT_MEDIA_API_KEY as a secret env var. CLI auto-detects it and skips the interactive login flow. Use --json output mode for parseable results.
Is the CLI open source?
Yes. Apache-2.0. Source on GitHub. PRs welcome.
How much does the CLI cost?
The CLI itself is free. Generating videos through it consumes credits on your agent-media plan, identical to API usage. Plans start at $39/month (Creator) with the CLI included.
Can I batch-generate ads from a CSV?
Yes. Pipe a CSV through xargs or write a short shell loop. Use --json to capture job IDs and jobs status to track each one.