All docs

Øphio with Claude Code and Codex

Your agents keep working on your own Linux computer. Øphio brings what they need from you to your Android phone.

What Øphio does

Øphio is an Android app paired with a companion program on your computer. Claude Code and Codex run natively on that computer, signed in with your own accounts. From the phone you start a task, answer the questions it asks, approve what it wants to do, send it new direction and review the result when it finishes.

It isn’t an autonomous agent and it isn’t an agent harness. Your agents still do the work; Øphio is how you direct and supervise them when you’re away from your desk.

Øphio works with Anthropic’s Claude Code and OpenAI’s Codex CLI, so you can use one, the other or both. For each task you choose Claude Code or Codex, a model and an effort level; the choices come from the versions installed on your computer. Setup can install either agent for you. Øphio doesn’t include any provider access or usage: your agents use your own subscriptions or keys, and whatever you give an agent goes to its provider as usual.

Codex needs version 0.153.2 or later. While a Codex task is running you can use Steer now to send it a correction it reads as it works. Claude Code takes new messages too, but doesn’t confirm whether they change its current turn, so Steer now isn’t offered for it. Hermes and OpenClaw can run in Øphio’s terminal, without structured approvals or receipts.

Approvals

Every task has a permission policy that decides how much it asks first. With Ask for approval, each request comes to your phone as a card, and you allow or decline it there instead of walking back to the computer. The card starts with the agent’s one-line description of what it wants to do, then a line Øphio works out from the exact request, such as “Changes files in src, makes a git commit, connects to github.com”. Deleting, pushing, sudo, installing and downloaded scripts are highlighted, and the card says so when Øphio can’t tell what a request does.

New coding tasks in Work mode skip permission prompts by default, so choose Ask for approval when you want to see each action. Ask and Plan modes are read-only; when an agent in one of them needs to change files, it asks, and one tap switches the task to Work. Agents & task permissions explains each policy.

Notifications and task controls

When a task needs you, for example with a question or an approval, your phone shows an Android notification. Settings → Notifications sets each kind of notification to Alert, Silent or Off. By default only things that wait for you make a sound; a finished task waits in the app unless you turn that kind on, or ring the bell on the task to hear when that one is done. With Notify me when Øphio is closed turned on, notifications arrive while the app is closed too. They come over the direct connection to your computer, and ones you missed can arrive when the phone reconnects.

While a task runs, you can answer its questions, steer it, queue the next piece of work behind it with Next up, or stop it; Stop is never queued behind anything. Each finished task leaves a receipt you can review. See Notifications and Messages, feedback & results.

Connection

Your phone connects straight to your computer, either over Tailscale or over a local network you have explicitly chosen to trust. There is no Øphio relay server, no push service in between and no Øphio account to sign up for. The connection is encrypted and pinned to your computer when you pair, by running ophio pair and matching six-digit codes.

Nothing you do passes through an Øphio server; your agents talk to their own providers as they always do. The computer has to be switched on and reachable for the phone to work with it. Pair your devices walks through it.

More computers and tools

One phone can pair with several Linux computers. The computer’s name at the top of the app opens a menu listing every paired computer with its status. With two or more paired, All computers shows Tasks, Needs you and To-Do from every computer at once, and an answer, Allow, a ticked item or Stop goes to the right computer from that list. Each computer still keeps its own pairing, projects and task history, and chats, desktop control, the Library and new tasks work on one computer at a time. On each project, one coding task changes files at a time. Read-only tasks can run beside it, and further work waits its turn. Øphio doesn’t create parallel git worktrees or run several writers on one repository at once.

Take a pull request from draft to merge on GitHub, and link issues to tasks (GitHub work). Watch and control your computer’s desktop when something looks wrong (Desktop control), mark up screenshots and video to point at a problem, or open a real terminal. You can also send files, edit your agents’ instruction files in the Library, and control tasks through your own Telegram or Discord bot.

Compared with other tools

Several tools put your coding agents on your phone. They differ in which agents they reach, which phones they run on and how the phone gets to your computer, so the right one depends on how you work.

Claude Code Remote Control

Remote Control is built into Claude Code. It works from the Claude app on iPhone and Android or from a browser, needs a Pro, Max, Ultra, Team or Enterprise plan rather than an API key, and its traffic travels through the Anthropic API. If Claude Code is the only agent you use and you have an iPhone, start there: there’s nothing extra to install.

Øphio works with Claude Code and Codex in the same app, and your phone talks to your computer with no service in between. It also gives you your computer’s desktop, a terminal, file transfers and GitHub pull requests on the phone.

Happy

Happy has iPhone, Android and web apps and works with several agents, including Claude Code and Codex. Your devices sync through Happy’s relay server, end-to-end encrypted. If you use an iPhone or a Mac, Happy is the better fit. Øphio has no relay of any kind: your phone only ever talks to your own computer.

Paseo

Paseo has desktop and mobile apps. For remote access you can use its hosted relay, end-to-end encrypted, or your own tunnel, and it can run each agent in its own git worktree. If you want several agents working on one repository in parallel, Paseo suits that better. Øphio keeps one writer per project and centres on approvals: each request is one action to allow or decline on your phone, and each finished task leaves a receipt.

A terminal over SSH

A terminal app on your phone, connected over SSH to a tmux session, reaches any agent you can run. You read raw terminal output on a small screen, though, and you find out a prompt is waiting only when you look. Øphio shows each task’s questions, approvals and results as they come, sends a notification when it needs you, and presents each approval as one action to allow or decline. When you do want a shell, Øphio has a real terminal too.

What you need

  • An ARM64 Android phone or tablet running Android 10 or later.
  • An x86_64 Linux computer with glibc 2.39 or later, PipeWire and libxkbcommon. Ubuntu 24.04 is the baseline; other distributions and physical computers are not yet qualified.
  • Claude Code or Codex, signed in on that computer.
  • Tailscale, or a local network you trust.

Øphio is free and open source under Apache-2.0. The current version, a public beta, is on GitHub Releases; it isn’t on Google Play. Windows is an experimental preview and isn’t offered for download. Start here covers installing and pairing.

When it isn’t the right fit

  • You use an iPhone. There is no iOS app.
  • Your agents run on a Mac. There is no macOS companion.
  • You want agents to keep working with your computer switched off. Øphio drives agents on your own computer, so that computer has to stay on. Agents hosted in the cloud are a different kind of tool.
  • You’re building a multi-agent system in code. Øphio isn’t a framework or library for writing agents; it’s how you direct Claude Code and Codex from your phone.
  • You want many agents editing one repository in parallel. Øphio runs one writer per project at a time. Tools such as Claude Squad give each session its own git worktree and branch.

Stars on GitHub help people find Øphio. If you like it, consider starring it. Star on GitHub