Connecting from a computer or phone

Sessions run on Tokenman's devices, not on your computer or phone. Your computer and phone only open windows onto them: with the same account, whichever device you open it on, you see the same set of sessions. Every command you type in a terminal is on this page.

On a computer (Mac or Linux)

The first time: paste the line your admin sent into the terminal and press Enter. An admin installing for themselves uses the hub's address followed by /install:

curl -fsSL https://hub.example.com/i/<invite-code> | sh     # member: the line in the invite
curl -fsSL https://hub.example.com/install | sh             # admin

When it is installed, Tokenman opens and asks you to sign in once: a link or a QR code appears in the terminal; open it in a browser or scan it with your phone, sign in with WeChat, email or GitHub, and choose Confirm. ✓ 证书 · ✓ 已登记到入口 (certificate · registered with the hub) means you are connected.

Every day after that: in the terminal, type

fleet          # open it, back to where you left off
fleet quit     # close only the window on this computer; sessions keep working

On a Mac, iTerm2 is recommended: ⌘P opens the panel; in other terminals and on a phone use F12 or ⌃] p. Tokenman takes that one key (in iTerm2, F12 stays the session's); everything else is in the panel.

What happens when you close your computer

What you did	Sessions	When you come back
Closed the terminal window, shut the laptop, went offline	Keep working	Type `fleet`, everything is where you left it
Chose "Quit Tokenman" in the panel, or typed `fleet quit`	Keep working (only the client on this computer quit)	Type `fleet`
Moved to another computer	Keep working	Install and sign in on the new computer (same account), type `fleet`: all your sessions are there

One sign-in lasts 12 hours and this computer renews it by itself when it runs out; when it cannot, the client asks you to scan again.

On a phone (iOS or Android)

On a phone, use Termius (on both iOS and Android) to connect to your own address; what you see is the same set of sessions as on your computer. It takes one setup, about 5 minutes:

Open the hub in a browser, sign in, and choose Connect from a phone in the navigation (the address is https://<hub>/fleet/keys, for example https://hub.example.com/fleet/keys).
Follow the page's six steps: install Termius → generate a key in Termius → paste the public key back on the page → add a host in Termius (address, port, username and key — each has a copy button on the page) → connect and trust the host key → once connected, press F12 or ⌃] p to open the panel.
Your address looks like <name>.<the hub's domain> (for example alice.fleet.example.com) and is written on the page; use the port the page shows too.

After that, on the phone:

Open the panel: F12 or ⌃] p (Ctrl+], then p). Add F12 to the extra-keys row above Termius's keyboard and one tap opens it.
On a narrow screen the panel fills the screen; tap a row to switch to it.
New phone, or lost it: revoke that key on the hub's My connection page and it can no longer connect, at once.
A command line only, no panel: add an environment variable LC_FLEET_ENTRY with the value shell to that host in Termius, and connecting lands at your own command line on your home machine (from a computer: ssh -p <port> -o SetEnv=LC_FLEET_ENTRY=shell <username>@<your address>). Type fleet there for the panel.
At your home machine's command line, claude and codex run on Tokenman's shared subscriptions (the first line says so); touch ~/.fleet-pool-off to use your own account instead.
Moved your home to another machine: with the address everyone shares (the page's first one), nothing changes — not even the host key. With the "Advanced: straight to this machine" way, that address follows your home: after a move it reaches the new machine, so the phone asks once to trust its host key — accept it only if it matches the fingerprint on the Connect from your phone page. If the two machines sit behind the same router, point the router's port forward at the new one; the page names its address on your home network.
The phone says the host key changed and you don't know how to accept it: in Termius, Settings → Known Hosts → delete that address's entry → connect again, and tap Continue only if the fingerprint matches the Connect from your phone page; on a computer, ssh-keygen -R '[address]:port' then reconnect (fleet fetches the current key from the hub by itself). If it doesn't match, don't accept it — tell your admin.