Quickstart

Five minutes from zero to controlling Claude Code from your phone.

1. Install the extension

VSRelay ships as a VS Code / Cursor extension.

Once VSRelay v0.3.0 lands on the VS Code Marketplace + Open VSX, install directly from your editor’s extension panel. Until then, follow the install steps in your invite email.

After install, open the VSRelay sidebar in Cursor / VS Code. You should see a setup card.

2. Pair your phone

On your phone, open https://app.vsrelay.dev (works on iOS Safari, Android Chrome, anything modern).
Sign in with the same email you used to install the extension.
Scan the QR code in the extension sidebar. The phone and the extension are now paired through the trusted relay at relay.vsrelay.dev.

VSRelay supports three trust tiers — the default uses our cloud relay (TLS in transit, room-validated). If you want LAN-only or self-hosted relay, see Core Concepts → Trust tiers.

3. Send your first prompt

In the PWA, tap a session (or New Session to create one). Type:


Show me the README

Watch Cursor on your laptop start typing the response.

4. Approve a tool permission

Ask Claude Code to do something that needs permission — e.g.:


Add a comment at the top of README.md

When Claude Code requests permission to write a file, the prompt surfaces on your phone. Tap Approve (or Reject). The action runs on your laptop the moment you approve.

5. If something breaks

If Cursor auto-updated Claude Code and prompts stopped flowing, run:


npx @vsrelay/doctor repair

Or, on your phone, tap Apply patches in Cursor in the recovery banner — the extension applies the patches with one-click consent.

Full recovery guide: Support .

What’s next

Core Concepts — what’s a relay, what’s a plane, what’s a capability.
Native Integration — building a Swift / Kotlin client? Read the protocol contract.
Changelog — recent releases.