OpenCode remote control

Install and pair.

Connect an installable PWA to a local OpenCode session. Pairing is local, encrypted, and does not require an account.

Requirements

OpenCode installed on the computer running the session.
Node.js 22 or newer for the one-off npx command.
A browser on the device to pair. HTTPS is required outside localhost.

Hosted service

Pair a device

Install the OpenCode plugin.

opencode plugin opencode-remotty --global --force

Create a device invite.
```
npx --yes --package opencode-remotty@latest remotty pair
```
The output contains a sensitive ten-minute token, a pairing URL, and a QR code. Do not share, paste into tickets, or publish any of it.
Open the printed pairing URL, scan its QR code, or paste the token on the pairing page.
Quit the running OpenCode process, then restart it so the installed plugin starts with the paired relay configuration.
```
opencode --continue
```
Verify the connection by opening the PWA and checking that the local OpenCode session appears.

Custom broker or PWA

Set both endpoints explicitly

Use the CLI's supported --broker and --app options when the broker or browser app is not hosted by remotty.

npx --yes --package opencode-remotty@latest remotty pair --broker wss://broker.example/ws --app https://app.example

Use ws:// and http:// only for loopback local development.

Commands

npx --yes --package opencode-remotty@latest remotty pair
npx --yes --package opencode-remotty@latest remotty invite
npx --yes --package opencode-remotty@latest remotty devices
npx --yes --package opencode-remotty@latest remotty revoke <device-id>
npx --yes --package opencode-remotty@latest remotty remove <device-id>
npx --yes --package opencode-remotty@latest remotty remove --revoked
npx --yes --package opencode-remotty@latest remotty status

For an upgrade, reinstall the plugin with opencode plugin opencode-remotty --global --force, quit OpenCode, then run opencode --continue.

Configuration and troubleshooting

The CLI stores relay authority keys, device records, invitation hashes, and revocation state in ~/.config/remotty/config.json, or $XDG_CONFIG_HOME/remotty/config.json when XDG_CONFIG_HOME is set. It creates the file with mode 0600.

Invite expired: run npx --yes --package opencode-remotty@latest remotty invite and pair again.
Wrong hosted endpoint: create a new invite with the correct --broker and --app values.
Plugin does not appear: rerun the OpenCode plugin install command, quit OpenCode, then run opencode --continue.
Device access should end: use npx --yes --package opencode-remotty@latest remotty devices to find its ID, then npx --yes --package opencode-remotty@latest remotty revoke <device-id>.