Skip to main content

Introduction

WhatCode is a mobile companion for OpenCode, the open-source AI coding agent that runs on your machine. It lets you monitor and interact with your coding sessions from your iPhone and get notified the moment an agent finishes its work.

What's in here​

This documentation covers three things:

  • WhatCode - the iOS app itself: what it does, how to connect it to your machine, and how to navigate your projects and sessions.
  • OpenCode - how to install and run the OpenCode server that WhatCode connects to.
  • Daemon - the lightweight server that sits between the iOS app and OpenCode, enabling push notifications, better project sorting, and optional remote access via Tailscale.

Quick overview​

  1. Install OpenCode on your machine.
  2. Run the WhatCode daemon (npx @whatcode-ai/sdk) - it starts OpenCode and exposes it on your local network.
  3. Open the iOS app, scan the QR code shown in your terminal, and you're connected.
  4. Start a coding session. When the agent finishes, your phone buzzes.