Vercel integration

Preview deployments, right in Capy

Vercel preview URLs are surfaced directly in the Capy dashboard. Review the diff and the live deployment side by side. Zero configuration required.

Get started Read the docs

Preview at every step

See your app live at every stage, from coding to merged PR.

Automatic detection

Capy scans PR discussion comments for URLs with preview in the hostname and surfaces them in the PR toolbar. No webhooks, no config, works out of the box.

In-dashboard previews

Click Open preview link in the PR view to see the live deployment. Works for any Vercel project connected to GitHub. Review code and the running app side by side.

In-VM previews

For previewing during a task before a PR exists, use the previews hook in .capy/settings.json. Agents can validate UI changes in real time from the task interface.

Full workflow

Configure in-VM previews so the agent validates while coding. Agent opens a PR when done, Vercel deploys a preview from the branch, and you review it from Capy's PR view.

How it works

No setup needed, Capy detects Vercel previews automatically.

Step 1

Connect

Link your Vercel project to GitHub. When Vercel deploys previews on PRs, Capy detects them automatically.

Step 2

Code

An agent works on your task and opens a PR. Vercel triggers a preview deployment from the branch.

Step 3

Preview

Capy detects the preview URL from the PR discussion. Click Open preview link in the PR view to see the live deployment.

FAQ

Common questions about the Vercel integration.

Do I need to configure anything?+

No. If you have Vercel connected to your GitHub repo, Capy detects preview URLs from PR comments automatically. There's nothing to install or configure.

What about in-VM previews?+

For previewing during a task (before a PR exists), add a previews hook to .capy/settings.json with the port numbers your app runs on. Agents can then validate changes in real time.

Does Capy trigger Vercel deployments?+

No. Capy detects preview URLs that Vercel posts on PR comments but doesn't trigger deployments directly. Your existing Vercel setup handles the deploy pipeline.

Can I see multiple preview URLs?+

Currently, Capy surfaces the first matching preview URL from PR comments. For in-VM previews, you can configure multiple ports for different services.