README

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

bash
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:

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

 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.