# Agents List Page

## Overview

Card grid list of all agents.

Follows the layout of `specs/designs/10-layout/list.md`, only the details are documented in this spec.

## Page Name

"Agents" for title and breadcrumb

## Filters

| Row  | Mode  | Values                             | Default | Extra                         |
| ---- | ----- | ---------------------------------- | ------- | ----------------------------- |
| Tags | Multi | the tags present across all agents | None    | row hidden when no tags exist |

## Card Anatomy

Card height is fixed at 256 px to leave room for the references footer.

```
┌─────────────────────────────────────────────────────────────┐
│ [icon]  Agent Name                              [status]    │
│                                                             │
│ Description, clamped to three lines…                        │
│                                                             │
│ [tag] [tag]                                                 │
│                                                             │
│ 🔧 tool-one, tool-two +3                                    │
│ 📚 kb-one, kb-two                                     [▒▒]  │
└─────────────────────────────────────────────────────────────┘
```

The card is clickable as a whole and links to `/workloads/agents/[id]`.

### Header

- Small icon (size 36)
- Agent name (line-clamp-2 if long)
- Status badge (right, when set)

### Body

- Description, clamped to three lines

### Tags

- tag chips (only rendered when there are tags)

### References Footer

- Tools row: `WrenchIcon` + first 2 tool names joined with `, ` + `+N` for any overflow (only rendered when `tools.length > 0`)
- KBs row: `DatabaseIcon` + first 2 KB names + `+N` overflow (only rendered when `kbs.length > 0`)

## Empty States

**No agents at all:**

```
BotIcon (muted)
"No agents yet."
[New Agent button]
```

**No match:**

```
BotIcon (muted)
"No agents match your filters."
[Clear filters link]
```