# Set up YoRecord - paste this to your agent

Paste everything between the markers into your coding agent. It works in Claude Code, Codex,
Hermes, Cursor, OpenClaw, or anything else that can run a shell command and speak MCP.

<!-- SETUP-BLOCK-START -->
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 six tools: yorecord_share_video,
   yorecord_start_recording, yorecord_browse, yorecord_replay, yorecord_stop_and_share,
   yorecord_revoke_share. If you get nothing, or an error, tell me exactly what you saw and
   stop here.

3. Check the two things recording needs, and tell me if either is missing. Do not install
   them yourself - tell me the command and let me decide:

   ffmpeg -version >/dev/null 2>&1 || echo "MISSING ffmpeg - brew install ffmpeg, or sudo apt install ffmpeg"
   command -v google-chrome chromium chromium-browser >/dev/null 2>&1 || echo "MISSING Chrome or Chromium"

   Neither is needed to share an MP4 I already have. Both are needed to record one, and
   macOS ships no ffmpeg.

4. 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".

5. 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.

6. 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, speaks
over it, and gives me a link - or uploads an MP4 I 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.
<!-- SETUP-BLOCK-END -->

## Then try it

> Record a 30-second guide showing how to find the sunrise time for Prague on timeanddate.com,
> then give me the link.

It rehearses first, performs the walkthrough, speaks over it, and hands back two links: one
that plays the finished video, and one that opens it in the editor if you want to trim it.
The voice needs nothing from you - it runs on YoRecord's own account, and the approval click
above is what turns it on.

## If your agent has no MCP support

It can still share a video it already has with three plain HTTP requests, no install at all:
see <https://yorecord.com/agent.md>.