Skip to content

Teammates and computers

On the team list, the + adds a teammate on the server: a name, an optional goal, and a harness, model and effort. It starts with a workspace of its own under the room, and nothing else: no computer, no reach outside that workspace, no background work. Rename it, change its goal or remove it from the phone too.

A teammate without a computer browses in a browser of its own on a server installed with --browser. Watch it and take control from your desktop app or phone. See Desk browser.

A computer is a Linux desktop in a container on the server that the teammate drives, and that you can watch and take over from your phone. See The computer for what it is.

The server needs Docker or Podman, usable by the account the desk runs as (systemctl show -p User --value hotline): add that account to the docker group, or run Podman rootless as it.

Turning a computer on is a grant, so it happens on the server, not the phone. Find the teammate’s id, then turn its computer on:

Terminal window
H="sudo -u $(systemctl show -p User --value hotline) HOTLINE_DATA_DIR=/var/lib/hotline/room hotline"
sudo grep -o '"id":"[^"]*","name":"[^"]*"' /var/lib/hotline/room/room.jsonl | sort -u
echo '{"id":"TEAMMATE_ID","patch":{"computer":{"enabled":true}}}' | $H wire persona.update

The computer starts the first time the teammate uses it: ask it to, for example “open example.com in your browser”. The first start pulls the desktop image, which takes a minute. After that, the monitor icon in the conversation’s header turns green while the teammate is using its computer. Tap it to watch, and take control when you want the keyboard.