Patchrooms for Windsurf
Add visual feedback to your Windsurf app
Windsurf is an agentic IDE where Cascade edits your codebase and you preview the running app. Patchrooms layers element-anchored feedback on top, so every comment turns into agent-ready context.
Try the live demoWhy Windsurf teams need visual feedback
- Windsurf’s agent moves fast, so imprecise feedback becomes the bottleneck.
- Testers report bugs in prose; the agent needs a selector to act confidently.
- Patchrooms turns each report into element-anchored, agent-ready context.
- The result is fewer regressions and faster review cycles.
How Patchrooms works with Windsurf
-
Embed Patchrooms on your preview build
Add the script to the app you review while Windsurf edits source.
-
Collect pinpoint feedback
Reviewers click elements to comment; Patchrooms captures selector and context.
-
Feed it to Windsurf
Paste the Markdown export into Cascade so it edits the right component.
What your agent receives
Each pinpoint comment exports as clean Markdown with the element selector, the page and viewport, and the console state alongside the ask.
## Feedback: Checkout submit button
Element: button[data-patchroom-id="checkout-submit"]
Page: /checkout · 1440×900 · Chrome 126
Issue
Stays clickable while required fields are empty and
submits an invalid form.
Expected
Disabled until the form is valid: reduced opacity
+ aria-disabled="true".
Console
POST /api/order 422 (validation_failed) Add it in one prompt
Paste a script tagAdd in one prompt
Ask Windsurf to wire Patchrooms in for you, paste this prompt:
Add the Patchrooms review widget. Insert this script tag into the main HTML template before the closing </body> tag, exactly as written:
…then give it the snippet below. It loads on the live preview and turns on artifact-review mode: pinpoint comments anchored to the elements your reviewers click.
<script src="https://room.patchrooms.com/v1/patchrooms.js"
data-project-key="pr_xxx"
data-source="windsurf"
data-mode="artifact-review"></script> Or try it locally: no account, no key, no server
Reviewing a Windsurf artifact on your own machine? Run Patchrooms in local mode: no account, no project key, zero network calls. Pinpoint comments stay in your browser and export to Markdown you paste straight back into Windsurf.
<script src="https://room.patchrooms.com/v1/patchrooms.js"></script>
<script>
Patchrooms.init({ storage: 'local', mode: 'artifact-review' });
</script> Review workflow
Share the preview link with your team or client. Anyone clicks an element, types a comment or records a voice note (Patchrooms auto-transcribes it to clean text), and captures the selector, a screenshot, and the page context. Every comment carries a status (new, triaged, in-progress, closed) so nothing falls through the cracks. See the full UI review workflow.
Export feedback to your AI agent
Each report exports as clean Markdown with the element selector, a screenshot reference, and the artifact goal and constraints. Paste it straight into Windsurf and the agent fixes the exact issue: this is the heart of AI artifact review. The Patchrooms MCP server lets agents read reports directly (list_reports / get_report) and triage them (set_status). Available now; extended MCP tools (create_room, issue creation) are planned, and a @patchrooms/react package is coming for tighter React integration.
FAQ
- Does Patchrooms work alongside Windsurf?
- Yes. Windsurf edits your code; Patchrooms collects feedback on the running app and exports it as context you paste back into Cascade.