Annotate
Frame anything on your screen, write a note, and your coding agent does what the note asks.
Getting started
-
You need: Claude Code (claude --version prints its version), on a Mac or on Ubuntu (below).
-
Install: paste this into a terminal. It asks once before it installs, then offers to sign in, which you can skip.
curl -fsSL https://annotate.fly.dev | sh
-
First run: in a Claude Code chat that was already open, type /reload-plugins once. No API key needed.
-
Uninstall: curl -fsSL https://annotate.fly.dev/uninstall | sh
| macOS | Ubuntu |
|---|
| System | Apple silicon, macOS 15 or later | Ubuntu 26.04 or later, standard GNOME desktop |
| Terminal | Terminal; ⌘V pastes | Ctrl+Alt+T opens it; Ctrl+Shift+V pastes |
| First open | Annotate is in Applications. A window walks you through allowing Screen Recording and the Microphone; if you said no, use System Settings > Privacy & Security. | Click Allow to let it take screenshots, and Add for its keyboard shortcuts. |
| Draw a frame and open its note | ⇧⌘F | Ctrl+Shift+F |
| Send it | ⌘↩︎ | Ctrl+Enter |
| Show or hide the inbox | ⇧⌘E | Ctrl+Shift+E |
Use
/annotate: this chat gets your frames./annotate off: this chat stops getting them./annotate help to learn more.
Privacy
Your frames and notes stay on your computer and go only to the agent chat you pick. Voice goes to xAI (or ElevenLabs,
if you choose it) to become text. Annotate's servers get only counts, your sign-in, feedback you send and the crash
reports you agree to. PRIVACY.md has the details.
License
These docs are open source under the MIT license (see LICENSE). Annotate itself is not open source.
