Skip to main content
Once you’ve built more than a handful of agents, the sidebar gets noisy. Folders let you group related agents — “Sales”, “Internal ops”, “Experiments” — and collapse the groups you’re not currently working in. Folders are a purely organizational layer. They don’t gate access (any workspace member can see every agent in the workspace regardless of folder), they don’t affect what tools an agent can use, and deleting a folder never deletes the agents inside it.

​
Creating a folder

1

Hover over the Agents sidebar section

A + icon appears next to the Agents label.
2

Click + → New folder

A name input appears inline with focus. Type the folder name and press Enter.
3

Drag agents into the folder

Click and hold an agent in the sidebar, drag it over the folder, and drop. The agent’s folder_id is updated atomically.

​
Moving and ungrouping

  • Drag to reorder — drag a folder up or down within the Agents section to change its position. Ordering is per-workspace and synced for every member.
  • Drag to a different folder — drop an agent on a different folder to move it. Drop in the unfoldered area at the top of the section to remove it from its current folder.
  • Rename — click the folder name to edit in place. Press Enter to save, Escape to cancel.

​
Deleting a folder

Click the ⋯ menu next to a folder and choose Delete folder. Agents inside the folder are not deleted — their folder_id is set to null, and they reappear at the top of the Agents section. To delete an agent, open the agent and use Settings → Delete agent.

​
How it’s stored

A folder is a row in agent_folders (workspace-scoped, RLS-gated by workspace membership). Each deployed agent points at most at one folder via deployed_agents.folder_id, which is a foreign key with on delete set null — so the “delete folder, keep agents” behavior is enforced at the database level. Position is stored as an integer position column; ties break by created_at. The dashboard rewrites positions when you drag-reorder so the values stay dense.

​
Next steps

Agents overview

The lifecycle from build to deploy to ongoing operations.

The Builder

Create new agents via the meta-agent.