Cliptude CLI for AI Agents: Make Videos from the Terminal | Cliptude
Black Friday: Cliptude Unlimited LIFETIME DEAL is 70% off — $299.70 instead of $999. Use code BLACKFRIDAY at checkout.Get 70% off →
Cliptude
Sign In Get Started
AI Agents CLI

Make videos from any AI agent with the Cliptude CLI

Some agents run shell commands but cannot add an MCP server, and some jobs run in CI with no browser. The Cliptude CLI covers both: the same templates, jobs, agent-planned videos and editor as the MCP server, as plain commands. Add the Cliptude skill and the agent knows when to write a script, when to plan every shot, and how to render.

Set up the CLI

  1. Install the CLI (Node.js required):
    npm i -g @cliptude/cli
  2. Sign in once in the browser it opens:
    cliptude auth login
  3. Install the companion skills, so your agent knows the workflow:
    npx skills add cliptude/cliptude
  4. Check it works by listing your templates:
    cliptude templates

No browser, for CI or a server: set a clp_ key from /developers/ instead of signing in.

export CLIPTUDE_API_KEY='clp_…'
cliptude templates

Why make videos with Cliptude CLI and Cliptude?

Up to an hour long

Finished 16:9 YouTube videos from 6 to 60 minutes, rendered as one MP4.

Real footage and graphics

Cliptude sources footage and archive pictures and builds animated maps, charts, captions and music around the narration.

The price before the build

estimate_credits quotes a job and checks your balance without creating or charging anything.

