You will learn#
- how to connect an agent and what it can do;
- the order in which a good agent works, and the commands it runs;
- how you check its work.
The idea#
The agent uses the same commands you do. Through MCP it calls tools such as edit, lint and view; with a shell it runs the same operations from the CLI. Every edit is a numbered revision with the name of the agent, so you can read the history and undo any step. Nothing is sent over the network by the product itself.
Steps#
-
Connect the agent. For Claude Code:
Terminal claude mcp add vukem-video -- vukem-video mcpOther clients take the same command, see Connect an agent. If you run the editor, the agent and the browser share the project.
-
Teach it the product.
vukem-video agent:docs --print skillprints the skill and--print agentsthe snippet for yourAGENTS.md; see The skill. -
Ask in plain words, for example: "Import
interview.mp4, remove the silences, caption the speech and export a 9:16 video." -
The agent works in this order. You can follow it in the history.
Step MCP tool CLI create the project project_createvukem-video project:create --name "Interview" --id prj_7k2m9x4q1bimport the media media_importvukem-video media:import interview.mp4 --project prj_7k2m9x4q1b --asset-id ast_3c5v8n2w6dlearn the operations command_helpvukem-video command:help clip.addedit in one batch editvukem-video edit --project prj_7k2m9x4q1b --ops -transcribe job_startwith"kind": "transcribe"vukem-video transcribe --project prj_7k2m9x4q1b --asset ast_3c5v8n2w6d --waitcheck lint, thenviewvukem-video lint --project prj_7k2m9x4q1bexport job_startwith"kind": "export"vukem-video export --project prj_7k2m9x4q1b -
Read what it did. The agent sees the same history you do:
Terminal vukem-video history --project prj_7k2m9x4q1b -
Undo what you do not like.
vukem-video undo --project prj_7k2m9x4q1breverts the last step, and the agent can redo or try again.
How to check its work#
An agent should look the cheapest way first: read the project as text, run lint, then look at frames with view. How an agent verifies its work explains the order. Ask the agent to run lint before every export; the export is refused while the lint finds an error.
Common mistakes#
- Letting two actors edit from an old revision:
E_REVISION_CONFLICT. The agent reads the project again and plans again; see Recipes. - Asking for transcription before the helper is installed. A person installs it once with
vukem-video tools:install whisper. - Giving the agent a path on another machine. Paths are read on the machine that runs the server.