Vibe Annotations

Visual feedback tool for web development. Annotate elements on your pages, make design tweaks, and share with AI coding agents or teammates.

https://github.com/user-attachments/assets/6946733e-eea6-4d38-8386-c493f90d36f4

For more features explanations (like collaboration via file sharing, AI-assisted annotations, watch mode...) please read the docs.

Get started

1. Install the browser extension

2. Run the setup wizard

npx vibe-annotations-server init

One interactive command installs the global server, starts it in the background, and configures your AI coding agent (Claude Code, Cursor, Windsurf, Codex, OpenClaw, VS Code). For Claude Code it also offers the Vibe Annotations mod: new annotations show above the prompt and go to Claude in one press. Prefer manual? See Installation.

Using only Claude Code? The mod alone is enough, since it starts the server for you:

claude plugin install vibe-annotations --marketplace RaphaelRegnier/vibe-annotations

3. Open a localhost page, click Annotate. You can annotate multiple pages on your web app. Then:

A (recommended) - Use the MCP to implement your Annotations

B - Copy to your clipboard: View all > Copy and send to your AI coding agent.

Related MCP server: @designjs/mcp-server

Documentation

Full docs at vibe-annotations.com/docs — including installation, MCP setup, workflows, architecture, and troubleshooting.

Contributing

See CONTRIBUTING.md. PRs welcome.

License

PolyForm Shield 1.0.0 — see LICENSE and NOTICE.