Skip to main content

Getting Started

This guide walks you through connecting the WhatCode iOS app to your machine in a few minutes.

Requirements​

1. Install OpenCode​

Install OpenCode by following the instructions in the OpenCode documentation.

2. Start the daemon​

Run the following command in your terminal:

npx @whatcode-ai/whatcode start

The command starts the OpenCode service, or reuses it if it is already running, and then prints a pairing QR code in the terminal. You will scan this code with the app in the next step. The local network URL of the server is printed alongside it, and is only needed if you choose to connect manually.

3. Connect the iOS app​

Open the WhatCode app on your device. On first launch you'll be taken through a short setup flow:

  1. Tap Get Started and step through the intro screens.
  2. On the last step, tap Scan QR and point your camera at the QR code in your terminal.
  3. The app connects to your machine automatically.

If your camera isn't available, tap Continue without QR and enter the URL manually.

4. You're connected​

You should now see your OpenCode projects listed in the app. Tap any project to open its sessions, send messages, and receive notifications when the agent finishes a task.

Extra: Remote access with Tailscale

To connect from outside your local network, start the daemon with the --tailscale flag:

npx @whatcode-ai/whatcode start --tailscale

The QR code then includes your Tailscale URL, so the app can reach your machine from anywhere. See the Daemon page for more details.