> ## Documentation Index
> Fetch the complete documentation index at: https://agnt.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Folders

> Group deployed agents in the sidebar.

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

<Steps>
  <Step title="Hover over the Agents sidebar section">
    A `+` icon appears next to the **Agents** label.
  </Step>

  <Step title="Click + → New folder">
    A name input appears inline with focus. Type the folder name and press Enter.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## 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

<CardGroup cols={2}>
  <Card title="Agents overview" icon="robot" href="/agents/overview">
    The lifecycle from build to deploy to ongoing operations.
  </Card>

  <Card title="The Builder" icon="sparkles" href="/agents/builder">
    Create new agents via the meta-agent.
  </Card>
</CardGroup>