Sampler
An open source visual annotation tool for building iOS apps with coding agents. Add comments directly to your app's interface, providing rich context to your coding agent of choice.
Download on GitHub
You can work with Sampler in a variety of ways. Copying annotations to your Mac via the clipboard, using the Claude Code skill, or making direct edits via the simulator and a local MCP.
Annotate in the simulator or on device, then copy or share feedback straight into any AI coding tool. No MCP or local server required.
Add the Sampler Swift package to your app target.
Call
Sampler.startOnce()after your root SwiftUI view appears.Run a build and tap the floating Sampler widget.
Either tap or drag to create a POI on your app.
Press the copy to clipboard button.
Paste into your coding agent of choice.
Let Claude Code install and wire Sampler into your iOS app for you - one skill, one command.
In your terminal, run:
npx skills add gabrieltmitchell/samplerOpen your iOS app in Claude Code.
Run
/sampler.The skill detects your app structure and adds the package.
Run the app in Debug and start annotating.
Send annotations from the iOS Simulator straight to your coding agent over a local MCP server - no copy/paste needed.
Install Sampler in your app (package +
Sampler.startOnce()/Sampler.start(in:))From your app project root, run:
npx -y sampler-mcp@latest initReload MCP servers in Cursor (Settings → MCP), or restart Cursor.
Run the app in the iOS Simulator and annotate the screen.
Tap Send to Agent in the Sampler toolbar. In Cursor, annotations can auto-dispatch a local agent run; the widget shows progress until the fix is resolved and will automatically re-build the app.