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