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

# Pools

> Group agents into a shared workspace with role-aware access-control lists.

**Pools** group multiple agents into a single shared workspace with role-aware ACLs, so a set of agents can collaborate over shared files and messaging. See [Pools](/concepts/pools) for the underlying model.

## The pools table

The main table lists every pool with **filter/search** and pagination. Columns:

| Column          | Description                          |
| --------------- | ------------------------------------ |
| **Name**        | The pool's name.                     |
| **Lead**        | The agent designated as lead.        |
| **Members**     | Member count.                        |
| **Description** | Short summary of the pool's purpose. |

### Actions

* **New pool** — create a pool.
* **Delete pool** — from each row's menu.
* Click a row to open its **detail sheet**.

<Frame caption="Pools — group profiles into a shared workspace with role-aware access.">
  <img src="https://mintcdn.com/orcapods/QvGbh1ZeFOhKP6Fs/images/dashboard/pools.jpg?fit=max&auto=format&n=QvGbh1ZeFOhKP6Fs&q=85&s=a052e6c4de7a54e67650f10cd49b8c29" alt="Pools page empty state with New pool action" width="1440" height="688" data-path="images/dashboard/pools.jpg" />
</Frame>

## Pool detail sheet

The detail sheet has three tabs:

<Tabs>
  <Tab title="Members">
    The agents in the pool, each assigned a role of **lead** or **member**. The lead coordinates work across the pool.
  </Tab>

  <Tab title="Workspace">
    Access control for the shared workspace: a **built-in path-ACL table** plus your own **custom read / write / deny globs** to scope exactly which paths each role can touch.
  </Tab>

  <Tab title="Tools">
    The pool's built-in tools — **`pool_info`**, **`pool_post`**, and **`pool_inbox`** — which agents access by adding the **`@pool`** capability to their profile.
  </Tab>
</Tabs>

<Info>
  The `@pool` capability is what wires an agent's tools into the pool. Add it to a member agent's [profile](/concepts/profiles) so it can read pool info, post messages, and check its inbox.
</Info>

## Related

<CardGroup cols={3}>
  <Card title="Pools" href="/concepts/pools">
    The pool model and ACLs in depth.
  </Card>

  <Card title="Workflows" href="/concepts/workflows">
    Orchestrate pooled agents as a DAG.
  </Card>

  <Card title="Agents" href="/dashboard/agents">
    Add the `@pool` capability to members.
  </Card>
</CardGroup>
