Skip to content
Docs0.9GitHubInstall

StartConnect your phone or browser

Connect your phone or browser

Publish the app port on your tailnet, then pair a browser and an iPhone, each with a one-time code.

This tutorial puts your agents on a second screen: a browser first, then an iPhone. You publish one port privately and pair each device once.

You need the worker running and Tailscale on both the computer and the device, in the same tailnetTailnet. A private network between your own devices, made with Tailscale.. The examples use workstation.example.ts.net; put your computer’s tailnet name in its place. For a reverse proxy of your own, see Publish the apps privately.

A conversation with an agent that reviewed four pull requests and answered with a table of verdictsA conversation with an agent that reviewed four pull requests and answered with a table of verdicts

The app endpointApp endpoint. The private address your devices connect to. It listens on loopback until you publish it.App endpoint. The private address your devices connect to. It listens on loopback until you publish it. listens on 127.0.0.1:8743. Tell Vendetta the address your devices will use for it:

~/.config/vendetta/config.toml
[plugins.app]
public_url = "wss://workstation.example.ts.net:8743/v1"

Restart the worker so the app plugin starts with it:

vendetta notify stop && vendetta notify start
vendetta notify status   # plugins: messaging=running

Have Tailscale serve the port over HTTPS inside your tailnet:

tailscale serve --bg --https=8743 http://127.0.0.1:8743

Nothing outside your tailnet reaches it. Tailscale provides the certificate; the apps accept only wss:// addresses.

On the computer, ask for a pairing code. It prints a QR code (when qrencode is installed), the server, and a code:

$ vendetta app pair
Server: wss://workstation.example.ts.net:8743/v1
Pairing code: ABCDE-FGHJK-LMNPQ-RSTUV
Scan this in the Vendetta app within 10 minutes. The code works once.

On the device, open https://workstation.example.ts.net:8743/. The page says Pair with Vendetta. Type the code into Pairing code or link and press Pair. The server is the address you opened, so there is nothing else to fill in.

Your agents appear as chats, grouped by project. Open one and send it a message; the same prompt shows in the agent’s terminal.

Install the app from the TestFlight link on vendetta.sh/install.

A code works once, so run vendetta app pair again. In the app, tap Scan pairing code and point the phone at the QR code in your terminal.

Without a QR code, use Or enter it: type the code into Pairing code or link, open Server, enter workstation.example.ts.net:8743, and tap Pair.

A phone that isn’t an iPhone uses the web client in its browser, paired as above. Push notifications on the iPhone take more setup: see The iPhone app.

Every device starts in Simple: your chats by project and what you need to talk to them. For the overview, history, schedules, tasks, models, and managers, open Settings and turn on Advanced. The setting belongs to that device. See Simple and Advanced.

When an agent asks a question, its chat shows a card with the options; tap one. When Claude Code asks permission for a tool call, the card shows the command or the edit with Allow once and Deny.

An approval card with the command the agent wants to run, the reason it needs approval, and Allow once and Deny buttonsAn approval card with the command the agent wants to run, the reason it needs approval, and Allow once and Deny buttons

If the device can’t reach the computer, a bar says Reconnecting… and then Offline · tap to retry. A message you send then reads Offline. Not sent. with Retry; nothing is sent again by itself.

vendetta app devices   # every paired device
vendetta app revoke ID # disconnect one

Revoke a lost device at once. A paired device of yours can do what you can do in the apps, including adding and removing people.

Next: Run several agents and answer from your phone.