ConnectionsDevices & the agent

Connections

Devices & the agent

A small agent on every machine serves its terminals, ports and state to the app over a loopback API.

Settings · Devices
How to
  1. Open Devices. Settings Devices.
  2. Scan one. Click a device to expand it and scan its live tmux sessions.
  3. Act on what you find. Add a session to a workspace, move it, or terminate a stale one.
  4. 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.

Was this page helpful?