Vibe Annotations

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

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). Prefer manual? See Installation.

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.

Demos

Annotate, copy/paste to your AI coding agent:

https://github.com/user-attachments/assets/ebcf5a17-423c-459c-b5d5-2876b671c5a7

Make persisting direct design tweaks:

https://github.com/user-attachments/assets/66bc31ed-86d6-4fc0-ab69-7e4ed8c7c27a

Use the MCP server to share your annotations, any websites, multiple pages:

https://github.com/user-attachments/assets/2dc8e03c-a760-4e31-afac-537200387788

Annotate with a browser-capable AI coding agent:

https://github.com/user-attachments/assets/5839d3df-f3e6-4b05-b58a-fdd619487aa4

Collaborate with teammates using export / import features:

https://github.com/user-attachments/assets/58de5fad-d7fa-490d-849f-d25771758067

Use watch mode, never leave your website:

https://github.com/user-attachments/assets/c74d3a43-61c4-4542-ab43-c559cd6e44bf

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.