Herdr Claude Tab Title

herdr-claude-tab-title

Mirrors each Claude Code session title, and its agent state, onto its Herdr tab.

Claude Code already maintains a title for every session and revises it only when the subject of the work genuinely changes. This plugin copies that title onto the tab, so the tab bar reads like a list of what you are working on rather than a list of terminal numbers.

Herdr marks agent state in its sidebar but leaves the tab bar plain, so the same mark is written in front of the label: `✅ Fix the booking total` for an agent that finished, `🟡` while it works, `🔴` when it is blocked, `⚪` when it is idle. The mark belongs to the plugin even on a tab you named yourself, so the state of every agent is readable without opening the sidebar.

No model, no API key, no prompt. Reading a title costs nothing, so there is no rate limit and no configuration you have to fill in before it works.

Install

Requires Herdr 0.7.5+ and Bun.

herdr plugin install tmn73/herdr-claude-tab-title
herdr plugin action invoke start --plugin claude-tab-title

That `start` is only needed for the current session. From then on Herdr starts the worker itself once its API socket is ready, so it survives a restart.

On a fresh install it may look like nothing happens, and that is deliberate: a tab that already carries a name is treated as yours and left alone. New tabs get titled as they appear. To hand your existing tabs over too, once:

herdr plugin action invoke reclaim --plugin claude-tab-title

For local development, point Herdr at a checkout instead:

herdr plugin link /path/to/herdr-claude-tab-title

Actions

Action	Effect
start / stop / status	Control the sync worker
sync	Apply titles to every tab now
dry-run	Report what a sync would change, without changing it
reclaim	Resume managing tabs you had renamed by hand
config	Print the config file path and the settings in effect
logs	Prin