That button. That weird layout. That bug that only happens when you do this. Show your agent what you mean with a quick screen recording, your voice, and a few marks.
Download Apparent · Agent setup · Docs · MIT
- Record — press
⌥⇧Son macOS orAlt+Shift+Son Linux. - Make your point — talk, click around, hold
Shiftto draw, orShift-click to drop a pin. - Hand it off — press the shortcut again to finish, then paste into your agent chat.
Your agent gets annotated keyframes, a timed transcript, and an interaction timeline
in a .apparent bundle. It can read what you said, see where you pointed, and pull
more frames when it needs a closer look.
Less “the thing next to the other thing.” More “oh, that.”
Download a release for macOS or Linux, launch Apparent, and follow the permission setup. Linux main builds are previews; choose the release for your platform. Windows is unsupported.
Prefer to let your agent handle installation? Paste this into its chat:
Install the Apparent desktop app from [Apparent releases](https://github.com/tryapparent/apparent/releases), then launch it.Need help getting set up? See the recording guide and Linux setup.
Install the optional capture-reading skill for Claude Code, Codex, OpenCode, and other agents:
bunx skills add https://github.com/tryapparent/apparent/tree/main/capture/agent/skills/apparentThe skill teaches your agent to read captures and look closer with apparent zoom,
frames, and inspect. Install the CLI on the
agent's machine too; installing the skill alone doesn't install the app.
Headless Linux agents can fetch and read captures without launching a desktop.
Apparent also helps your agent show what it made, reproduce a bug on video, or explain how something works. Install the separate video-making skill:
bunx skills add https://github.com/tryapparent/apparent/tree/main/capture/agent/skills/make-it-apparentThen ask your agent:
Make it apparent: record a short demo of the change you just made.
Show the interaction and its result, add narration and captions,
and give me a playable video.
The skill guides the agent through recording real interactions, creating explanatory visuals when needed, and checking the complete video before handing it back. Proposed behavior and conceptual examples are labeled so you can tell them apart from working software.
Live desktop demos need the app running on the agent's machine, capture permissions, and a safe screen to record. See the video-making skill and agent video workflow for setup and verification details.
| I want to… | Start here |
|---|---|
| Record, draw, change shortcuts, or set up permissions | Recording guide |
| Set up a Linux desktop | Linux guide |
| Install the CLI on my agent's machine | Agent installation |
| Inspect, zoom, copy, or reprocess a capture | CLI and agent guide |
| Have an agent create a demo, bug video, or explainer | Video-making skill · Video workflow |
| Choose a transcriber, tune crops, or export video | Processing guide |
| Fetch shared captures with Connect | Connect setup |
| Build and test Apparent | Development reference · macOS packaging |
| Understand the bundle format | Keyframes and text |
Connect is a candidate integration. Uploads are off by default. Upload approval and agent read approval are separate; website sign-in grants neither. Setup and current limits.
MIT. With thanks to the projects credited in our third-party notices.
