Hosts

A host is the Traycer process that connects the app to workspace folders, files, terminals, git state and coding agents on one machine. Each machine you use runs its own host. The app can use a host on the same computer or on another machine you’ve added to your account. Most of the time you don’t manage hosts directly. You notice them when Traycer is starting, when a machine is offline or updating, or when a tab belongs to a different machine.

​

What The Host Owns

The host owns live work that depends on the machine it runs on:

• workspace-folder access
• file previews
• git diffs
• terminal sessions
• agents, and the provider and coding-agent setup that depends on tools installed on that machine
• in-app browser sessions and port forwards

Cloud sync carries your Tasks and their history across machines, but live work still runs on the host that started it. See Sync and offline.

​

Multiple Hosts

You can have more than one host. For example, your laptop and a workstation can each run a host, and each works with the folders and tools on its own machine. To add one, open the host picker in Settings and choose Add host…. See Remote hosts. The picker lists every host on your account. Rows show an Active tag on the active host, a short status word when a host needs attention (such as offline or restarting), and an update word such as updating or update waiting.

​

The Active Host

The active host is where new work starts unless you choose otherwise. It is shared by every Traycer window. To change it, open Settings › Host › Overview for another host and click Activate. See Overview. Failover. If the active host can’t be reached, Traycer switches to another host that is working and shows “Switched to <host>”. It switches back once the host you chose has been reachable for about 20 seconds. Choosing a host for one piece of work. Several places let you pick a host without changing the active host:

​

Tabs And Their Host

Every agent, terminal, file and diff tab belongs to the host it was opened on, for as long as the tab exists. Changing the active host doesn’t move them. When a tab’s host is unreachable, the tab says so. See Host-Bound Tabs.

​

Hosts And Agent-To-Agent Work

Agents can work with agents on other hosts in the same Task. What works across hosts depends on each agent’s interface and owner; see Agent-to-Agent.

​

Where To Manage Hosts

• Settings › Host › Overview: status, updates, data, ports, installation and Doctor for each host.
• Troubleshooting: status words, startup messages, logs and reporting an issue.
• Resource monitor: CPU and memory for each host’s agents and shells.
• Port forwarding: reaching a port on one machine from another.