onepilot

The host side CLI of Onepilot, the iOS app that puts your servers and your terminal in your pocket. Install it on any Linux or macOS server to get persistent terminal sessions, opt in health monitoring, and QR pairing with the app.

Install

npm install -g onepilot

Quick start

onepilot pair            # print a QR code; scan it with the Onepilot app
onepilot serve           # start the persistent session daemon
onepilot list            # show live sessions
onepilot monitor status  # inspect opt in monitoring

The Onepilot app can also install this CLI on your servers automatically; the npm package is for people who prefer to manage it themselves.

Update

npm install -g onepilot && onepilot upgrade

onepilot upgrade hands the running daemon over to the new version in place: it re-execs the updated binary without dropping a single session, so your live shells, their running commands, and their scrollback all survive the update (0.7.1+). Updating from a version older than 0.7.1 still restarts the daemon once; every update after that is seamless. Plain npm install -g onepilot without the upgrade leaves the old daemon serving until it next restarts.

How it works

The serve daemon owns your shells and their scrollback on the server itself, listening on a loopback port only. Your phone reaches it through the SSH connection it already has: no inbound port, no relay, no third party in the data path. Disconnect whenever you want; the session and its history are there when you come back.

Security

• No outbound connections by default: no telemetry, no update checks. If you opt in to monitoring, the daemon POSTs alerts to the single webhook URL you configured, and nothing else.
• Everything lives under ~/.onepilot, runs as your user, and needs no sudo.
• Uninstall: npm uninstall -g onepilot, then pkill -f 'onepilot[^ ]* s[e]rve'; rm -rf ~/.onepilot to stop the daemon and remove its state.

Platforms

Linux and macOS on x64 and arm64. The binary was called onepilot-bridge before 0.3.0; that command name still works.