Skip to main content

Connecting Your Own Machines

This is an advanced feature. Most users do not need it right away. Agents work inside their own containers by default — this page is for when you want an agent to reach a machine you control, for instance, to allow an agent to work directly with files on your computer.

Taurus calls these execution targets. There are two kinds:

  • Relay targets — you run the Taurus relay on your machine, and it connects outward to Taurus
  • SSH targets — Taurus connects to a host over SSH using credentials you save

Step 1. Adding a target​

Go to Account Settings → Relays:

  • For a relay: click Add Relay → My Computer, name it, generate a setup token, and run the displayed command on your machine.
  • For SSH: click Add Relay → Remote Server, then enter the host, port, username, and credentials.

Step 2. Granting agent access​

Now the target is connected to your account, but Taurus does not automatically give every agent access to it. You explicitly grant it to the agents that need it.

  1. Open the agent → Settings → Relays.
  2. Enable the target.
  3. Choose which operations are allowed: Shell, Read, Write, Sync.

Important security note​

Path policies can limit file operations like Read, Write, and Sync. But if you give an agent Shell, it can bypass those path limits anyway by just using the shell.

So removing Shell is not a magic safety switch, and keeping Shell available is often what makes the feature actually useful. The real point is that you should be much more careful granting agents access to your own devices than to their normal Taurus containers.

What's next​

Back in the main tutorial path, continue with Account & Billing.