claude-annotate
Claude Code plugin: draw and leave notes on your running localhost page, press Send, and the marks land in the session with the element, its React component and source line, and a screenshot per note. Progress comes back onto the page. Local only, no cloud.
Install / Use
claude mcp add FinalAngel -- npx -y github:FinalAngel/claude-annotateIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of claude-annotate
claude-annotate scores 74/100 on our quality scale, 3804th of 4,722 Development & Engineering skills we index.
Its MCP Server is 15 KB long, well organised into 14 sections with 6 code examples: a thorough specification that gives an agent plenty to work with.
It has 3 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated 25 days ago, so claude-annotate is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 92/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
claude-annotate compared with similar skills
All 4 of these similar skills score higher than claude-annotate; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| claude-annotate (this skill)by FinalAngel | 74 | 3 | 25d ago | MCP Server |
| taste-skillby Leonxlnx | 100 | 118.3k | 10d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 113.0k | 10d ago | CLAUDE.md |
| hyperframesby heygen-com | 100 | 86.4k | today | CLAUDE.md |
| rufloby ruvnet | 100 | 82.0k | today | CLAUDE.md |
Frequently asked questions
- How do I install claude-annotate?
- Run
claude mcp add FinalAngel -- npx -y github:FinalAngel/claude-annotate. The install tabs above show the steps for each supported agent. - Which AI agents does claude-annotate work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is claude-annotate safe to use?
- It is MIT-licensed and scores 92/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is claude-annotate still maintained?
- The repository was last updated 25 days ago, so claude-annotate is actively maintained.
Skill content
View source on GitHub
/plugin marketplace add FinalAngel/claude-annotate
/plugin install annotate@claude-annotate
claude --dangerously-load-development-channels plugin:annotate@claude-annotate # once per session, see "The channel flag"
/annotate http://localhost:5180/
The page opens in its own Chrome window with the tools already on it. Pen, arrow, line, box, circle, numbered notes. Scroll, click through to other pages, keep marking. One Send. Claude reads the crops, edits the code, and each pin on the page reports back: spinning while Claude works on it, green with a one-line result, grey if skipped. Clear wipes it all and you go again.
What Claude receives
One event per Send, pushed into the running session. This is the batch behind the screenshot above, as Claude saw it (paths shortened):
Browser annotations · batch 1 · 1 page · 3 notes · 4 marks
## Page 1 of 1 — http://localhost:5180/
viewport 1440×900 · document 1440×7980
overview (the visible window): /tmp/claude-annotate/5e1f2a9c/batch-1/p1-page.png
### Note 1 — "monthly should be the default"
crop: /tmp/claude-annotate/5e1f2a9c/batch-1/p1-crop1.png (region 0,4167 → 1110×536)
pin at 666,4415 · pink
on: <button.ff-seg__tab[role=radio]> "MONTHLY" at 625,4397 size 82×36
in: div.ff-planpass__body > div.ff-planpass__top > div.ff-seg[role=radiogroup]
component: ToggleGroupItem ‹ ToggleGroup ‹ PlanPass ‹ Pricing ‹ SiteSection
source: src/screens/site/content.tsx:171
marks here: pink box around <div.ff-seg[role=radiogroup]> "MONTHLY YEARLY"; sun arrow → <div.ff-planpass__body> "KEEP THE LIGHTS ON MONTHLY YEARLY $…"; cyan stroke around <b.ff-num> "$5"
### Note 2 — "price feels too big, drop one size"
pin at 140,4519 · cyan
on: <b.ff-num> "$5" at 88,4485 size 95×77
component: PlanPass ‹ Pricing ‹ SiteSection ‹ SiteMain ‹ Landing
source: src/screens/site/content.tsx:135
### Note 3 — "arrow should sit in its own circle like the hero buttons"
crop: /tmp/claude-annotate/5e1f2a9c/batch-1/p1-crop2.png (region 0,4670 → 1178×440)
on: <svg> at 752,4883 size 14×14
in: div.ff-planpass__action > a.ff-btn.ff-btn--ghost > span.ff-btn__ic
component: Icon ‹ Link ‹ A ‹ Button ‹ ButtonLink
source: src/screens/site/content.tsx:45
marks here: lime box around <a.ff-btn.ff-btn--ghost> "BECOME A SUPPORTER"
Per note that is: your text, the element under the pin with its visible text and box, where it sits in the DOM, the React components it is rendered by (only the ones that appear in your own code, library internals are dropped), the file and line where that element is written, and the marks drawn near it with what each one points at. Nearby marks are clustered into one crop, so a note and the arrow next to it arrive in the same picture. The overview is there for layout questions: what you see in the window for the page you are on, the full page for the others, which render in a tab behind yours. Screenshots never resize your tab. On a page without React you still get the element, its text, the DOM path and the crops.
source comes from React's own development metadata (_debugSource on React 18, the owner stack on React 19). Vite and Next.js dev builds have it. Production builds don't, and then only the component names and DOM path are reported.
On the page

