Every live OMP session. One private page, in any modern browser.
Keep using Oh My Pi in your terminal. OMP Session Gateway lists your collaboration-enabled sessions, shows which need you, and opens OMP's own encrypted View or Control client from your phone — no QR scans or per-session link copying.
Synthetic product demo captured from the built app and pinned collaboration client (capture provenance · MP4).
Get started · Docs · Security · Compatibility · Latest release
Works with stock OMP 18.1.20+ — no fork or custom build.
- Discover automatically. Every collaboration-enabled
ompprocess on the host appears in OMP Sessions, the gateway's web app, on the next 10-second discovery poll. There is no per-session command, QR code, or link to copy. - The oldest request first. When a session waits for input, Needs you names it and puts the oldest request at the top. The prompt itself stays in OMP.
- One tap to the real session. Open request opens OMP's own encrypted collaboration client on that exact request in Control; a tap on any live session opens it read-only in View. The link is fetched when you tap and is never stored.
Screens

All clear: every live session listed automatically with no per-session setup.

Needs you: the oldest waiting request is promoted first with bounded metadata.

Open request: one tap opens OMP's own encrypted collaboration client.
You need:
- the latest stable release
- Bun 1.4.4 at a path that stays put; the background service runs
bunfrom it - stock OMP 18.1.20 or later
- Tailscale on the host and on your phone: a TUN-mode client on the host, and Serve over tailnet HTTPS, never Funnel
omp --version # must report at least 18.1.20
omp config set collab.autoStart control # or view for read-only sharingStart participating sessions with plain omp after changing this setting; already-running omp processes do not pick it up.
Download the archive and verify it. If the host still runs v0.3.0 or earlier, uninstall that release with its own CLI first. Then, from the download directory, install the gateway with the host's Tailscale HTTPS address and your Tailscale login:
tar -xf omp-session-gateway-*-bun.tar
cd omp-session-gateway-*-bun
bun apps/gateway/src/cli.js install \
--origin https://host.example.ts.net \
--allow you@example.com
bun apps/gateway/src/cli.js serve-guidanceOn Windows, use the PowerShell steps in Operations: one line per command, no \ continuations.
Run the Tailscale Serve command that serve-guidance prints, grant your login HTTPS access to the host in your tailnet policy (example), then check the installation:
bun apps/gateway/src/cli.js doctordoctor exits non-zero when a check fails; Troubleshooting by symptom covers the common causes. To run from a source checkout instead of the release archive, see Build from source.
Open the HTTPS address on a phone signed in to Tailscale with the login you allowed, and add OMP Sessions to your Home Screen. The first launch walks through three short trays: Connected, Background alerts, and View or Control.
Setup is one-time: each new omp session appears within 10 seconds. Using OMP Sessions covers the app; Installation and operations covers updates and service management.
- The directory and Needs you — Live sessions are listed under All clear. When any session waits for input, the app switches to Needs you and puts the oldest request first.
- View and Control — Tap a live session to read along in View; tap Open request to answer in Control. You can attach photos, and a reply shows
Sending…until OMP confirms it. - Hold and hide — Hold for desk sets a request aside on this device and moves to the next one. Hide takes a session that is not waiting off this device's list.
- Background alerts — Opt in per device and choose Private, Session, or Preview detail. An input-request alert opens Control; an alert that a turn finished opens View.
- Multiple hosts — One installed app lists and opens sessions on up to eight hosts once an administrator connects them.
- Alerts from other hosts — The home gateway, the one that serves the installed app, sends alerts for each remote host you switch on, after administrator setup.
- Dictation — Dictate with your keyboard's microphone key, or with an optional in-page recognizer that an administrator enables. Use text fills the composer and never sends.
- New sessions — Where an administrator has enabled it, start a new
ompsession in Tern from approved project, working-copy, and profile choices. An optional First task draft is placed in the composer and never sent for you. - Light and dark — The app follows your device's appearance. Color marks state only: green for live, amber for waiting on you, red for access denied.

