Repository navigation
Releases
2.1.0
ompanion 2.1.0 answers omp's form questions in the chat, opens an agent page's pictures in a zoomable image viewer, and reconnects at once when the app comes back to the front. It works with omp 18.3.1 and later and installs omp 18.16.0 on a machine that lacks it.
New
- Form questions: from omp 18.18.3 the
asktool can ask with one HTML form, and the chat shows the whole form in place: choices with Other, menus, text fields, text, lists, code, tables and pictures. Submit checks your answers by omp's rules and names the problem under each field, and the transcript lists the answers - Single-choice and multiple-choice questions look apart: one choice is a pill in a shared track, several are separate tiles with check boxes and a count of the chosen ones, and Other is the last row with a field for your answer
- Agent pages: a click on a picture opens it in the image viewer
- The image viewer zooms: a bar with zoom out, the zoom against the image's own pixels, zoom in and fit to window; double tap for the image's pixels and back; and the
+,-and0keys - When the interface hits an error it cannot recover from, it says so with the last errors, Copy details and Reload, instead of a screen that no longer reacts
Changed
- Following a running session takes far less data: a run's log arrives compressed, 1.3 MB instead of 4.8 MB on a first open of a busy session
Fixed
- When the app comes back to the front it checks every machine's connection, so one that died in the background (another network, sockets the system reclaimed) reconnects within seconds instead of the chat showing nothing new for up to a minute
- A chat that fell behind while the app was suspended no longer stays at an old message until the app restarts
- Large sessions no longer reconnect with "channel failed" every few seconds: the Tree tab reads a slim tree (3.6 MB instead of 30 MB for one 26 MB session), and only while it shows
- A fling through a long task keeps its place, and on iOS its momentum, instead of jumping back
- Mention chips sit on the text's baseline
Get it
| Platform | Get it |
|---|---|
| iPhone and iPad | App Store |
| Android | Google Play, in a closed test: join the testers first |
| Windows | Microsoft Store, or ompanion-windows-x64.zip below |
| macOS | ompanion-macos.dmg below, signed and notarized; it updates itself |
| Linux | ompanion-linux-x64.flatpak below (flatpak install --user ompanion-linux-x64.flatpak), or ompanion-linux-x64.zip, which needs GTK 4, WebKitGTK 6.0 and libsecret |
2.0.1
ompanion 2.0.1 polishes the 2.0 app after a review of every screen, and fixes races in sessions, goals and connections. It works with omp 18.3.1 and later and installs omp 18.16.0 on a machine that lacks it.
Changed
- Animations play faster, and menus fade in instead of unrolling row by row
- A run waiting for your answer says so:
Needs your inputin the chat header, and a mark on the tool call waiting for approval - Approvals: approve once is the one filled button; buttons that do not fit in one row stack into a column, and a long request scrolls above them with a fade at its edge
- The usage page is tidier: one toolbar line, a row only for the limits an account reports, and machines listed only when they need attention
- Empty places say what to do next: a machine without sessions offers a new one, the home page offers to install omp on a machine that lacks it, and the terminal tab offers a new terminal
- Files: a breadcrumb shows the current folder from
~or/, wrapped lines start past their own indent, and a diff starts at its first hunk - The session tree marks the current position and dims the branches off its path
- Sidebar: each session status has its own mark, and a session open in omp on the machine shows a terminal mark
- Phones: message actions take a line of their own instead of narrowing the message, and Settings no longer lists keyboard shortcuts
- Notices sit above the composer, wrap to at most three lines, and stay under open dialogs
- German: the strings added in 2.0.0 read consistently and address you as "du"
Fixed
- macOS: text is drawn at its normal weight again; 2.0.0 drew every weight thinner, worst on dark themes
- macOS: text fields no longer autocorrect or underline spelling
- Scrolling up in a chat while a reply streams is no longer pulled back to the bottom, and on iOS keeps its momentum
- The context meter shows the figure omp's own footer shows
- Goals continue after a compaction instead of waiting for you, and goals, loops, titles and the idle exit of detached runs stay consistent when events race
- A result that arrives after you moved on (another session, a closed dialog, an edited machine) no longer lands on the wrong screen, and syntax highlighting that failed to load loads again
- An SSH key agent that never answers no longer holds a connection past its timeout
- A reply's footer and its thinking line no longer show times of zero, and an attached folder shows as a folder in its message
Get it
| Platform | Get it |
|---|---|
| iPhone and iPad | App Store |
| Android | Google Play, in a closed test: join the testers first |
| Windows | Microsoft Store, or ompanion-windows-x64.zip below |
| macOS | ompanion-macos.dmg below, signed and notarized; it updates itself |
| Linux | ompanion-linux-x64.flatpak below (flatpak install --user ompanion-linux-x64.flatpak), or ompanion-linux-x64.zip, which needs GTK 4, WebKitGTK 6.0 and libsecret |
2.0.0
ompanion 2.0.0 is the same app rebuilt: a web UI in each platform's own webview, on a Go core, in place of Flutter. It works with omp 18.3.1 and later, 18.16 included, and installs omp 18.16.0 on a machine that lacks it.
Moving to 2.0.0
- Your machines, keys, trusted host keys, passwords, settings, pinned sessions and read markers come with you: on its first launch the app imports them from 1.x, and keeps the old database as
ompanion.sqlite.imported - iPhones and iPads need iOS 16, Macs macOS 13; on iOS 15 and macOS 12 the app stays at 1.2.1
- Smaller downloads: about 10 MB on Android instead of 35, 9 MB for the Mac instead of 28
New
- Agent pages: the agent can show an HTML page in the chat (a chart, a table, a small tool) with the
html_rendertool. It runs sandboxed, opens full screen and saves as HTML, and its links ask before they open - German, and a language setting
- Usage reminders: a notification when a limit resets or an account is usable again
- The model pickers list your recently used models first
- Hiding account details on the usage page covers emails and organizations with a random mosaic, for screenshots
- SSH keys moved from the sidebar into Settings
- Android 14 and later: the back gesture shows the page behind as you swipe
Fixed
- omp 18.16: the companion loads again, so goals, loops, pause, queue edits, settings, push and the idle exit of detached runs work (#6)
- Ubuntu 26.04 machines: two devices sending to a session at once no longer both take its lock
- Stopping a command on this computer also stops what it started
- Phones: the model list stays above the composer and the keyboard, and the composer's buttons sit on the screen's insets
- The
asktool's questions can be selected and their links open
Get it
| Platform | Get it |
|---|---|
| iPhone and iPad | App Store |
| Android | Google Play, in a closed test: join the testers first |
| Windows | Microsoft Store, or ompanion-windows-x64.zip below |
| macOS | ompanion-macos.dmg below, signed and notarized; it updates itself |
| Linux | ompanion-linux-x64.flatpak below (flatpak install --user ompanion-linux-x64.flatpak), or ompanion-linux-x64.zip, which needs GTK 4, WebKitGTK 6.0 and libsecret |
1.2.1
ompanion 1.2.1 works with omp 18.12 and installs omp 18.12.6 on a machine that lacks it.
Changed
- iPhone Duo: the app fills both displays. Forms scroll above the keyboard on the outer display, the sidebar and panel backgrounds reach the screen edges, and adding a machine opens full screen when the phone is closed and as a window when it is open
- With omp 18.11.3 and later, a tool approval's notification says "Allow bash?" again, and the "Always approve" choices of omp 18.12.3 look like approvals
Fixed
- omp installed with
bun install -gcan be attached to; before, opening a session on it failed with "unknown flag: -1" - A session whose tools report large progress, such as an eval running many subagents, no longer keeps reconnecting
- Linux machines: sending to a session at the same moment as another device no longer fails
Get it
| Platform | Get it |
|---|---|
| iPhone and iPad | App Store |
| Android | Google Play, in a closed test: join the testers first |
| Windows | Microsoft Store, or ompanion-windows-x64.zip below |
| macOS | ompanion-macos.dmg below, signed and notarized; it updates itself |
| Linux | ompanion-linux-x64.flatpak below (flatpak install --user ompanion-linux-x64.flatpak), or ompanion-linux-x64.zip, which needs GTK 3 and libsecret |
1.2.0
ompanion 1.2.0 works with omp 18.10 and installs omp 18.10.3 on a machine that lacks it.
New
- A Stats tab on the usage pane: every machine's omp sessions summed into totals, a contribution grid with streaks, an activity chart, a week-by-hour grid, and model, project, tool, agent and machine lists
- Prompt stats on the Stats tab: words, questions, tone, prompt lengths, the longest prompt, prompts by hour, and a word cloud of the words your prompts use most
- iPhone and iPad: attach from the photo library, and paste an image copied in another app into the composer
- The agent hub lists active and inactive agents apart, newest first
Changed
- Chat images load once a scroll settles on them, so a fling no longer loads every image it passes, and thumbnails decode at the size they show
- An account's policy line on the usage pane says when its quota is exhausted, as omp 18.10 does
Fixed
- With omp 18.8.7 and later, sessions started from a device get a title again
- A provider you sign in to, or whose key you store, while a session runs can be used in that session; before, picking its model failed with "Model not found"
- A folded turn keeps every reply the model finished with, so an answer stays when a background job's result starts another run
- Windows: after switching back to the window, the next key no longer replaces a field's whole text
Get it
| Platform | Get it |
|---|---|
| iPhone and iPad | App Store |
| Android | Google Play, in a closed test: join the testers first |
| Windows | Microsoft Store, or ompanion-windows-x64.zip below |
| macOS | ompanion-macos.dmg below, signed and notarized; it updates itself |
| Linux | ompanion-linux-x64.flatpak below (flatpak install --user ompanion-linux-x64.flatpak), or ompanion-linux-x64.zip, which needs GTK 3 and libsecret |
1.1.0
ompanion 1.1.0 works with omp 18.6 and installs omp 18.6.3 on a machine that lacks it.
New
- Keep a Mac awake while omp works, switched per machine on its page: a Mac that a request from your phone woke no longer falls back asleep mid-turn
- Update omp on a machine from its page
- Start a session without a project folder, or straight from a project row in the sidebar
- Mark sessions, folders and machines read from the sidebar
- A custom theme: pick every color the app draws
- Resize the sidebar and the dock by dragging their edge
- Images omp keeps in its blob store show in the chat
- Hide emails and organizations on the usage pane, for screenshots
- Linux: a Flatpak that runs omp and your shells on the host, and notifications with the app icon
Changed
- When omp cannot use the model a session ran on, the app asks which model to continue on instead of failing to open the session
- Stream rule matches show as a note in the chat instead of a toast
- Sessions started from a device get a title, as in omp's terminal
- Faster opening: a device's first look at a long run replays a compacted log, images cross once, and progress updates collapse while omp works; long runs rotate their log on Windows machines too
Fixed
- With omp 18.4.9 and later, live updates, goal and loop modes, notifications and idle exit work again
- A run that omp moves to a new session file (omp 18.4.9 and later) is followed there
- The queue and goal mode match omp 18.4
- A session's earlier subagents show when omp opens it
- The session you clicked last shows, whichever finishes opening first
- The ask form's "other" answer takes spaces typed on a keyboard
- macOS full screen keeps refreshing, and the send arrow and icon buttons draw in the right colors
Get it
| Platform | Get it |
|---|---|
| iPhone and iPad | App Store |
| Android | Google Play, in a closed test: join the testers first |
| Windows | Microsoft Store, or ompanion-windows-x64.zip below |
| macOS | ompanion-macos.dmg below, signed and notarized; it updates itself |
| Linux | ompanion-linux-x64.flatpak below (flatpak install --user ompanion-linux-x64.flatpak), or ompanion-linux-x64.zip, which needs GTK 3 and libsecret |
1.0.0
First release of ompanion, a client for omp, the oh-my-pi coding agent, on this computer and on remote machines over SSH.
- Chat with a streaming transcript, markdown, LaTeX math, collapsible thinking and images
- Tool cards with word-level diffs; approvals, questions and extension dialogs answered inline
- Session tree with search, filters, labels and branching; subagents in the Agent Hub; todos by phase
- Files with an editor, git diffs and a terminal on the machine
- Machines over SSH, through chains of jump hosts, or on a private mesh VPN; omp installed on a machine that lacks it
- Configuration for settings, model roles, providers, MCP servers, plugins, skills and usage limits
- No accounts, no analytics, no tracking
Get it
| Platform | Get it |
|---|---|
| iPhone and iPad | App Store |
| Android | Google Play, in a closed test: join the testers first |
| Windows | Microsoft Store, or ompanion-windows-x64.zip below |
| macOS | ompanion-macos.dmg below, signed and notarized; it updates itself |
| Linux | ompanion-linux-x64.zip below; needs GTK 3 and libsecret |