Your agent ships the video too.

Paste one line where your agent works on your app, and it hands you the video.

Record a demo video of this app with vosso. The steps are at vos.so/agent.md. Give me the vos.so link when it's done.

What the line does

It says what it is about to do, then runs in your repo, on your machine. You get the video and its link.

Your agent reads the line, tells you what it is about to do, installs the vos CLI in your repo, opens your app, records it, cuts it in the studio and hands you the link.

Flowboard: sketch a sign-up flowvos.so/vos/87d517dd · v1

The hard parts, handled

A real product has a login, secrets and buttons that cost money. Your agent records it anyway.

app.example.com/settings
You

Signed in

Session saved, no password stored

Behind your login You sign in once. The agent records inside that session and never sees the password.

Secret key

Masked
The key, blurred in every frameCopy

Secrets never recorded Keys and cards are masked before the first frame, so not even the raw file holds them.

Generate video

Pressed once, with your yes

Paid buttons, pressed once Rehearsals only point at it. The take presses it once, with your yes.

8 min, cut
MP4

result.mp4

Downloaded

Waits off camera A result that takes minutes is cut from the video and kept as a file.

A Mac app, the same way

It lists the window’s controls, scripts them, and presses the real app while that window alone is recorded. What is yours is covered before a frame is saved.

A video, not a file

Every decision lives in a document your agent can read, patch and hand back.

take/doc.jsonv3 → v4
  "zoom": [
-   { "at": 2.1, "level": 2.2 }+   { "at": 2.1, "level": 1.8 }  ]

Edits are patches A zoom changes as a value in doc.json. Nothing records again.

Claude Code
$ vos open take
✓ doc.json opened in the studio
→ vos.so/studio

A person takes over The studio opens on the same take, every edit intact.

On every pull request

The Action records the product in CI and comments with the video.

.github/workflows/media.yml
name: release media
on:
  pull_request:
  push:
    tags: ['v*']
permissions:
  contents: read
  pull-requests: write
jobs:
  media:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: 22 }
      - uses: vosjs/action@v1
        with:
          key: ${{ secrets.VOS_API_KEY }}

Questions

Can an AI agent make videos with vosso?

Yes. The vos CLI runs the whole pipeline headless: vos record drives a page from an actions.json script and records it, the take’s doc.json holds every editable decision as plain JSON, and vos render produces the final video. Logs go to stderr, results to stdout, and --json streams NDJSON events, so no TTY is needed. A Mac app is recorded from the same kind of script, in its own window.

How does an agent edit a vosso video?

By patching JSON, not regenerating code. A take’s doc.json contains zoom spans, trims, speed ramps, and styling as data; the rendering program is constant. An agent changes a number and re-renders: the browser flow never re-runs, and manual edits survive re-planning.

Can my agent record a product behind a sign-in?

Yes, without ever seeing your password. vos session open opens a browser where you sign in once; the agent records inside that saved session (vos record --session) and scripts inside it with vos session exec. Keys, cards and email addresses are masked before the first frame, a step that costs money is marked "guard": "spend" and pressed only under --confirm, and teardown steps undo what the walk created.

Can my agent record a desktop app?

Yes, on a Mac. vos look --app lists the controls of the app’s window, and vos record --app --actions presses them with the real pointer and keyboard while the window alone is recorded, without the system pointer. What must not show, an account name or your other work, is covered before a frame is saved, and one take per app joins into one film. It needs macOS 14 or later, with Screen Recording and Accessibility granted to the app your agent runs in, and it uses your pointer until the take ends.

What does the line do on my machine?

Five things, in order. It installs one dev dependency in your repo, @vosjs/cli, which is open source and runs no install scripts. It adds the vos skills to your agent’s skills folder and one marked block to AGENTS.md. It records your app in a browser on your machine. It opens the take in the studio. And it uploads the video only because the line asks for a link: leave that sentence off and nothing is uploaded. The steps are a short file at vos.so/agent.md that you can read first, and your agent tells you its plan before it starts.

Can I set it up without my agent reading a web page?

Yes. Paste a line that names the package instead of the address, and your agent installs @vosjs/cli and reads the steps from it. Or install the skills yourself, as a Claude Code plugin or with npx skills add vosjs/skills, and ask for the video by the skill’s name. The door on vos.so offers all four ways in.

Which agents does it work with?

Any coding agent that can run a terminal command: the procedure at vos.so/agent.md installs the CLI into your repo and its skills into the agent. Our end-to-end runs use Claude Code. A cloud agent or CI job with no browser records a public page with vos record --hosted.

Can my agent put a video it already made on vos.so?

Yes. Paste the host line to it: it rewrites a Remotion or HyperFrames composition, an HTML page or a script so the words and colours are data, pushes it, and hands you a link that plays and keeps every version. Without a credential the push is claimable, and you claim it with a free account.

Is there machine-readable documentation?

vos.so/llms.txt carries the CLI commands, config schemas, and pipeline description in plain text. The @vosjs/cli README documents the take format and exit codes. Both are written to be pasted into an agent’s context.

Something else? hello@vos.so

With Claude Code, step by step →The tools that do this, compared →

Ship the video with the release.

Read agent.md →
  • Free
  • No watermark
  • Any agent with a terminal