Markdown twin

Updated: July 2026

A markdown twin is the structured text document an agent-readable recording produces, holding the summary, key moments, click targets, transcript, and metadata in one file.

It is the "text face" of a Clipy share link. The same URL serves a video player to humans and the markdown twin to agents. The twin is what an AREC (Agent Recording) document is: markdown a language model reads directly, with no tooling on its side.

For example, the Export CSV recording's twin opens with an AI summary ("clicking Export CSV leaves the button loading, console shows a TypeError from exportWorker.ts:142"), then lists the key moment at the click, its extracted frame, the click target coordinates, and the timestamped narration. The agent reads all of it in one fetch.

Get the twin by appending .md to any watch URL, for example https://clipy.online/video/<id>.md. Public links need no key. The MCP one-call bundle is the get_agent_context tool.

Related terms: AREC (Agent Recording), key moment, agent context.

Learn more: an annotated walkthrough of the markdown twin. See the AREC spec.