Skip to content
New: answer your agents from your phoneLearn more

Run Codex from your phone with ket.

Pair your iPhone or iPad with ket on your Mac, then start Codex in its own worktree, approve its commands and edits, and merge the result without going back to your desk.

What you can do with Codex from your phone

  • Start a Codex task in a new worktree on your Mac.
  • Read each session as a conversation and reply.
  • Approve or deny Codex's commands and file edits.
  • 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

  1. On your Mac, open ket and turn on Settings → Devices.
  2. Scan the QR code with the ket app on your iPhone or iPad. The code works once and lasts three minutes.
  3. 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 Codex 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 Codex task from your phone

Start new work in the app, pick a project and Codex as the agent, and write the prompt. ket creates a worktree and a branch for the task on your Mac and starts the Codex CLI 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 and 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.

Approve Codex's commands and edits

If Codex asks to run a command, apply a patch or widen its permissions, the prompt appears on your phone. Allow once and Deny work for all three, and ket offers Always for file edits. ket presses the key in Codex's terminal only if that prompt is still on screen, so a stale tap can't answer the wrong thing.

If Codex asks you a question instead, ket marks the session as waiting. Take control of the terminal from your phone and type the answer. 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 Codex 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 the ChatGPT app

OpenAI's route to Codex on a phone goes through the ChatGPT app and the ChatGPT desktop app. ket's app works with the Codex CLI itself:

  • No second desktop app. The ChatGPT app controls Codex through the ChatGPT desktop app, which you set up and keep running. ket runs the Codex CLI you already use, signed in with ChatGPT or an API key.
  • Every agent in one app. Codex, Claude Code, OpenCode and the other agents you run in ket share one list on your phone, sorted by project.
  • A worktree for every task. A Codex 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.
  • No account linking. OpenAI notes that its phone access depends on rollout and a workspace admin may need to allow it. ket pairs your phone with one QR scan and an approval on your Mac.
  • No server in the middle. 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.

The ChatGPT app reaches your computer from any network with nothing to set up, and can run tasks in Codex cloud. 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 Codex session. ket installs Codex hooks so it can see prompts, and those 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.
  • The Codex CLI installed on the Mac, signed in the way you already use it. ket answers prompts with Codex's default keys, so if you've rebound them in ~/.codex/config.toml, answer in the terminal.

Until ket's first release, you build the Mac app from source. More about the ket phone app.