| | |
|---|---|
| Marks | Pen, arrow, line, box, circle. Four inks with a dark halo, so they read on light and dark pages. Hold ⇧ for a square, a circle, or a line or arrow in 15° steps. In Select, drag a mark to move it or its handles to resize it. |
| Notes | N then click. Type, ↵. Numbered across all pages. Click a pin to edit or delete. |
| Browse | The default. V or esc passes clicks through to the page, so you can open a menu, change route, log in. Pins stay. Pick a tool or press its key to draw. |
| Across pages | Marks are stored per URL. Navigate away and back and they are still there. One Send covers every page. |
| Select | S, click a mark to select it, drag to move it, ⌫ to delete. Pins drag in any mode. ⌘Z and ⇧⌘Z for undo and redo. |
| Send | ⌘↵ or the button. It counts what hasn't been sent yet, so you can send, keep drawing, send again. |
| Progress | Pin spins: Claude is on that note. Green with a line: done. Grey: skipped, with why. The toolbar shows which file Claude is editing. |
| Clear | Two clicks (the second one says Sure?). Removes every mark on every page and the temporary screenshots. |
Keys: P pen · A arrow · L line · R box · E circle · N note · S select · 1 – 4 inks · V / esc browse · ⌘Z · ⇧⌘Z · ⌫ · ⌘↵ send. Drag the toolbar by its grip, it remembers where you put it per site.
Why not paste a screenshot
Pasting a screenshot and describing it works, and it is what this replaces. Each round costs a screenshot, a paste, and prose like "the second toggle in the pricing card, no, the other card". Claude then guesses which file that is. Here the prose is the note, the position is the pin, and the file and line come along for free. Browser tools in the same space, as of October 2026:
| Tool | Where you annotate | How it reaches Claude Code |
|---|---|---|
| annotate (this) | Its own Chrome window, any local site, drawing and notes | Pushed into the running session on Send; progress and results come back onto the page |
| tomreinert/claude-annotate | A Playwright window, drawing only | Pushed into the session; a toast comes back |
| browser-annotations | A Chrome DevTools panel, pick an element, write feedback | Pushed into the session |
| Agentation | A toolbar you mount in your React app | Claude polls an MCP server, or you paste |
| Vibe Annotations | A Chrome extension on localhost pages | Claude polls an MCP server |
| React Grab | ⌘C on an element in your React app | Clipboard, you paste |
Everything that pushes into a running session uses Claude Code channels. Everything else waits to be asked. The first of those projects is where this one started, see Credits.
How it works
One Node process per session, spawned by Claude Code as an MCP server. It does three jobs:
- Browser. On
/annotate <url>it launches the Chrome you already have throughplaywright-core, with its own profile under~/.cache/claude-annotate/, and injectsserver/overlay.jsinto every page before the page's own scripts run. The overlay is a Shadow DOM on a host appended to<html>: the page's CSS never reaches it, and its CSS never reaches the page. Marks live in document coordinates, so they stay put while you scroll. No change to your app, no extension, no build step. - Bridge. The overlay talks to the process over a local HTTP port with a per-session token. State is kept per URL on the server, which is why navigation keeps your marks and a reload restores them. A
PostToolUsehook posts the file Claude just edited, and tool results, toasts and the done summary stream back to the page over server-sent events. - Channel. On Send, the process screenshots every annotated page (pages that aren't open right now get rendered in a temporary tab behind yours, so focus never moves), clusters nearby marks into crops, writes the PNGs to a temp dir, and pushes one
notifications/claude/channelevent into the session. Claude reads the files, edits the code, and callsannotate_progressper note andannotate_doneat the end, which deletes the PNGs.
The overlay mounts on local development hosts only (localhost, 127.0.0.1, private IPs, *.localhost, *.test, *.local, *.internal) and takes the bridge token off the page before any page script runs, so a third-party site opened in that window never sees it. annotate_open refuses other hosts.

Tools the server exposes: annotate_open, annotate_progress, annotate_done, annotate_reply, annotate_screenshot, annotate_pull, annotate_wait, annotate_clear, annotate_close. The /annotate command tells Claude how to use them; the server's MCP instructions repeat the protocol so a channel event is handled even if you never typed the command in this session.
The channel flag
Channels are a research preview in Claude Code. A plugin from your own marketplace can push into a session only when you start the session with
claude --dangerously-load-development-channels plugin:annotate@claude-annotate
Claude Code shows a full-screen confirmation once, then a dim line under the banner says messages from this plugin inject into the session. Alias the command. On Team and Enterprise plans an admin has to enable channels for the organization first, and the flag does not get around that.
Without the flag everything still works except the push:
/annotate <url> --pollmakes Claude wait inside a tool call until you hit Send. Nothing is pushed, nothing is lost./annotate pullfetches the last batch you sent, if Claude didn't react.
What is written where
| Path | What | When it goes away |
|---|---|---|
| $TMPDIR/claude-annotate/<session>/batch-N/*.png | Crops and the overviews for one batch | When Claude calls done, on Clear, when the session ends. macOS purges what a crash leaves after three days |
| ~/.cache/claude-annotate/chrome-profile/ | The Chrome profile the annotation window uses (cookies, logins for your localhost apps) | Stays. Delete it to start fresh. A second concurrent session gets a throwaway profile that is removed on exit |
| ~/.cache/claude-annotate/sessions/<pid>.json | The bridge port and token, so the hook can find its session
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
118.3kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
113.0kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
hyperframes
86.4kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
ruflo
82.0k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
