Steads
Organise your agents into named workspaces called steads.
A stead is a named workspace for your agents. Think of it as a place where one or more agents live — a way to group agents into logical teams without affecting billing, permissions, or any other settings.
How steads work
Every account starts with a default stead called Main. All your existing agents live there. You can create additional steads and choose which stead a new agent is deployed into by switching to it before deploying.
| Concept | Detail |
|---|---|
| Default stead | Every account has one — named Main, cannot be deleted |
| Agent assignment | An agent is assigned to a stead when it is deployed and stays there |
| Switching steads | Changes which agents are visible on your dashboard |
| Billing | Steads have no effect on billing — all agents count toward your plan |
Switching steads
Click the workspace name at the top of the sidebar. A dropdown shows all your steads with the number of agents in each. Click any stead to switch to it — the agent list updates immediately.
The active stead is remembered across page reloads.
Creating a stead
Open the stead switcher
Click the workspace name at the top of the sidebar to open the dropdown.
Click Create new stead
At the bottom of the dropdown, click Create new stead.
Enter a name
Type a name for the stead (up to 50 characters). Names must be unique within your account.
Press Enter or click Create.
The new stead is created and set as active immediately. Deploy agents into it the same way you normally would.
Deploying into a stead
Agents are deployed into whichever stead is currently active in the sidebar. Switch to the target stead before clicking Deploy.
An agent's stead is set at deploy time and cannot be changed afterwards.
Deleting a stead
Open the Settings for an agent if you want to remove it, or contact support if you need to reorganise agents between steads.
The Main stead cannot be deleted. Non-default steads can be deleted via the API (DELETE /api/steads/:id). Any agents in a deleted stead are automatically moved to Main.
Deleting a stead does not delete the agents inside it — they are moved to Main.
Workspace networking
Each stead has its own Tailscale tailnet configuration. Agents in the same stead can reach each other privately via their 100.x.x.x Tailscale IPs.
Configure a stead's tailnet from Networking in the sidebar — click the stead to open its networking settings. You can use:
- OAuth credentials (recommended) — never expire, mint a fresh key per deploy
- Reusable auth key — simpler setup but expires after 90 days by default
Once configured, every new agent deployed into that stead automatically joins the tailnet. A small emerald dot appears next to the stead name in the sidebar and on the Networking page when a tailnet is configured.
See Networking & SSH for full setup instructions.