agent-media CLI
Turn Claude Code into a UGC video studio.
Connect agent-media to Claude Code, Cursor, Windsurf and any MCP client — generate UGC video ads, B-roll, and AI actors right from your conversations. Auth, uploads, and polling are handled for you.
3 install methods
Pick your stack. We support all three.
Claude Code, Cursor, Windsurf
Drop one JSON block into your client and 6 tools become available — including create_video, show_your_app, laptop_ugc.
$ npx @agentmedia/mcp-server
30 commands. One install.
Generate from a shell script, CI/CD, or your terminal. Sync or async modes, JSON output, profile switching, doctor diagnostics.
$ npm install -g agent-media-cli
TypeScript or Python
Typed clients with polling helpers for show-your-app, laptop-ugc, and product-acting flows. Works in Node, Bun, Deno, FastAPI, and async agent loops.
$ npm i @agentmedia/sdk $ pip install agent-media
60-second quickstart
From zero to your first UGC ad.
Install
One line — auth, uploads, and polling are handled for you.
$ npm install -g agent-media-cli
Sign in
Opens a browser, takes 5 seconds. Run agent-media login and you’re authenticated.
$ agent-media login
Generate
Pick an actor, write a script, run with --sync. We hand back the finished MP4 URL.
$ agent-media ugc "Try this AI tool…" --actor sofia --sync
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 Generators (UGC)
ugc, show-your-app, product-acting, laptop-ugc, saas-review
agent-media Job ops
list, status, inspect, cancel, delete, download
agent-media Actor library
actor list, actor preview, actor variants
agent-media Subtitles
subtitle <video> --style hormozi
agent-media Account
login, logout, whoami, plan, credits, subscribe, usage, apikey
agent-media Config + utils
config, profile, alias, persona, doctor, debug, completions, 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.