Colors and spacing

Herdr looks fine out of the box. Dave changed two things. The state colors, so a blocked agent does not look like an error, and the sidebar layout, so each entry gets two lines.

How it works

Herdr reads one config file. It is optional. Print every default with herdr --default-config, and apply an edit to the running server with herdr server reload-config.

Three sections matter here:

• [theme] picks a built-in theme. [theme.custom] overrides single colors. Agent states use the named colors, so red is blocked, yellow is working, and teal is done.
• [ui] holds sidebar sorting, status indicators, and general behavior.
• [ui.sidebar.agents] and [ui.sidebar.spaces] decide which fields show on each sidebar row. rows is a list of lines, each line a list of fields.

Every key is in the config reference.

Dave's setup

Blocked and done share one blue. Working is violet. Blue means look at me, violet means wait. Every sidebar entry gets two lines, state and workspace on the first, tab or branch on the second.

[theme.custom]
red = "#4e82ef"     # blocked, needs input
teal = "#4e82ef"    # done, not seen yet
yellow = "#a78bfa"  # working
active_row_bg = "#45475a"

[ui]
agent_panel_sort = "priority"
prompt_new_tab_name = false
status_indicators = "dots"
copy_on_select = false

[ui.sidebar.agents]
row_gap = 1
rows = [
  ["state_icon", "workspace"],
  ["tab"],
]

[ui.sidebar.spaces]
row_gap = 1
rows = [
  ["state_icon", "workspace"],
  ["branch"],
]

[ui.sound]
enabled = false

• agent_panel_sort = "priority" puts blocked agents at the top, then done, then working.
• prompt_new_tab_name = false skips the name dialog on a new tab. The auto title plugin names it.
• status_indicators = "dots" shows a colored dot instead of the state word.
• copy_on_select = false keeps a mouse selection on screen until you copy it.

The [keys] half of the same file is on the keyboard page.

Check

Run herdr server reload-config. Sidebar rows should be two lines each, and a blocked agent should show a blue dot.