explaingit

tomreinert/claude-annotate

Analysis updated 2026-05-18

24JavaScriptAudience · developerComplexity · 2/5Setup · easy

TLDR

Claude Annotate lets you draw feedback directly on a running web page in a Playwright browser and sends the annotated screenshot to Claude Code.

Mindmap

mindmap
  root((Claude Annotate))
    What it does
      Draw on live frontend
      Sends screenshot to Claude
      Iterative feedback loop
    Tech stack
      JavaScript
      Claude Code plugin
      Playwright MCP
    Use cases
      Visual bug reports
      Design tweak requests
      Local frontend review
    Audience
      Developers
    Setup
      Install Playwright MCP
      Install plugin from marketplace

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Draw an arrow at a broken button and send it to Claude instead of describing the bug in text.

USE CASE 2

Mark up a design change directly on your running localhost app and have Claude implement it.

USE CASE 3

Run repeated rounds of visual feedback on a frontend without leaving Claude Code.

What is it built with?

JavaScriptClaude CodePlaywrightMCP

How does it compare?

tomreinert/claude-annotateaaaddress1/vibe-readingamirhosseinjpl/jpl-sub-processor
Stars242424
LanguageJavaScriptJavaScriptJavaScript
Setup difficultyeasymoderatemoderate
Complexity2/52/53/5
Audiencedeveloperresearcherops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires the Playwright MCP connected to Claude Code and an experimental plugin channel flag, tested mainly on a local app at port 3000.

In plain English

Claude Annotate is a plugin for Claude Code, Anthropic's command line coding assistant, that lets you draw directly on a running web page and send that visual feedback straight into your conversation with Claude. Instead of writing out a description of a bug or a design tweak in words, you can point at the exact spot on the screen and mark it up. The plugin works by opening your local web app inside a Playwright controlled browser, Playwright being a tool for automating and testing websites. Once that browser window is open, an annotation toolbar appears on top of your app. You draw shapes, arrows, or notes over whatever you want changed, then press Send. Claude receives a screenshot of your app with your annotations included and uses that as context to make the code changes you asked for. You can keep drawing and sending as many rounds of feedback as you like, and simply say stop reviewing when you are finished. To use it, you first need the Playwright MCP tool connected to Claude Code, since that is what lets Claude control a real browser. After that, you install the Claude Annotate plugin itself from its marketplace listing, and launch Claude Code with a special flag that turns on an experimental plugin channel. From there, typing the command slash annotate starts the whole flow. Everything runs locally on your own machine, nothing is sent to an outside cloud service beyond your normal conversation with Claude. The author describes it as a work in progress that they are still actively testing, and notes it has mainly been tried against a local app running on port 3000, so results in other setups may vary. They are actively looking for feedback and bug reports from anyone who tries it. This tool has 24 stars and is aimed at developers already using Claude Code who want a faster, more visual way to give feedback on frontend changes instead of typing detailed descriptions.

Copy-paste prompts

Prompt 1
Help me install the Playwright MCP and the Claude Annotate plugin for Claude Code.
Prompt 2
Launch Claude Code with the annotate plugin and start reviewing my localhost:3000 app.
Prompt 3
Explain what the --dangerously-load-development-channels flag does for Claude Annotate.
Prompt 4
Show me how to keep sending annotated screenshots to Claude until I say stop reviewing.

Frequently asked questions

What is claude-annotate?

Claude Annotate lets you draw feedback directly on a running web page in a Playwright browser and sends the annotated screenshot to Claude Code.

What language is claude-annotate written in?

Mainly JavaScript. The stack also includes JavaScript, Claude Code, Playwright.

How hard is claude-annotate to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is claude-annotate for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.