Tellscreen

How to send a video to Claude Code, Codex or Cursor (November 2026)

Checked and updated

Claude Code, Codex and Cursor can't watch a video, so send them the recording as a change list instead: one command to Tellscreen turns any screen recording into one, with a screenshot of each moment.

If you just drop recording.mov into Claude Code, it will pull frames out with ffmpeg, realise the requests are in your voice, look for a transcription tool, and usually stop to ask you for a transcript. We tested what each assistant does with a video: without the sound, none of them could name a single change.

The quickest way: one command

Run this in the folder with your video, or ask your agent to run it:

curl -fsS -T recording.mov "https://tellscreen.com/api/v1/convert?wait=110"

On Windows PowerShell, type curl.exe instead of curl. In about the time the video lasts, it prints Markdown your agent can work from:

  • a one-paragraph summary
  • every change you asked for, numbered, each with your exact words, where on screen it is, how to check it's done, and a screenshot link of that moment
  • the full transcript with times

The video is uploaded as a private video. The response header x-tellscreen-library is a link that opens it in your Tellscreen library. If the video is long and the list isn't ready within the wait, it prints a short command to collect it.

A link works too, if it points at the video file (a public Google Drive or Dropbox link is fine):

curl -fsS -H 'content-type: application/json' -d '{"url":"https://example.com/demo.mp4"}' "https://tellscreen.com/api/v1/convert?wait=110"

Teach your agent to do it by itself

Install the Tellscreen skill once and your agent will do this whenever you hand it a video, and record your screen when you say "let me show you".

Claude Code (adds a Record screen button above the prompt, too):

/plugin install tellscreen --marketplace https://tellscreen.com/claude/marketplace.json

Codex and other agents that read skills:

mkdir -p ~/.agents/skills/tellscreen && curl -fsSL https://tellscreen.com/skill.md -o ~/.agents/skills/tellscreen/SKILL.md

Any MCP client (Claude Desktop, Cursor, VS Code, Windsurf): add the server https://tellscreen.com/mcp. There's nothing to sign in to. Its tools turn a video link or a local file into the change list, and start a recording for you to make.

The Mac and Windows app sets up the Claude Code plugin and the Codex skill for you on first launch. It also has Change list from a video file in its menu: pick any recording and the change list is on your clipboard, no terminal needed.

Recording something new?

Record it with Tellscreen and skip the upload. Press ⌥⇧R (Alt+Shift+R) in the desktop app, or the Record screen button in Claude Code, talk through what should change, press Stop, and the change list is in your prompt. You can draw on the screen while you talk with ⌥⇧D. See Tellscreen for Claude Code and Codex.

What it costs

Converting a video counts as a video and a change list on your plan. Free includes 25 videos of up to 10 minutes and 5 change lists a month; Pro is $8 a month for 200 change lists and 4-hour videos. See pricing.

Sources

Read next