Skip to content
tryapparentPublic
forked from kitlangton/scrawl

About

Show an agent a problem: mark up, record, send

Resources

Contributing

Stars

11 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

Apparent — Point. Talk. Draw.

Apparent

Point. Talk. Draw. Let your agent take it from there.

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

Show, then tell

  1. Record — press ⌥⇧S on macOS or Alt+Shift+S on Linux.
  2. Make your point — talk, click around, hold Shift to draw, or Shift-click to drop a pin.
  3. 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.”

Get started

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.

Give your agent eyes

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/apparent

The 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.

Have your agent make a video

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-apparent

Then 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.

Find your way

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.

License

MIT. With thanks to the projects credited in our third-party notices.

About

Show an agent a problem: mark up, record, send

Resources

Contributing

Stars

11 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages