herdr-agent-state

Configuration

Configuration reference

Field	Type	Default	Meaning
agent	string	'dsh'	The Herdr agent label reported for the pane. Set a frontend's own name (e.g. blue) so Herdr's sidebar groups it under that label.
source	string	'herdr:dsh-agent-state'	Stable, unique integration source. Herdr attributes the pane's lifecycle authority to this source. Keep it constant. Changing it makes Herdr treat the pane as a different authority mid-session.
transport	'socket' | 'cli'	'socket'	How to report to Herdr. Only socket is implemented (speaks the pane socket directly). cli is declared but not yet implemented — it throws at load, so don't set it.
reportSession	boolean	true	Report the pane's session reference (agent_session_id) so Herdr can expose it for restore. Set false to suppress session reporting.
title	'session' | 'none'	'session'	Which title to publish as the Herdr pane title (display-only metadata). session mirrors the dsh session title — first-prompt fallback, LLM-generated, or pinned by /rename; none disables title reporting.
message	'tool' | 'none'	'tool'	Whether to attach a human label to blocked reports. tool sends the tool name / question summary; none sends blocked with no message.
workingMessage	'tool' | 'none'	'tool'	Whether to attach the currently-executing tool name to working reports.
tokens	'auto' | 'none'	'auto'	Report the model and ctx (context usage used/window) tokens as Herdr Agent-sidebar metadata. none disables.
stateLabels	{ idle?, working?, blocked?, done?, unknown? }	{}	Display text per Herdr state; non-blank entries are sent as pane state labels.
enabled	boolean	true	Kill-switch. Set false to disable the reporter in this tree — useful to coexist with another reporter.

How to configure it

The plugin is a bundle row labelled herdr-agent-state, so it is inserted automatically when you dsh plugin add. Because its Config schema gives every field a default, you only set what you want to change; the schema fills the rest. A profile's cordis.patch.yml is a top-level YAML array of loader patch entries, so you target the row by id and replace its config:

### Configuration reference

| Field | Type | Default | Meaning |
| --- | --- | --- | --- |
| `agent` | string | `'dsh'` | The Herdr agent label reported for the pane. Set a frontend's own name (e.g. `blue`) so Herdr's sidebar groups it under that label. |
| `source` | string | `'herdr:dsh-agent-state'` | Stable, unique integration source. Herdr attributes the pane's lifecycle authority to this source. **Keep it constant.** Changing it makes Herdr treat the pane as a *different* authority mid-session. |
| `transport` | `'socket'` \| `'cli'` | `'socket'` | How to report to Herdr. Only `socket` is implemented (speaks the pane socket directly). `cli` is declared but not yet implemented — it throws **at load**, so don't set it. |
| `reportSession` | boolean | `true` | Report the pane's session reference (`agent_session_id`) so Herdr can expose it for restore. Set `false` to suppress session reporting. |
| `title` | `'session'` \| `'none'` | `'session'` | Which title to publish as the Herdr pane title (display-only metadata). `session` mirrors the dsh session title — first-prompt fallback, LLM-generated, or pinned by `/rename`; `none` disables title reporting. |
| `message` | `'tool'` \| `'none'` | `'tool'` | Whether to attach a human label to `blocked` reports. `tool` sends the tool name / question summary; `none` sends `blocked` with no message. |
| `workingMessage` | `'tool'` \| `'none'` | `'tool'` | Whether to attach the currently-executing tool name to `working` reports. |
| `tokens` | `'auto'` \| `'none'` | `'auto'` | Report the `model` and `ctx` (context usage `used/window`) tokens as Herdr Agent-sidebar metadata. `none` disables. |
| `stateLabels` | `{ idle?, working?, blocked?, done?, unknown? }` | `{}` | Display text per Herdr state; non-blank entries are sent as pane state labels. |
| `enabled` | boolean | `true` | Kill-switch. Set `false` to disable the reporter in this tree — useful to coexist with another reporter. |