For coding agents
Ask your agent for a video.
Get a link you can watch.
Your agent records a browser walkthrough - or uploads an MP4 it already has - and hands you a link. Copy one prompt, approve once, no account.
One file, no dependencies, no package manager. Free. Recording needs ffmpeg and Chrome on the machine; sharing a file it already has needs neither.
Agent · 14:32
Fixed the coupon validation. All 12 checkout tests passing - here is the run:
🎬 yorecord.com/view?uid=8f3a…
Works with anything that speaks MCP
01
Paste the prompt
Your agent downloads one file, registers it, and verifies the install itself.
02
Approve once, in your browser
One click, on a page that says what you are allowing. You never see or copy a key, and you approve once per machine.
03
Ask for a video
“Record a walkthrough of the checkout flow and send me the link.” It drives the browser, then hands you a URL your team can open.
Before you use it
What it does not do.
Every one of these would otherwise be a surprise after you had recorded something.
Public to anyone with the link
No login, no allowlist. The URL is unguessable, which is not private. Videos are deleted after 7 days.
No audio, and the cursor is drawn
No microphone, no tab sound. A screen capture contains no pointer, so we draw one.
A fresh Chrome profile, never yours
Nothing you are logged into can reach a public video - so a walkthrough of your own product needs the agent to log in on camera.
10 minutes, one tab, 10 uploads a day
It stops itself at the cap, and records only the tab it opened. Uploads are also capped at 200 MiB a week, which is the limit a busy pipeline meets first.
Look at the whole frame before you approve. A sidebar of customer names, a notification, an open document - the link is public. Never record passwords or credentials.
If you would rather do it yourself
The manual routes.
The prompt is the short path. Everything it does, you can do by hand.
Install it yourself, in one line
mkdir -p "$HOME/.yorecord" curl -fsSL https://yorecord.com/yorecord.mjs -o "$HOME/.yorecord/yorecord.mjs" # Recording needs ffmpeg. macOS ships none, so check now rather than mid-demo: ffmpeg -version >/dev/null 2>&1 || echo "install ffmpeg: brew install ffmpeg / sudo apt install ffmpeg" # Claude Code claude mcp add --scope user yorecord -- "$(command -v node)" "$HOME/.yorecord/yorecord.mjs" --mcp # OpenAI Codex codex mcp add yorecord -- "$(command -v node)" "$HOME/.yorecord/yorecord.mjs" --mcp
Absolute paths in both places, and user scope - a desktop app resolves a bare node differently, and a project-scoped entry silently shadows this one. Containers, Cursor and other harnesses: /setup.md.
Share a video with no install at all - three HTTP requests
For an agent with a shell and no MCP, or a container that cannot install anything. This path shares a video your agent already has; it does not record.
Set up YoRecord agent sharing and share a video with me. Do not install anything. 1. Ask for access: curl -sS -X POST https://up.yorecord.com/agent-tokens/device Show me the verification_url, and the device_code too if I ask. 2. Poll every 3s until I approve it in my browser: curl -sS "https://up.yorecord.com/agent-tokens/device?device_code=$DEVICE_CODE" Save the token to ~/.config/yorecord/token, chmod 600. It is returned once only. 3. Upload an MP4 you already have (a Playwright recordVideo file, a CI artifact, anything): SHARE_ID=$(uuidgen | tr 'A-Z' 'a-z') curl -sS -X PUT "https://up.yorecord.com/agent-shares/$SHARE_ID/rendered.mp4" -H "Authorization: Bearer $(cat ~/.config/yorecord/token)" -H "Content-Type: video/mp4" --data-binary @VIDEO.mp4 Give me the url from the response. Rules: MP4 only, 50 MiB max, 10 uploads a day and 200 MiB a week. Links are PUBLIC to anyone who has them and are deleted after 7 days. Ask me before you upload, and tell me what the recording shows. If a request is blocked, tell me and stop; do not work around it. If this machine has no MP4 and no browser automation already installed, tell me and stop.
Every failure case is written out at /agent.md.
See the prompt before you paste it
Install the YoRecord recorder for me, then tell me whether it worked.
1. Download it. One file, no dependencies, no package manager:
mkdir -p "$HOME/.yorecord"
curl -fsSL https://yorecord.com/yorecord.mjs -o "$HOME/.yorecord/yorecord.mjs"
2. Check it actually runs before registering it anywhere:
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | "$(command -v node)" "$HOME/.yorecord/yorecord.mjs" --mcp
You should get one line of JSON naming four tools: yorecord_share_video,
yorecord_start_recording, yorecord_browse, yorecord_stop_and_share. If you get nothing, or
an error, tell me exactly what you saw and stop here.
3. Register it as an MCP server using whatever mechanism YOUR harness uses - you know that
better than this document does. It is a stdio server: the command is node and the arguments
are ["$HOME/.yorecord/yorecord.mjs", "--mcp"]. Use ABSOLUTE paths for both the node binary
and the file, because a GUI app inherits none of my shell's PATH. If you know the CLI for
your harness, prefer it. The ones we have tested:
Claude Code claude mcp add --scope user yorecord -- "$(command -v node)" "$HOME/.yorecord/yorecord.mjs" --mcp
Codex codex mcp add yorecord -- "$(command -v node)" "$HOME/.yorecord/yorecord.mjs" --mcp
Hermes hermes mcp add yorecord --command node --args "$HOME/.yorecord/yorecord.mjs" --mcp
Cursor add it under "mcpServers" in ~/.cursor/mcp.json
If you already have a yorecord entry from an earlier attempt, remove it first - a stale one
can shadow the new one and the symptom is "configured but failed to connect".
4. If you run inside a container: put the file on a writable mount that survives a restart,
and set the environment variable YORECORD_CONFIG_DIR to a directory on that same mount.
Otherwise I will have to approve this machine again every time the container restarts.
5. Tell me three things: whether it registered, whether I need to restart the app before you
can see the tools, and anything you had to do differently from the above.
For reference, so you know what you just installed: it records a browser walkthrough and gives
me a link, or uploads an MP4 you already have. Recording needs ffmpeg and Chrome on this
machine; sharing an existing file needs neither. The first use will ask me to approve this machine once - one
click, in my own browser, and never again. Links are public to anyone holding them, and are deleted after 7 days.Stop taking “it works” on trust.
One prompt, one click, and the next time your agent says it fixed something you can watch it happen.
Looking for the screen recorder instead? That is the rest of YoRecord.