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

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.