herdr-cowbell
A herdr plugin that shows each tab's agent status as an icon in front of the tab name. herdr's tab bar draws only the tab label and has no per-tab icon slot, so cowbell renames the tabs.
- Three states in the default preset:
◐ working, ? blocked (waiting for you), ✓ done and not seen yet. Idle and unknown agents show nothing.
- Five presets:
ask, symbols, emoji, nerd and custom (your own icons).
- Actions for on/off, off and remove icons, refresh and next preset, which you can bind to a key.
- An optional spinner (off by default). No dependencies: Node 18 or newer only, no npm packages, no build step.
Install
herdr plugin install dvoraj75/herdr-cowbell
Requirements: herdr 0.9.2 or newer, Node 18 or newer on PATH as node, Linux or macOS.
Install does not start the daemon. It starts at the next herdr server start or when an agent is detected in a pane. The Quickstart below starts it right away. For pinning a version and updating, see Install & update.
Quickstart
The first press of Cowbell: on/off starts cowbell. If cowbell already runs (for example after herdr detected an agent), a press switches it off; press again to turn it back on. Bind it to a key in your herdr config.toml:
[[keys.command]]
key = "prefix+shift+b"
type = "plugin_action"
command = "dvoraj75.cowbell.toggle"
description = "cowbell on/off"
Then run herdr server reload-config. It applies the binding without a restart. Avoid prefix+b: it is herdr's default sidebar toggle, and a plugin binding on it silently replaces that toggle (see Actions & key bindings).
The default preset ask shows ◐ ? ✓. Cowbell: next icon preset cycles through the others. See Configuration & presets.
Tabs you never named (auto-named tabs) are left alone unless include_auto_named is true; see Configuration & presets.
Before you uninstall or disable cowbell, run Cowbell: off and remove icons; see Uninstalling.
Documentation
Contributing, security, support
License
MIT, see LICENSE.
