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.
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
Holds its own key, safe in the iOS Keychain.
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
Sees when an agent needs you.
Passes a short message to Apple.
Tap it to open that machine in the app.
Three steps to your first pane.
Install legio
One small command for macOS and Linux.
$ curl -fsSL https://legioapp.cloud/install | sh
Run it and pair
It prepares your machine and shows a QR code. Scan it with the app.
$ legio
Tap a machine
The app lists your workspaces and opens the real terminal of a pane, live.
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.
- MachineShows a QR code
The code works once, for a few minutes.
- PhoneMakes its own key
The private half stays on the phone. Only the public half is sent.
- YouCompare five words
The terminal and the phone show the same short phrase. If the words match, type y.
- PhoneConnects
From now on it is plain SSH with its own key.
$ 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.
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.
| What | Where it goes | Who 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 |
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.
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.