I keep a lot of panes open in Herdr — one per agent, per server, per test run. Zoom is how I focus on one of them. The problem: once a pane is zoomed, the only hint is a tiny Z on its tab. Miss it and you forget the layout is “lying” to you: the other panes are still there, still running, and an agent pointed at the wrong pane does the wrong thing.
So I built Herdr Zoom Indicator — a plugin that shows 💠 on the right side of the tab bar and, optionally, in expanded Agent and Space sidebar rows while the active pane is zoomed.
How it works
Herdr’s config supports a tab_bar_right command: a script whose stdout is rendered in the tab bar on an interval. The plugin ships status.sh, a tiny sh + jq script that asks Herdr for the active pane’s zoom state and prints 💠 or nothing.
The setup action copies status.sh into the plugin’s config directory (it also runs at server startup, so plugin updates stay in sync):
herdr plugin install riogesulgon/herdr-zoom-indicator
herdr plugin action invoke herdr-zoom-indicator.setup
herdr plugin config-dir herdr-zoom-indicator
Then register it in ~/.config/herdr/config.toml:
[ui]
tab_bar_right = [
{ type = 'command', command = 'sh /absolute/plugin-config-directory/status.sh', interval_seconds = 2, timeout_seconds = 1 },
]
Sidebar markers are simpler: drop the $zoom token into your row layouts. Each row accepts at most 16 tokens, so merge it into what you already have:
[ui.sidebar.agents]
rows = [["$zoom", "state_icon", "agent"]]
[ui.sidebar.spaces]
rows = [["$zoom", "state_icon", "workspace"]]
The command refreshes its metadata every two seconds and the markers expire after five seconds — that expiry is what keeps the UI honest when you change focus.
Gotchas worth knowing
- TOML has no duplicate keys. If
tab_bar_rightalready exists, merge into the existing array — don’t add a second[ui]block. - The command must stay in
tab_bar_righteven if you only want sidebar markers. It is what supplies their metadata. - The status command must not use
--current. It runs through Herdr’s status-command context, not a pane context. - Config managers can clobber your blocks. Tools like Herdr Radar rewrite the config sections they manage during reconfiguration or appearance changes — re-check your rows after using one.
Apply everything with herdr server reload-config and the 💠 appears the moment you zoom.
Why the built-in Z isn’t enough
The Z marker stays — the plugin only adds to it. But tab markers fail silently in two common cases: the tab strip is crowded enough that a one-character badge disappears, and the sidebar (where I actually look while agents work) showed no zoom state at all. A bright marker in the row I’m already reading is worth the small polling script it takes to feed it.
The plugin needs Herdr 0.9.5+, sh, and jq, and runs on Linux and macOS. Source is at riogesulgon/herdr-zoom-indicator — it is also listed on the Herdr plugin marketplace, which auto-discovers anything tagged herdr-plugin on GitHub.
