Let your agent make the video

Write the brief

Once your agent is connected (see Connect Claude or Codex or Connect any MCP client), describe the video in plain words. A good brief covers:

• Where to start: the app, the window or display to record, and the screen it should open on.
• The steps, in order: what to click, what to type, which data to use.
• What to say: one line per step. Your agent turns each line into a caption on the moment it describes.
• What to point out: the button or number the viewer should notice.
• What stays private: an email, a token, a customer name to blur.
• The file you want: MP4 or GIF, with or without captions.

Set the stage before you send it: signed in, sample data loaded, the right window open. Your agent records what is on screen.

Example briefs

Training

Record a training video with Kirocast for someone new to the app. Start on the
dashboard, create a first project called "Q3 launch", add two tasks and assign one.
Narrate each step in one short sentence. Export an MP4 with captions.

UI update

We moved projects into the new sidebar. Record the Safari window with Kirocast:
open the sidebar, show where projects now live, then search for "Q3". Circle the
sidebar toggle the first time you use it. Export an MP4.

Support

A customer asked how to export a CSV. Record it with Kirocast: open Reports, choose
last month, then export the CSV. Blur the account email in the top right for the
whole video. Export a GIF I can paste into the reply.

What your agent does

1. Checks the setup. recording_status lists your displays and confirms Kirocast can capture the screen and control the pointer.
2. Looks, then starts. It takes a screenshot to see the screen, then calls start_recording on a display, a window or an area. The recording bar shows a sparkles badge for the whole take.
3. Drives the app. It clicks, types, presses keys, scrolls and drags. The pointer travels along a smooth path, and each click gets a click ping and an automatic zoom, just like yours.
4. Keeps the pace. Once 0.4 seconds pass after an action, the recording pauses itself, then resumes on the next action, so the time your agent spends thinking stays out of the video. A wait keeps rolling, so a deliberate pause stays on screen. For something that moves on its own, such as an animation or a progress bar, ask your agent to record with pace_to_actions off.
5. Narrates as it goes. Each narrate line during the take is stamped at that moment and becomes a caption, so the words land on the right screen.
6. Stops and edits. stop_recording saves the project, zooms included, and the preview card appears for you. Your agent can then trim the ends, cut a span, speed up a wait, adjust a zoom, add a focus oval, a tap-tap or a privacy mask, and set the backdrop.
7. Checks its work. read_rendered_frame shows a moment exactly as the export will draw it, so your agent confirms a zoom frames the right thing and a mask covers what it should.
8. Exports. export writes an MP4 at High (1080p, up to 60 fps) by default, or a GIF, into ~/Movies/Kirocast/Exports with the events file beside it. Export uses your license; see Activate your license.

Review and ask for another pass

Watch the exported file first. The project sits in History with the other recordings; choose Made by agent under Recording type to see only these. Open it in the editor to adjust anything by hand, or tell your agent what to change:

The zoom on the Settings click is too tight, pull it back a little.
Cut the pause after sign-in, and keep the mask on the email until the end.
Then export again.

• Watch it happen: ask your agent to open the project in the editor. Each change then lands on screen as one undo step.
• Keep both cuts: ask it to create a version first, and the earlier edit stays one click away. See Versions.
• After a UI change: send the same brief again for a fresh take. Your agent can read the previous project’s clicks, annotations and narration to keep the new video consistent with the old one.