# Agent Label Mode

> By default, an agent's card and console header show what it is working on: the session title it picked on its first turn, the backlog ticket it handles, or a name you typed.

- Area: Desktop, mobile and web
- Plans: All plans
- Last checked against the product: 2026-10-22
- Web page: https://agentsroom.dev/docs/agent-label-mode

## What it does

By default, an agent's card and console header show what it is working on: the session title it picked on its first turn, the backlog ticket it handles, or a name you typed. With many saved agents (Cody, Thrawn...) every card shows a task and you can no longer tell which agent is which. The label mode lets each project choose: the task title, the agent's name, or both ("Cody · rc.1 integration").

## Where to find it

In a project, the search field at the top of the agent list has a **tag** button (**Agent label**), next to the history button. It opens a menu with three choices: **Task title**, **Agent name**, **Name · Title**. The button is tinted while the project is on a name mode.

## How to use it

1. Click the tag button in the agent list search field.
2. Pick **Name · Title** to see the agent's name first, then its task. An agent with no task yet shows its name alone.
3. Pick **Agent name** to always see the name only, or **Task title** to go back to the default.

The agent's name is the one given at creation (or the rename), otherwise its role name. The choice applies at once to every card, the console header, the pills of the right panel and the other places that name agents in this project. Renaming the session from the console header still edits the session title only, never the composed label.

## Settings

- `agentLabelMode` (project, agent list search field > Agent label): `title` (default, task title), `name` (always the agent's name) or `both` ("Name · Title"). Stored on your account, so it follows you on your other computers and on the phone.

## Agent tools (MCP)

- `settings_set` with `scope: "project"` and key `agentLabelMode`: switch the mode for this project. `settings_get` reads it.

## Providers

All providers, no difference.

## Mobile

The phone shows the same label as the desktop (agent rows and console header) by reading the project's setting from your account. The choice itself is made on the desktop.

## Limits

- Team run steps keep their own label ("step · task"), which already names the step.
- The project assistant keeps its name whatever the mode.
- Agents still find each other by task title in the agent directory: the mode only changes what you see.

## Common questions

- **Why does my agent's tab show a task title instead of its name?** That is the default **Task title** mode. Switch the project to **Name · Title** or **Agent name** with the tag button of the agent list search field.
- **Can I see both the agent's name and what it is doing?** Yes, **Name · Title** shows "Cody · rc.1 integration".
- **Is it per project?** Yes, each project keeps its own choice, synced on your account.

## Related

- [Customize Agents](https://agentsroom.dev/docs/customize-agents.md): naming and renaming agents.
- [Agent Status Tracking](https://agentsroom.dev/docs/agent-status-tracking.md): where the session title comes from.