T0mSIlver/herdr-main-checkout

Badge agents running on a repository's main checkout in the Herdr agent sidebar

★ 0Forks 0PythonGitHub ↗Compare

README

herdr main-checkout

Marks the agents running in a repo's main checkout, so the ones driving the work stand out from the workers in worktrees.

  ○ localvoxtral · 1 · ⌂
    Claude Code
  ● lvx-wt · 1
    opencode

Install

herdr plugin install T0mSIlver/herdr-main-checkout

Put $checkout in a sidebar row in ~/.config/herdr/config.toml and run herdr server reload-config:

[ui.sidebar.agents]
rows = [
  ["state_icon", "workspace", "tab", { token = "$checkout", dim = true }],
  ["agent"]
]

A rows_by_agent block replaces these rows, so add the token there too. Badges land on the next pane event, or now with herdr plugin action invoke main-checkout.refresh.

HERDR_MAIN_CHECKOUT_LABEL sets the badge text, ⌂ by default. A word such as orchestrator reads just as well.

docs/notes.md has the detection rule and the cases where the badge lags. MIT licensed.

Contributors

T0mSIlver

Issues