Devices & the agent
Add machines and scan their sessions
A small agent on every machine serves its terminals, ports and state to the app over a loopback API.
How to#
Open Devices. Settings → Devices.
Scan one. Click a device to expand it and scan its live tmux sessions.
Act on what you find. Add a session to a workspace, move it, or terminate a stale one.
Add machines. Run the setup wizard and give it SSH details you can already reach.
The agent, per device#
A small agent runs on each device and serves its terminals, ports, saved state and usage over a loopback API. Your state lives on the device - not only in the browser - so it survives clearing site data, and any browser pointed at that device sees the same layouts.
Add a device#
The setup wizard in Settings → Devices takes the SSH details of a machine you can already reach and installs the agent on it over that connection - you set up SSH, PzzaCode drives the rest. Once installed, the machine behaves exactly like the local one.
Scan a device’s sessions#
In Devices, click a device to scan every tmux session on it - even leftovers the app never opened. From there you can add one to a workspace, move it, or terminate it, which makes cleaning up stale sessions on long-running boxes painless.