# Agent roster and settings

See every agent on the team, and change one agent's model, instructions, tools and schedule, with a history of changes.

For: Admins and agent owners.

Web page: https://candor.themethodic.com/screens/agent-settings

## Layouts

### Roster, then a settings page

Pick it when: The default: the roster is a table; each agent has its own settings page.

Layout: A roster table of agents with role, model and a two-week run strip; beside it, the open agent's settings in sections.

Items:

- **Agent roster** (`agent-roster`, Pro; https://candor.themethodic.com/docs/agent-roster.md): Every agent on the team: role, model, whether it's on, and two weeks of runs.
- **Settings layout** (`settings-layout`, Pro; https://candor.themethodic.com/docs/settings-layout.md): Grouped sections down the side and the open one beside them.
- **Model settings** (`model-settings`, Pro; https://candor.themethodic.com/docs/model-settings.md): Which model an agent uses and how hard it thinks.
- **Instructions editor** (`instructions-editor`, Pro; https://candor.themethodic.com/docs/instructions-editor.md): Standing instructions, with variables filled in per run.
- **Tool permissions** (`tool-permissions`, Pro; https://candor.themethodic.com/docs/tool-permissions.md): Per tool: always, ask first or never.

```bash
npx candor-ui add agent-roster settings-layout model-settings instructions-editor tool-permissions
```

### Cards with a drawer

Pick it when: A small team of agents where the faces matter and settings are quick.

Layout: Agent cards in a grid; the selected one opens settings in a side panel.

Items:

- **Agent roster** (`agent-roster`, Pro; https://candor.themethodic.com/docs/agent-roster.md): The agents.
- **Agent avatar** (`agent-avatar`, free; https://candor.themethodic.com/docs/agent-avatar.md): A glyph and hue by role.
- **Side panel** (`side-panel`, Pro; https://candor.themethodic.com/docs/side-panel.md): The settings drawer.
- **Permission mode** (`permission-mode`, Pro; https://candor.themethodic.com/docs/permission-mode.md): The mode, with what it lets the agent do.

```bash
npx candor-ui add agent-roster agent-avatar side-panel permission-mode
```

### Settings with versions

Pick it when: Instructions and tools change often and people need to see what changed and go back.

Layout: The editor on the left and the list of live, draft and past versions on the right.

Items:

- **Instructions editor** (`instructions-editor`, Pro; https://candor.themethodic.com/docs/instructions-editor.md): The editor.
- **Version history** (`version-history`, Pro; https://candor.themethodic.com/docs/version-history.md): Live, draft and past versions, newest first.
- **Schedule list** (`schedule-list`, Pro; https://candor.themethodic.com/docs/schedule-list.md): Recurring jobs, in plain words.
- **Agent admin** (`agent-admin`, Premium; https://candor.themethodic.com/docs/agent-admin.md): The block: tools, model, versioned instructions and the routes that save them.

```bash
npx candor-ui add instructions-editor version-history schedule-list agent-admin
```

## Rules that matter most here

- **A control that can't be used says why** (https://candor.themethodic.com/principles#locked-says-why): A setting this person can't change shows its value and says why.
- **Say what can and can't be undone** (https://candor.themethodic.com/principles#say-what-can-be-undone): Publishing instructions says which version goes live and that the last one stays in history.
- **The agent is always named, by the app** (https://candor.themethodic.com/principles#agents-are-named): Each agent has the name and role your app gave it; the model doesn't choose its own.

A full-stack block builds this with an agent route and a store: `agent-admin` (https://candor.themethodic.com/docs/agent-admin.md). Each block has a `-claude` twin for the Claude Agent SDK.

## Brief for a coding agent

Paste this to the agent that builds the screen.

```text
Build an agent roster and settings with Candor UI. Start from the agent-admin block (agent-admin-claude for the Claude Agent SDK) for the routes that save changes.
AgentRoster lists every agent with its role, model, on or off, and two weeks of runs. Open an agent in SettingsLayout.
Sections: ModelSettings, InstructionsEditor (with variables like {{workspace.name}}), ToolPermissions and ScheduleList.
VersionHistory shows live, draft and past versions; publishing says which version goes live and the earlier one stays available.
Wrap a setting this person can't change in Locked so it shows why.
Name agents from your app's data (AgentAvatar), never from the model.
A new tool starts as ask first.

Start from the "Roster, then a settings page" layout: A roster table of agents with role, model and a two-week run strip; beside it, the open agent's settings in sections.
Candor items: agent-roster (https://candor.themethodic.com/docs/agent-roster.md), settings-layout (https://candor.themethodic.com/docs/settings-layout.md), model-settings (https://candor.themethodic.com/docs/model-settings.md), instructions-editor (https://candor.themethodic.com/docs/instructions-editor.md), tool-permissions (https://candor.themethodic.com/docs/tool-permissions.md).
Install: npx candor-ui add agent-roster settings-layout model-settings instructions-editor tool-permissions
Read each item's docs before using it and take its props from there; don't guess them. Pro and Premium items need the person's licence key, which they add with `npx candor-ui key <key>`; don't ask for it.
```