Click through your app. Say what's wrong. Hand the list to an agent.

Context Recorder is a macOS screen recorder for reviewing your own apps. You talk while you use the app and press a key when something is off. Each mark keeps the frame, what you said, and what the page knew at that moment: the element under the pointer, its source file, and the request that failed.

⌃⌥Rrecord⌃⌥Mmark⌃⌥Smark a regionBuild from source

0:00Press play to hear the narration, or pick a mark.

The Sessions window

Every recording stays on your Mac. When you stop, the session opens with the video, a timeline of apps, page events and narration, and three tabs.

Mark later
Press M at the playhead, or S to cut a region from the frame. Review marks get the same context as live ones.
Cut and join
Shift-drag on the timeline and press ⌫. Marks, narration and events close up around the cut. recording.mp4 never changes.
Draw on it
Arrows, boxes, text and highlights on the video or on a mark's image. The Markdown uses the marked-up picture.
Canvas
Lays a recording out as tall columns of the pages you scrolled, so you find a moment without scrubbing.
Find
⌘F filters marks, transcript and events at once, and highlights the matches.
Plain files
A session is a folder: the video, session.md, one Markdown file per mark, and the raw logs.

Agents read it directly

Copy as Markdown works for one mark or the whole session. Paste it into a chat, or point an agent at the session folder.

For more than one Mac, push a session to a Cloudflare Worker you run. You can watch it in any browser, share a link, and give agents access over MCP. They can list sessions, read marks with their screenshots, and get the frame at any moment. Nothing uploads until you push, and audio.wav never does.

claude mcp add --transport http sessions https://<your-worker>/mcp

Worker setup: cloud/README.md. Format and sign-in: docs/cloud-sessions.md.

Install

There is no download yet. You build the app from source with one script. It builds and signs the app, installs it to /Applications, and opens it.

You need

  • macOS 26 and the Command Line Tools (not Xcode)
  • ffmpeg and parakeet-mlx on your login-shell PATH
  • Google Chrome, for page context

Build

git clone https://github.com/byronwall/context-recorder
cd context-recorder
./scripts/build-app.sh

Connect Chrome

  1. Click the Chrome badge on the record card. The app copies the extension's folder path and opens chrome://extensions.
  2. Turn on Developer mode, click Load unpacked, and paste the path.
  3. The badge shows Connected. Your web app needs no changes, and input values are never recorded.

The first run asks for Screen Recording and Microphone access. The README has every key, the session files and the cloud.

Click to zoom · drag to pan · Esc to close