Batch a folder of scripts from the terminal

  1. Put one narration per file in ./queue and check the template with cliptude templates. Give it a thumbnail style once (template-create --thumbnail-reference or --thumbnail-prompt), or pass one per video, because a video without one is refused.
  2. Price the batch: for f in queue/*.txt; do cliptude estimate --template "Weekly doc" --script-file "$f"; done. Each result has credits_required, credits_available and enough_credits; nothing is created.
  3. Start each video with cliptude generate --template "Weekly doc" --title "…" --script-file "$f". Outside a terminal it prints the job review (settings, warnings, credits) and stops; after you approve, rerun with --review-token and any --acknowledge items.
  4. Write the job ids to a file and follow them with cliptude status <job-id>, or cliptude jobs --status running for the whole batch.
  5. For each finished video, cliptude editor <job-id> prints the timeline; fix a shot with cliptude agent <project-id> --prompt "…" --items <id> --wait and export with cliptude render <project-id> --wait.
  6. In CI, set CLIPTUDE_API_KEY to a clp_ key from /developers/ instead of cliptude auth login; on your own machine, cliptude use desktop sends the jobs to the running Cliptude desktop app.

Source: Cliptude CLI + MCP README (GitHub)

Installing the Cliptude skills for the CLI, agent by agent

The CLI gives an agent the commands; the three skills tell it the order. cliptude-script writes the narration, cliptude runs a saved template (estimate, generate, status, continue) and cliptude-plan walks plan-job, catalog, plan-check, plan-lock and continue. They live in mcp_server/skills/ in the public cliptude/cliptude repo.

npx skills add cliptude/cliptude copies them into the folder your agent reads. Pass -a with the agent id to pick the agent, and -g to install for every project. The skills CLI needs Node.js 22.20 or later, newer than the Node 18 the Cliptude CLI itself needs.

Where they land: Claude Code reads .claude/skills/ (global ~/.claude/skills/), OpenClaw skills/ (global ~/.openclaw/skills/), Hermes Agent .hermes/skills/, Goose .goose/skills/, and Codex, Cursor, Gemini CLI, Cline and OpenCode .agents/skills/ in the project.

One agent, current project:
npx skills add cliptude/cliptude -a claude-code
Every project, for OpenClaw or Hermes Agent:
npx skills add cliptude/cliptude -a openclaw -g
npx skills add cliptude/cliptude -a hermes-agent -g

Source: vercel-labs/skills: supported agents and paths

Cliptude CLI or Cliptude MCP server

Both reach the same account, templates and credits and cost the same per video. Choose the CLI when the agent works in a terminal, when the inputs are files on disk, or when a loop or a CI job should make videos without a chat open. Choose the remote MCP server for Claude, ChatGPT and other chat apps, where there is nothing to install.

Cliptude CLICliptude MCP server (remote)
Installnpm i -g @cliptude/cli (Node.js 18+; it sets up its own Python 3.10+ environment)Nothing; paste https://mcp.cliptude.com/mcp
Sign-incliptude auth login in a browser, or CLIPTUDE_API_KEY with a clp_ keyOAuth with Google, or a Bearer clp_ key
Your filesReads local narration, talking-head and media files directly (--voiceover, --talking-head, upload-media)Uploads through signed URLs: start_voiceover_upload, start_media_upload
Job reviewAsks y/N in a terminal; in a script it prints the review and stops until you pass --review-tokenReturns the review to the agent, which shows it to you and resends with review_token
Where it fitsAgents that only run shell commands, CI, batch loops, the Cliptude desktop appChat apps and agents that add MCP servers

Source: Cliptude CLI + MCP README (GitHub)

What the Cliptude CLI costs to run

The CLI is free and MIT-licensed, published on npm as @cliptude/cli. It runs on Node.js 18 or later and creates a Python 3.10+ environment in ~/.cliptude/venv on first use.

Videos are billed in Cliptude credits at the same rate as the website: 22 credits a minute for a faceless documentary with your own voiceover and 40 with an ElevenLabs voice, on plans from $19. cliptude estimate shows the exact figure and your balance before anything is created. The agent driving the CLI (Claude Code, Codex and so on) is billed separately by its vendor.

Source: npm: @cliptude/cli

What can you ask your agent to do?

"Install the Cliptude CLI, estimate the credits for scripts/episode-9.md with my Documentary template, and start it if it is under 1,500 credits."

"Upload ./narration.mp3 as the voiceover and build the video with my Finance template."

"For every script in ./queue, run cliptude generate one at a time and write the job ids to jobs.json."

The CLI reads local files directly, so it is the easiest way for an agent to send your own voiceover or talking-head recording. Uploaded narration has to be at least 6 minutes long.

Use the CLI where an agent can run commands but cannot add an MCP server, or where you want a script in CI. Where the agent supports MCP, the remote server at https://mcp.cliptude.com/mcp needs no install.

Which videos can your agent make?

Each format is 16:9 and made from a template you save once. On agent-planned formats the agent chooses every shot and graphic itself.

Cliptude CLI commands

  • cliptude templates: your saved templates
  • cliptude estimate --template "…" --script-file script.txt: the credits a video needs, without creating anything
  • cliptude generate --template "…" --title "…" --script-file script.txt: start a video from your narration
  • cliptude generate --template "…" --title "…" --voiceover narration.mp3: build the video around your own recording
  • cliptude status <job-id>: job status and the finished video link
  • cliptude plan-job, plan-check, plan-lock, continue: agent-planned videos: the agent plans every shot
  • cliptude editor <job-id>: open the finished video's timeline
  • cliptude agent <project-id> --prompt "…" --wait: ask the Cliptude Agent for an edit
  • cliptude render <project-id> --wait: render the edited video

The full list is in the API docs.

Troubleshooting

  • Not authenticated: run cliptude auth login, or set CLIPTUDE_API_KEY to a clp_ key from /developers/.
  • cliptude: command not found: npm installed it outside your PATH. Check npm prefix -g and add its bin folder to PATH.
  • A job fails for credits: run cliptude estimate first. Cliptude has no free plan or free credits, so the account needs a plan or pay-as-you-go credits.

Frequently asked questions

How do I install the Cliptude CLI?

npm i -g @cliptude/cli, then cliptude auth login.

What is the Cliptude skill?

Instructions in the SKILL.md format that teach an agent the Cliptude workflow. Install it with npx skills add cliptude/cliptude.

CLI or MCP server?

The MCP server for agents that support it, with nothing to install. The CLI for agents that only run shell commands, for CI, and for uploading local audio or video.

Can I run it without a browser?

Yes. Set CLIPTUDE_API_KEY to a clp_ key from /developers/.

What does a video cost?

A faceless documentary is 22 credits a minute with your own voiceover and 40 with an ElevenLabs voice, on plans from $19/mo. cliptude estimate quotes the exact price first.

Is there a free plan?

No. Cliptude has no free plan and no free credits.

Which agents can use the Cliptude CLI?

Any agent that can run shell commands: Claude Code, Codex, Gemini CLI, OpenClaw, Hermes Agent, Goose, Cline, Cursor and others. Add the skills with npx skills add cliptude/cliptude so it knows the workflow.

Does the Cliptude CLI need Python?

Yes. The npm package needs Node.js 18 or later and runs on Python 3.10 or later, setting up its own environment in ~/.cliptude/venv; set CLIPTUDE_PYTHON to point it at a specific Python.

Can the CLI upload my own voiceover?

Yes. cliptude generate --voiceover narration.mp3 reads the file from disk, or --voiceover-url takes an https link. It has to be at least 6 minutes long.

Can the CLI make videos in the Cliptude desktop app?

Yes. cliptude use desktop sends jobs to the running app, cliptude use cloud to cliptude.com, and cliptude use auto (the default) picks the app while it is open.

Why did cliptude generate stop without creating a job?

Every job is reviewed first. In a terminal the CLI asks you to confirm; in a script it prints the review and exits, and you rerun with --review-token once you approve.

Is there a free plan?

No. Cliptude has no free plan and no free credits.

Make your first video from your agent

Plans from $19/mo to $875/mo, priced per finished minute; a 1-hour documentary costs from $32. Cliptude has no free plan, so watch the sample videos first to judge the output.

Keep reading

How to make videos with Claude Code · How to make videos with Codex · How to make videos with OpenClaw · Cliptude MCP server · Full MCP docs · Make videos with AI agents

Checked 24 October 2026. Source: Cliptude CLI + MCP README (GitHub). Source: npm: @cliptude/cli. Source: Cliptude skills (GitHub). Source: vercel-labs/skills: supported agents and paths. Source: vercel-labs/skills README.