Run OpenCode from your phone with ket.
Pair your iPhone or iPad with ket on your Mac, then start OpenCode in its own worktree, answer its permission prompts, and merge the result without going back to your desk.
What you can do with OpenCode from your phone
- Start an OpenCode task in a new worktree on your Mac, with whichever model you use in OpenCode.
- Read each session as a conversation and reply.
- Answer permission prompts with Allow once or Deny.
- Take over the live terminal for anything else, or interrupt or stop the session.
- Read the changes file by file and merge them into the base branch.
Pair your phone with ket
- On your Mac, open ket and turn on Settings → Devices.
- Scan the QR code with the ket app on your iPhone or iPad. The code works once and lasts three minutes.
- Check that both screens show the same six digits, then approve the device on the Mac.
Your phone talks to the Mac over your Wi-Fi, or over your own Tailscale away from home, encrypted end to end. No ket server sits in between, and your repositories, credentials and OpenCode itself stay on the Mac. Revoke a device in Settings and ket cuts it off at once. Face ID, Touch ID or a PIN locks the app, and the app asks again before a merge.
Start an OpenCode task from your phone
Start new work in the app, pick a project and OpenCode as the agent, and write the prompt. ket creates a worktree and a branch for the task on your Mac and starts OpenCode in it, so the task can't touch your main checkout or any other agent's work. Keep ket open on the Mac for this.
Follow every session
The app lists your worktrees grouped by project, in the same order as ket's sidebar on the Mac, with Running, Waiting and Idle filters. The Needs you tab collects every session waiting on an answer.
Open a session to read it as a conversation; ket reads it from OpenCode's own session store. Reply in your own words or with one tap, such as Continue or Run the tests. Take control of the terminal from the phone when you need it.
Answer OpenCode's permission prompts
ket installs a small OpenCode plugin that reports each permission request, so the prompt appears on your phone with Allow once and Deny. ket presses the key in OpenCode's terminal only if that prompt is still on screen, so a stale tap can't answer the wrong thing. ket leaves out Always for OpenCode, because choosing it takes several keystrokes on a button that can move.
If OpenCode asks you a question, ket marks the session as waiting. Take control of the terminal from your phone and answer there. Prompts from OpenCode's subagents stay in the terminal too. Turn on Jev and each permission prompt also shows a low, medium or high risk score. Jev never answers for you.
Review and merge from your phone
After OpenCode finishes, read the diff file by file. If it's right, merge it into the base branch in your primary checkout on the Mac; ket never switches that checkout's branch. Merging needs ket open on the Mac.
Why use ket instead of OpenCode's web UI
OpenCode has no phone app. Its built-in route is opencode web, a browser interface you open to your network. ket's app needs less setup and does more:
- Nothing to expose. To reach
opencode webfrom a phone, you make the server listen on your network and protect it with a password over plain HTTP. ket pairs your phone with one QR scan and an approval on your Mac, and encrypts the connection end to end. - Every agent in one app. OpenCode, Claude Code, Codex and the other agents you run in ket share one list on your phone, sorted by project.
- A worktree for every task. An OpenCode task you start from your phone gets its own branch and folder, so it can't collide with your other work. When it's done, you merge it from the phone.
- Every waiting prompt in one place. The Needs you tab gathers every session waiting on a permission prompt or a question, across projects and agents.
- Safer taps. ket answers a prompt only if it's still on screen, asks for Face ID before a merge, and with Jev turned on rates each prompt's risk.
What you need
- ket on your Mac, running the OpenCode session. ket's plugin only reports sessions that ket started.
- Your iPhone or iPad on the same Wi-Fi as the Mac. Away from home, Tailscale on the phone and the Mac, signed in to the same account.
- OpenCode installed on the Mac with your providers set up. ket works with OpenCode 1 and 2.
Until ket's first release, you build the Mac app from source. More about the ket phone app.
Related guides
Run local models with Ollama and OpenCode.
Run Ollama local models as a coding agent in OpenCode, and hand the hard tasks to a cloud model.
Run Claude Code from your phone with ket.
Pair with ket, start Claude Code in a worktree, answer its prompts, questions and plans, and merge from your phone.
Run Codex from your phone with ket.
Pair with ket, start Codex in a worktree, approve its commands and edits, and merge from your phone.