# Patchrooms Docs

> Patchrooms is a visual feedback layer for AI-built apps. These docs cover installing the feedback widget, collecting element-anchored reports, exporting agent-ready Markdown, and connecting coding agents through MCP and REST.

## For agents (start here if you are an AI coding agent)

Pages under "Start here" are the human, click-through path. Pages under "For agents" are written for you to execute, and provision/operate Patchrooms without human prose.

- [For agents — overview](https://docs.patchrooms.com/for-agents/): the tree to follow — set up, then run the loop
- [Agent self-setup](https://docs.patchrooms.com/for-agents/setup/): take a setup token, configure widget/channels/matching over REST, mint a narrow feedback key, leave a patchrooms-feedback skill, revoke the setup token
- [Workflow modes](https://docs.patchrooms.com/for-agents/workflows/): review / test pass / timed auto-fix loop / propose / spec-writing / accumulate-and-ask
- [Writing skills](https://docs.patchrooms.com/for-agents/meta-skills/): SKILL.md format + vetted skill sources (with link rationale)

## Start here (human path)

- [Quickstart](https://docs.patchrooms.com/start/quickstart/): project → loader script → first report → export
- [Install the widget](https://docs.patchrooms.com/start/install/): one-line loader vs programmatic Patchrooms.init, all data-attributes, local mode
- [Get a project key](https://docs.patchrooms.com/start/project-key/): pr_ ingest keys vs pr_sk_ API keys
- [Your first room](https://docs.patchrooms.com/start/first-room/): rooms group feedback per artifact

## Reference

- [Widget API](https://docs.patchrooms.com/reference/widget/): init options, setChannel, setAttribute, report, local mode export
- [MCP server](https://docs.patchrooms.com/reference/mcp/): connect Claude Code, Cursor, or any MCP client; list_reports, get_report (inline screenshots), set_status
- [REST API](https://docs.patchrooms.com/reference/rest-api/): /api/v1 with pr_sk_ bearer keys, webhooks

## Concepts

- [Projects](https://docs.patchrooms.com/concepts/projects/)
- [Channels](https://docs.patchrooms.com/concepts/channels/): dynamic routing of reports (bugs / ideas / design)
- [Reports](https://docs.patchrooms.com/concepts/reports/): blocks — text, screenshot, voice (auto-transcribed), selection
- [Exports](https://docs.patchrooms.com/concepts/exports/): agent-ready Markdown, ZIP, Copy as prompt

## Integrations

Per-tool guides: [Lovable](https://docs.patchrooms.com/integrations/lovable/), [Bolt](https://docs.patchrooms.com/integrations/bolt/), [v0](https://docs.patchrooms.com/integrations/v0/), [Replit Agent](https://docs.patchrooms.com/integrations/replit-agent/), [Cursor](https://docs.patchrooms.com/integrations/cursor/), [Claude Code](https://docs.patchrooms.com/integrations/claude-code/), [Codex](https://docs.patchrooms.com/integrations/codex/), [Windsurf](https://docs.patchrooms.com/integrations/windsurf/), [OpenCode](https://docs.patchrooms.com/integrations/opencode/), [Cline](https://docs.patchrooms.com/integrations/cline/)

## Other

- [Privacy & data](https://docs.patchrooms.com/privacy/)
- [Troubleshooting](https://docs.patchrooms.com/troubleshooting/): launcher not appearing (placeholder pr_xxx key fails silently — check the console), 401 invalid_project_key_or_origin (allowed-origins gating)