AI Video CLI: Generate UGC Videos from Your Terminal | agent-media

Developer

Nobody else ships a CLI for AI video generation. agent-media gives you npm install -g agent-media-cli, and you can generate UGC videos without ever opening a browser. Write scripts in your editor, batch-generate across actors, pipe output into your CI/CD pipeline. See pricing.

Install and Authenticate

The CLI is a single npm package. Install it globally and log in with your agent-media account. Authentication opens your browser once, then stores the token locally.

$ npm install -g agent-media-cli

$ agent-media login

Logged in as you@example.com

Generate Your First Video

One command. Script, actor, duration, style. The --sync flag waits for the video to finish and downloads the MP4 to your current directory.

$ agent-media ugc "This changed everything for me. I used to spend hours on content." \

--actor sofia \

--duration 10 \

--style tiktok \

--tone energetic \

--sync

Generating... done (2m 14s)

Saved:./sofia-tiktok-10s.mp4

Browse Actors and Variants

List all 200 actors from the terminal. Each actor has multiple variants with different outfits and backgrounds. Use agent-media actor list to browse and agent-media actor variants to see a specific actor's looks.

$ agent-media actor list

sofia female 10 variants

marco male 10 variants

emma female 10 variants

... (200 actors)

$ agent-media actor variants sofia

variant-1 crop top, apartment background

variant-2 tank top, kitchen background

variant-3 fitted tee, office background

... (10 variants)

Batch Generation via Shell Scripting

Because it runs in the terminal, you can wrap agent-media in a shell loop. Generate the same script across 5 actors in one shot. Or loop over a file of scripts and actors.

#!/bin/bash
SCRIPT="Stop scrolling. This product changed my morning routine."
ACTORS=("sofia" "marco" "emma" "naomi" "james")

for ACTOR in "\${ACTORS[@]}"; do
  echo "Generating for $ACTOR..."
  agent-media ugc "$SCRIPT" \\
    --actor "$ACTOR" \\
    --duration 10 \\
    --style tiktok \\
    --sync
done

echo "All videos generated."

Five videos, five different faces, same script. Upload them all to your ad platform and test which actor drives the best click-through rate. Total cost: $15 (1,500 credits).

CI/CD Integration

Run agent-media in GitHub Actions, GitLab CI, or any pipeline that supports Node.js. Set your API key as a secret, install the CLI, and generate videos on every push or on a schedule.

name: Generate UGC Videos
on:
  schedule:
    - cron: '0 9 * * 1'  # Every Monday at 9am

jobs:
  generate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-node@v4
        with:
          node-version: 20

      - run: npm install -g agent-media-cli

      - run: agent-media login --token \${{ secrets.AGENT_MEDIA_KEY }}

      - run: |
          agent-media ugc "New week, new routine." \\
            --actor sofia --duration 10 --style tiktok --sync

      - uses: actions/upload-artifact@v4
        with:
          name: ugc-videos
          path: "*.mp4"

Claude Code Skill Integration

agent-media works as a Claude Code skill. Your AI coding assistant can generate videos directly from the conversation. Write a prompt describing the video you want, and Claude calls the CLI under the hood.

Generate a 10-second UGC video with Sofia reviewing a fitness app. Use the tiktok subtitle style.

Running: agent-media ugc "I found this fitness app..." --actor sofia --style tiktok --duration 10 --sync

Video saved:./sofia-tiktok-10s.mp4

This is useful when you want an AI assistant to handle the creative copy and video generation in one step. No context-switching between tools.

CLI Commands Reference

Why the agent-media CLI

Last updated: April 2026