Per-device notification detail in the Alert detail tray, opened from the Background alerts tray. Full guide: Using OMP Sessions.
- Loopback-only daemon —
omp-gatewaydbinds to127.0.0.1and optionally::1, never to a network interface. - Tailscale Serve and an exact login allowlist — Requests arrive only over tailnet HTTPS through TUN-mode Tailscale Serve, from a Tailscale login on your allowlist. Funnel is never enabled.
- Links fetched per tap and kept in memory — A View or Control link is a bearer secret. It is fetched from OMP only when you tap, handed to the client once, and never stored, logged, or cached.
- Metadata-only directory and alerts — Session lists, live events, and alerts carry bounded session metadata only, never collaboration links or prompts.
- No transcript storage, telemetry, or third-party assets — OMP's own browser client connects through OMP's encrypted relay. The gateway stores no transcripts, sends no telemetry, and loads no external scripts.
- Stale sessions cannot be opened — Every launch checks that the session is still the one you tapped. A replaced or exited session fails closed instead of opening something newer.
- Other hosts are reached directly — With several hosts, your browser talks to each exact trusted origin itself; no gateway proxies another. Alerts from other hosts carry identifiers only, never titles, paths, previews, or links.
- Session creation is opt-in and bounded — Starting a session uses only the project, working-copy, and profile choices an administrator approved, and an uncertain start is never retried automatically.
Read the security model or report a vulnerability privately.
| Surface | Qualified on real hardware (latest release) |
|---|---|
| Linux host | Debian 13 x86-64 |
| macOS host | macOS 27 arm64 (Virtualization.framework guest, not bare metal) |
| Windows host | Windows Server 2025 x86-64 (build 26100), started at interactive logon, Administrator or standard account |
| Android | A physical Pixel (Chrome on Android), including background alerts; a cloud Samsung Galaxy |
| iPhone & iPad | A cloud iPhone and iPad on Safari; iPhone background alerts in the Home Screen app (not the lock screen) |
| Desktop Chrome, Edge, Firefox, Safari | CI only (Chromium, Firefox, and WebKit engines) |
| Exact qualified OMP | v18.20.0 (c308970263); Bun 1.4.4 |
Every row is supported: tested in CI on each change, bug reports accepted. Qualified names the exact hardware, OS, and browser versions verified for the latest release — see Platforms and browsers and Current claim.
TestingBot supports this project with free real-device testing through its open-source program.
This project is tested with BrowserStack.
- Tailscale TUN mode is required. Userspace networking hides peer identities behind loopback, so the gateway refuses requests. If
doctorreportsloopbackTrustSound: false, switch Tailscale to TUN mode rather than bypassing the check. - Tailnet only. Expose the gateway only through Tailscale Serve over tailnet HTTPS. Never enable Tailscale Funnel; there is no supported public-Internet path.
- Default relay only. Sessions connect through OMP's default end-to-end-encrypted relay. Self-hosted and proxied relays are unsupported.
- Starts at login on macOS and Windows. The service starts when you sign in, not at unattended boot. After a reboot, sign in on the host before opening sessions from your phone.
- Single-user workstation only. Local accounts on the same machine can reach loopback directly. Deploy on a workstation you control, not a shared host.
- Android radio changes can stall Chrome. Switching between Wi-Fi and cellular can stall Chrome's network stack (#65). The app retries and, after 45 seconds of visible failure, offers Troubleshooting with the steps to force-stop and reopen the browser.
- Preview detail shows what Session shows. Stock OMP does not publish a prompt preview, so both levels send the session title and folder name. Choose Private to keep session names off your lock screen.
- Alerts from other hosts depend on the home gateway. It sends every alert, so it has to stay awake and reachable. A remote host's alert shows only the host label and a six-character session suffix.
- Starting sessions in Tern has run end to end only on Apple silicon macOS. Linux and Windows hosts are covered by unit tests only.
- Using OMP Sessions — install on your phone, triage requests, open View and Control, use multiple hosts and alerts, and start sessions
- Installation and operations — host setup, Tailscale Serve, access policy, optional multi-host and Tern configuration, updates, and
doctor - Upgrade and rollback — update in place, roll back to a previous installed version, and restore saved settings
- Compatibility — supported platforms, hardware-qualified combinations, and status definitions
- Security model — threat model, trust boundaries, and capability-handling invariants
- Documentation index — architecture, wire contracts, package guides, qualification runbooks, and release records
Primary READMEs and package metadata checked 2026-10-29; see the dated sources in the full comparison below.
- Keep work in running
ompterminals — OMP Session Gateway lists live terminal sessions and opens OMP's encrypted View or Control client from your phone. - Agent web chat or remote terminal over tunnels — oh-my-portal provides skills, RPC, and terminal access over Portal tunnels.
- Browser workspace for other coding CLIs — CloudCLI (
claudecodeui) targets Claude Code, Cursor CLI, and Codex; pi-agent-dashboard targetspi. See the full comparison.
See CONTRIBUTING.md for development workflow and source builds, docs/BACKLOG.md for open follow-ups, and SECURITY.md to report a vulnerability privately.
OMP Session Gateway has no telemetry, analytics, or hosted control plane. This is a community project and is not affiliated with or endorsed by the Oh My Pi maintainers.
MIT. See LICENSE.
