Agent List Display and Filters

  • Desktop app
  • All plans

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 for the title of the last conversation).
    • Agent label: Task title (default), Agent name or Name · Title (see Agent Label Mode).
    • 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.
  • 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.