Skip to content
Controller AI Controller AI Controller AI Docs

Folders and labels

Past a handful of workflows, organization is a feature. Two primitives exist, and they compose: folders give workflows a location; labels give workflows and agents searchable attributes.

Folders

Section titled “Folders”
Terminal window
cai folder list
cai folder create --name "Sales ops"
cai folder move <workflowId> --folder <folderId>
cai folder delete <folderId>

One rule worth knowing before you clean up: deleting a folder moves its workflows to the root — it never deletes them. Folder deletion is an organizational operation, not a destructive one.

Labels

Section titled “Labels”
Terminal window
cai label list
cai label create --name "production"
cai label add <workflowId> --label <labelId>
cai label create-and-add <workflowId> --name "q3-pilot"

Labels are flat tags — a workflow or agent can carry several. Useful conventions: an environment marker (production on things live users depend on), an owner marker per team, and a status marker (experiment, deprecated) so cleanup sweeps have a target.

Agents take labels too, from the agent’s settings — the agents list filters by them.

Example prompts

Section titled “Example prompts”
Organize my workspace: group the workflows into folders by function, label everything a shared agent depends on as "production" (use cai deps), and label anything unrun for 30 days as "review".