Run Claude Code from your phone with ket.
Pair your iPhone or iPad with ket on your Mac, then start Claude Code in its own worktree, answer its prompts, questions and plans, and merge the result without going back to your desk.
What you can do with Claude Code from your phone
- Start a Claude Code task in a new worktree on your Mac.
- Read each session as a conversation and reply, including messages still queued for Claude.
- Answer permission prompts with Allow once, Always or Deny.
- Answer Claude's questions and approve or send back its plans.
- Take over the live terminal, 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 Claude Code 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 or an Always answer.
Start a Claude Code task from your phone
Start new work in the app, pick a project and Claude Code as the agent, and write the prompt. ket creates a worktree and a branch for the task on your Mac and starts Claude Code 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, along with anything you've queued for Claude. 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 permission prompts, questions and plans
Claude Code's permission prompts appear on your phone with Allow once, Always and Deny. ket offers Always for shell commands, file edits and web fetches. ket presses the key in Claude's terminal only if that prompt is still on screen, so a stale tap can't answer the wrong thing.
Claude's questions arrive with their options, and plans arrive ready to approve or send back. 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 Claude 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 Claude Code's Remote Control
Anthropic's Remote Control links the Claude app to one Claude Code session. ket's app covers more ground:
- Every agent in one app. Claude Code, Codex, OpenCode and the other agents you run in ket share one list on your phone, sorted by project, instead of one vendor app per agent.
- Every session at once. Remote Control connects one session per
claudeprocess unless you run it as a server. ket shows every worktree on your Mac, and the Needs you tab gathers the waiting ones. - A worktree for every task. A 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.
- Any way you sign in. Remote Control needs a claude.ai plan and doesn't work with API keys, Amazon Bedrock or other cloud providers. ket runs Claude Code as you already run it, so any sign-in works.
- No server in the middle. Remote Control keeps the transcript on Anthropic's servers. ket's phone app talks to your Mac over your own Wi-Fi or Tailscale, encrypted end to end.
- Safer taps. ket answers a prompt only if it's still on screen, asks for Face ID before a merge or an Always answer, and with Jev turned on rates each prompt's risk.
Remote Control reaches your computer from any network with nothing to set up. Away from your Mac's Wi-Fi, ket's phone app needs Tailscale on the phone and the Mac.
What you need
- ket on your Mac, running the Claude Code session. ket's hooks only see 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.
- Claude Code installed on the Mac, signed in the way you already use it.
Until ket's first release, you build the Mac app from source. More about the ket phone app.
Related guides
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.
Run OpenCode from your phone with ket.
Pair with ket, start OpenCode in a worktree, answer its permission prompts, and merge from your phone.
Claude Code hooks, with a real example.
How to add a hook, the events that matter, and a real one that trims command output.