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
- Install the CLI (Node.js required):
npm i -g @cliptude/cli - Sign in once in the browser it opens:
cliptude auth login - Install the companion skills, so your agent knows the workflow:
npx skills add cliptude/cliptude - 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
- 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.
- 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.
- 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.
- Write the job ids to a file and follow them with cliptude status <job-id>, or cliptude jobs --status running for the whole batch.
- 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.
- 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.
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.
npx skills add cliptude/cliptude -a claude-code
npx skills add cliptude/cliptude -a openclaw -g
npx skills add cliptude/cliptude -a hermes-agent -g
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 CLI | Cliptude MCP server (remote) | |
|---|---|---|
| Install | npm i -g @cliptude/cli (Node.js 18+; it sets up its own Python 3.10+ environment) | Nothing; paste https://mcp.cliptude.com/mcp |
| Sign-in | cliptude auth login in a browser, or CLIPTUDE_API_KEY with a clp_ key | OAuth with Google, or a Bearer clp_ key |
| Your files | Reads local narration, talking-head and media files directly (--voiceover, --talking-head, upload-media) | Uploads through signed URLs: start_voiceover_upload, start_media_upload |
| Job review | Asks y/N in a terminal; in a script it prints the review and stops until you pass --review-token | Returns the review to the agent, which shows it to you and resends with review_token |
| Where it fits | Agents that only run shell commands, CI, batch loops, the Cliptude desktop app | Chat apps and agents that add MCP servers |
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.
Faceless Documentary Agent-planned
Narrated documentaries over real footage, archive pictures, maps and charts.
Faceless Top 10 Agent-planned
Ranked countdowns with a numbered title on every entry, ending on number one.
Avatar Video Agent-planned
An AI presenter on screen, with footage and graphics around it.
Vector Explainer Agent-planned
Flat 2D vector scenes, with an optional recurring character.
Talking Head
Your own camera recording, with captions, B-roll and music added.
Cliptude CLI commands
cliptude templates: your saved templatescliptude estimate --template "…" --script-file script.txt: the credits a video needs, without creating anythingcliptude generate --template "…" --title "…" --script-file script.txt: start a video from your narrationcliptude generate --template "…" --title "…" --voiceover narration.mp3: build the video around your own recordingcliptude status <job-id>: job status and the finished video linkcliptude plan-job, plan-check, plan-lock, continue: agent-planned videos: the agent plans every shotcliptude editor <job-id>: open the finished video's timelinecliptude agent <project-id> --prompt "…" --wait: ask the Cliptude Agent for an editcliptude 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.