Produce a video
Install the HTML-first engine, write a brief, review each agent pipeline stage, and render a finished video locally on your machine.
This tutorial produces one video from a written brief: you install an engine (they are opt-in, not part of the base install), create a brief, dispatch the three-stage agent pipeline with a review point between each stage, and render locally. The walk uses the HTML-first engine — the default, and the path with the plainest setup; the typed React engine is pointed to at the end.
The scenario: a short teaser for something you are working on — a product, a feature, an announcement. One message, under a minute of runtime, your own wording in every frame.
Prerequisites
- Ultra tier — Video is an Ultra surface; on Pro the view is visible with a lock (see Tiers: Pro & Ultra).
- Node.js 22+ on your machine — both engines require it (see System requirements).
- Your Claude subscription connected — the three pipeline stages are agent runs (see BYO Claude & keys). Rendering itself is local and free: no render service, no per-video fee.
- Disk and bandwidth for a one-time engine setup, including a roughly 150 MB render-browser download.
- Optional: ffmpeg, only if you will prepare raw footage; any assets (logo, screenshots, a reference URL) you want in the video.
Step 1 — Install the engine (opt-in, one time)
Open the Video view. The engines are substantial dependencies, so each sets up on demand from a setup card that renders in place of the engine's surface until it is installed.
- Pick the HTML-first engine in the header switcher (it is the default).
- Read the setup card — it states exactly what one click does: install the engine's dependencies and pre-fetch the local render browser used for frame-accurate capture.
- Click install and watch the progress on the card.
You should see: the setup card replaced by the engine's surface when the install completes. A failed browser fetch can be retried on its own without reinstalling. The HTML-first engine is Apache-2.0 licensed and installs with a plain button; the React engine's card additionally requires a license acknowledgment — relevant only if you take the alternate path at the end.
Step 2 — Create the brief
- Create a brief with a name and your creative direction. The brief is a single free-form field — write the message, the audience, the tone, and the pacing you want, in plain prose.
- Optionally enrich it: attach assets, reference files or URLs, and a Capture of a website the video is about.
You should see: the brief open into its staged tabs — Brief · Storyboard · Preview · Files · Renders · Capture · Footage · Catalog · Templates. The pipeline runs as three agent stages you dispatch in order, reviewing between each.
Step 3 — Stage one: Author brief (then review)
Dispatch Author brief. The first agent reads your direction plus every reference in full and rewrites the brief denser and reference-aware — the same field, tightened.
Review point: read the refined brief. It should say what you meant, more precisely. If the direction is off, edit the field or re-run — re-run this stage whenever your direction changes. Nothing downstream has been built yet, so this is the cheapest place to steer.
Step 4 — Stage two: Plan (then review the storyboard)
Dispatch Plan. The planner turns the brief into a storyboard: per-beat creative direction — mood, camera, assets, exact building-block picks and transitions — as a document.
Review point: open the Storyboard tab and read it beat by beat. This is a document you can edit before anything is built — the last cheap intervention point. Check that the beats tell your story and the assets you attached are placed where you expect.
Step 5 — Stage three: Author
Dispatch Author. The third agent installs the planned building blocks, writes the composition files, wires the animation timelines, and self-checks its output before finishing.
You should see: composition files appear under the Files tab — everything the agent wrote, inspectable as ordinary files.
Step 6 — Preview, iterate, render
- Open Preview and watch the composition.
- To change something, go back to the stage that owns it — wording to the brief, scene order to the storyboard — and re-dispatch from there. The stages are the review gates; iterating through them beats hand-editing the output.
- When the preview is right, render.
You should see: the render run locally through the pre-fetched browser, and the finished video collect in the Renders tab. Renders are files in your workspace — no upload happened, and no per-video fee applies.
Optional — prepare raw footage first
If your video builds on a recording — a talking-head take, a screen capture — the Footage tab inside the brief is the workbench: bring an mp4, and prepare it into a clean cut before graphics are authored over it — transcription, filler-word and dead-silence removal, trim and split on a visual timeline, color grading. The prepared clip lands in the brief's assets. This is the one part of the studio that requires ffmpeg on your machine.
The other path: the typed React engine
Switch the header to the React engine for the schema-validated pipeline. The shape is the same — three staged agents with review between: a brief author enriches your draft's creative hints, a script author writes the scene-by-scene production script and picks the compositions, and a composer produces a schema-correct render proposal plus a readable walkthrough of what it intends. You review the proposal in the brief, then dispatch Produce to render or send it back with edit instructions. Renders land in History. Note the license checkbox on its setup card: Remotion is source-available and free for individuals and small companies; larger companies need their own license.
Where everything landed
| Artifact | Location |
|---|---|
| The brief, storyboard, and composition files | The brief's workspace — Brief, Storyboard, and Files tabs |
| Finished renders | The brief's Renders tab (React engine: History) |
| Website captures and prepared footage | The brief's Capture tab and assets |
Where to go deeper
- Video — the production studio — both engines, all tabs, costs and requirements in reference form
- Agent pipelines — the pipeline agents behind the three stages
- System requirements — Node.js and the engine downloads
- Tiers: Pro & Ultra — where Video sits in the subscription
Build a knowledge product
Take a thesis and a folder of raw material through the staged Products pipeline — sight, research, scope, finalize, and export the two-component bundle.
Ground a session
Author a context artifact, optionally attach a knowledge graph at a chosen depth, ground a terminal session with it, and verify the agent starts briefed.