Remote hosts

Add a host on another machine and make it your active host.

A host on another machine runs agents and works with files on that machine. To add one, open Settings, open the host picker, and choose Add host….

Add A Host

The Add host dialog lists the commands to run on the other machine:

1. Install the Traycer CLI

   npm install -g @traycerai/cli
   

   The npm package needs Node.js 22.13 or newer. On macOS and Linux you can use Homebrew instead, which needs no Node.js:

   brew install traycerai/traycer/traycer
   
2. Sign in

   traycer login
   

   Open the link on any device, enter the code, and approve sign-in.

3. Install and start the host

   traycer host ensure
   

   This installs, registers and starts the host. It is safe to run again.

The dialog notices the host when it joins your account:

Card	Meaning
Host connected	”It registered itself and is ready to run agents.” Choose Set up host to open its settings.
Host registered	The host is in your account, but this window has no live connection to it. You can still manage it from Settings.

On Linux, the host runs as a systemd user service. If traycer host ensure can’t register it, run traycer host doctor on that machine, or see Doctor.

Make It The Active Host

On the host’s Overview, click Activate. The button becomes an Active tag, and new work starts on that host by default in every window.

Tabs that are already open stay on the host where they started. To continue a Chat-interface agent on another host, clone it; terminals and Terminal-interface agents can’t move. See Tabs and their host.

The host’s health shows in its Overview header and in the host picker. See Overview.

Remove A Host

To take a host off your account, open its Overview, go to Installation, and use Remove from account in the Danger zone. Nothing on that machine is uninstalled. See Danger Zone.