# Agent List Display and Filters

> Every choice about what the agent list of a project shows lives in one panel: the sort, the history, the label of each agent and where the agents run.

- Area: Desktop app
- Plans: All plans
- Last checked against the product: 2026-11-04
- Web page: https://agentsroom.dev/docs/agent-list-filters

## What it does

Every choice about what the agent list of a project shows lives in one panel: the sort, the history, the label of each agent and where the agents run. The bar above the list keeps only what acts on the agents (pause, message to all, tidy up, open space) and the three ways to create one (**Flash**, **AI Suggestion**, **+**).

## Where to find it

Inside a project, at the end of the search field on top of the agent list: the **Display and filters** button (sliders icon), just before the sparkle of Agent Suggestions. When the interface mode hides the search field, the button opens the second row of the bar instead. The panel slides out of the right edge of the agent list, in front of the agent view.

## How to use it

1. Click **Display and filters**.
2. Pick a value in a row:
   - **Sort**: **Activity** or **Groups**.
   - **Agent history**: **No history** (default) or **Previous conversation** (see [Agent Row Action Dock](https://agentsroom.dev/docs/agent-row-dock.md) for the title of the last conversation).
   - **Agent label**: **Task title** (default), **Agent name** or **Name · Title** (see [Agent Label Mode](https://agentsroom.dev/docs/agent-label-mode.md)).
   - **Source**: **All**, **Local**, **Remote**, **Cloud**. Only shown when agents of another computer or cloud runs are listed.
3. Click outside the panel or press Escape to close it.

Agents started by another agent sit under it as a tree, whatever the sort: see the question below.

The button is tinted with a dot as long as the history, the label or the source is not on its default, so a filtered list never looks empty by mistake. The sort does not count: it reorders without hiding anything.

## Settings

- `agentLabelMode` (project, Display and filters > Agent label): see [Agent Label Mode](https://agentsroom.dev/docs/agent-label-mode.md).
- `agentListSort` (project, Display and filters > Sort): `activity` (default) or `group`. Kept per project on your account, like the label and the history, so it follows you on your other computers.
- **Agent history** is kept per project, like the label. **Source** is kept per project while the app runs (since 2026-11-04): it survives going to another project and back, and comes back to **All** after a restart, or when no agent of that kind is left in the list.

## Agent tools (MCP)

- `settings_set` with `scope: "project"` and key `agentLabelMode` for the label, `agentListSort` for the sort.

## Providers

All providers, no difference.

## Mobile

Not on the phone: its agent list has no toolbar. It reads the project's label and history from your account. The tree of spawned agents is shown there too.

## Limits

- The **Sort** row follows the **View tabs** element of the interface mode: hidden, the list keeps its order.

## Common questions

- **Where did the Activity / Groups switch go?** Into **Display and filters** (sliders icon at the end of the agent search field), row **Sort**.
- **Where are the history and label buttons of the search field?** Same panel, rows **Agent history** and **Agent label**.
- **Where is the All / Local / Remote / Cloud bar?** Same panel, row **Source**, shown when such agents exist.
- **Why is an agent shifted right under another one?** Since 2026-10-27, an agent started by another agent (`agents_spawn`), and a QA Bot started by `run_qa_test`, sits under the agent that launched it with a branch line, up to three levels deep. In **Activity**, the whole family is filed in the section of its most urgent member; in **Groups**, a child nests only when its parent is in the same group. Pinning the top agent pins its family. The counters on top still count each agent by its own state, and a filtered view nests a child only when its parent is in the filter too. A fork is not nested: it sorts on its own.
- **Does the app remember Groups?** Yes: since 2026-10-29 the **Sort** is saved per project and comes back after a restart. Before, it went back to **Activity** each time the project was opened.
- **Why is the sliders button orange with a dot?** One of history, label or source is not on its default: open the panel to see which.

## Related

- [Agent Label Mode](https://agentsroom.dev/docs/agent-label-mode.md): the **Agent label** row.
- [Agent Row Action Dock](https://agentsroom.dev/docs/agent-row-dock.md): the actions of each agent, also on the right of the list.
- [Agent Suggestions](https://agentsroom.dev/docs/agent-suggestions.md): the sparkle next to the button.
- [AgentsRoom MCP](https://agentsroom.dev/docs/agentsroom-mcp.md): `agents_spawn` and the follow-up tools of spawned agents.
