ompanion: omp client

ompanion is a client for omp, the open-source oh-my-pi coding agent. omp normally runs in a terminal on your own machine; ompanion drives it over SSH from your iPhone or iPad, with no daemon installed on that machine.

On iPhone and iPad ompanion is SSH-only: it connects to a computer you own and control.

What you need

- A machine you can reach over SSH: macOS, Linux or Windows.

- omp 18.3.1 or newer on it. If omp is missing, ompanion installs it on that machine, or shows you the commands to run yourself.

- AI model access from your own provider accounts, configured in omp on that machine. ompanion ships no servers, no accounts, no model of its own.

Chat

- Streaming transcript with markdown, LaTeX math, highlighted code, collapsible thinking and images

- Finished turns fold their thinking, tool calls and interim messages under a one-line summary

- Steer the running turn or queue a follow-up, and edit or remove queued messages

- Slash commands from the session's own command list, model and thinking-level pickers, and a context and cost meter

- Pause and resume every agent of a session; Stop aborts the run and restores queued messages

- Attach files by picking them, or paste images; images go to the model, files reach omp as mentions it reads on the machine

- Copy messages and code, and branch from any of your messages

Tools and approvals

- Tool cards for shell, read, edit and write with word-level diffs, eval, todo, task, web search and fetch

- Tool approvals answered inline; the ask tool as a form with several questions, previews and your own answers

- Extension dialogs, status lines and toasts; files named in tool cards open in the Files panel

Sessions

- Every session on a machine, grouped by project and across omp profiles, marked working, waiting for input or unread

- Search sessions across your machines by title or project path

- Resume any session on the machine, including ones from omp's terminal UI (read-only while that omp still has it open)

- Session tree with search, filters, labels, branching and an optional model-written summary

- Several of your devices on one live session: each sees what the others send, and the first answer settles the dialog everywhere

Machines

- Any SSH host, including hosts behind a chain of jump hosts

- No daemon: it runs stock omp, and uploads a small companion extension for what omp's RPC lacks

- Sessions run detached on the machine, so a dropped connection or a locked phone does not stop the turn

- Key, password and keyboard-interactive SSH authentication, with host-key checks on every hop

- Each machine is probed, and omp is installed on it with a checksum check

- Generate Ed25519 keys or import your own; private keys stay in the platform's secure storage

Files, terminal and configuration

- Files: browse, create, rename and delete; an editor with find and replace; git status and diffs

- Terminal tabs on the machine, over SSH

- Agent Hub: subagent roster with progress, tokens and cost, each agent's transcript, steer, kill, revive

- Todos by phase, and compactions shown with their summary and file lists

- Settings from omp's own schema, model roles, providers, MCP servers, plugins, skills, and stats

- Usage: subscription limits from every online machine, with reset times and account priority

- Monochrome, flat design with an OLED-black dark theme and a light theme; on an iPad in landscape, machines, chat and tools sit side by side

Privacy

- No accounts, no analytics, no crash reporting, no ads, no tracking

- Your data stays on your device or goes over SSH to your own machines; the app reaches GitHub only to download omp for a machine, and a web image in a reply only when you tap it

- Prompts go to omp on your machine, which calls the providers you configured there, under their policies

- Private keys and passwords are kept in the platform's secure storage

ompanion is open source (GPLv3): github.com/edde746/ompanion