Tellscreen

Use when the user gives you a video FILE on their computer (a screen recording .mov/.mp4/.webm, a Loom or QuickTime download) that you cannot watch. This server cannot read local files, so this tool returns the exact one-line curl command that uploads the file and prints the change list as Markdown; run it with your shell tool. The result lists every change asked for, with the words said, where on screen, how to check it, a screenshot link of that moment, and the timed transcript.

Use when the user gives you a link to a video (a screen recording, product walkthrough, bug repro or design review: an .mp4/.mov/.webm URL, or a public Google Drive or Dropbox link) and you need to know what it shows or asks for, because you cannot watch video. Tellscreen transcribes it, looks at the screen at the moment each thing was said, and returns Markdown: a summary, every change asked for with the words said, where on screen, how to check it is done and a screenshot link of that moment, then the timed transcript. Waits up to 50 seconds; if it is still working you get a job id for get_change_list. Loom and YouTube pages cannot be fetched: ask the user for the downloaded file instead and use convert_local_video.

Collect the result of record_screen or convert_video_link by job id. Waits up to 50 seconds; call it again while it says it is still working. Also accepts a tellscreen.com/v/ link to fetch the change list of an existing Tellscreen video.

Use when the user wants to show you something instead of typing it ("let me show you", "watch this", a bug they can reproduce, a design or product review). Returns a recording link for the user to open: they record their screen and talk through what should change, then press Stop. Then call get_change_list with the job id to receive the change list (it waits for them).