How it works

Plain SSH. A key that stays on your phone.

Legio is an SSH client. The free legio command prepares your machine and pairs your phone with it. After that, your iPhone talks straight to your machine.

The big picture

Two parts. One connection.

The app on your iPhone and the legio command on your machine. They talk over the SSH server that your machine already runs.

Everything you do

Terminals, panes, Docker, files, ports, metrics

iPhone Legio app

Holds its own key, safe in the iOS Keychain.

Your machine The SSH server you already run

Your terminals and agents stay on your machine. The phone only looks at them and types into them.

Notifications only

When an agent needs input or finishes

Your machine legio

Sees when an agent needs you.

Legio relay Sends the push

Passes a short message to Apple.

iPhone “Claude needs input”

Tap it to open that machine in the app.

From zero

Three steps to your first pane.

1

Install legio

One small command for macOS and Linux.

$ curl -fsSL https://legioapp.cloud/install | sh
2

Run it and pair

It prepares your machine and shows a QR code. Scan it with the app.

$ legio
3

Tap a machine

The app lists your workspaces and opens the real terminal of a pane, live.

Pairing

Your phone makes the key. You approve it.

The QR code holds no password and no key. Your phone gets in only when you say yes at the terminal.

  1. MachineShows a QR code

    The code works once, for a few minutes.

  2. PhoneMakes its own key

    The private half stays on the phone. Only the public half is sent.

  3. YouCompare five words

    The terminal and the phone show the same short phrase. If the words match, type y.

  4. PhoneConnects

    From now on it is plain SSH with its own key.

you@vps-01
$ legio
✓ Machine is ready
Scan this code with the Legio app.

A phone sent its key: iPhone
Check that the app shows these words:
fee   jazz   naive   fruit   equip
  Let this phone in? [y/N] y
✓ Paired. 
Security

Safe by design, not by promise.

A phone is easy to lose. So Legio gives each phone the smallest access that works, and you see every step of the pairing.

The private key never leaves the phone

The phone makes its own key and keeps it in the iOS Keychain. Your machine gets only the public half.

A QR code that opens nothing

The code is not a login. It works for one pairing, for a few minutes, and then it expires.

You approve every phone

No phone gets in until you say yes at the terminal, after you compare five words.

A key that can do only what the app needs

Each phone key is limited to what the app needs. It cannot reach the rest of your network.

Your code stays on your machine

Terminals and files go straight between your phone and your machine. No Legio server sees them.

Verified updates

Each download is checked before it is installed. If an update fails, the old version stays.

WhatWhere it goesWho can read it
Terminals, panes, Docker, files, ports, metrics iPhone ⇄ your machine, over SSH You and your machine
Your private key and passwords iOS Keychain only The app on your phone
A notification Machine → relay → Apple → iPhone The relay and Apple see its text: the agent's name, its status, and the workspace and pane title
Your notification rules The relay The relay, to drop the pushes you do not want
An account There is none Apple keeps your purchase with your Apple ID
Stay in control

Lost a phone? One command.

Every phone has a name and a key phrase. Remove one, and its key cannot log in again.

See and remove phones

List the paired phones. Remove one by its name.

$ legio devices
$ legio unpair iPhone
$ legio push remove iPhone

Check, or remove it all

check shows if everything works, and changes nothing. uninstall removes everything that legio added, and every phone key.

$ legio check
$ legio uninstall

Tip: put the machine on Tailscale so port 22 never faces the internet. legio finds the Tailscale address and puts it in the QR code for you.

Legio app icon

Pair your first machine. In a minute.

Install legio, scan the code, and your agents go where you go. The pairing protocol is open on GitHub.

Read the protocol