Back to blog
Nov 04, 2026
4 min read
Herdr Zoom Indicator: Know When a Pane Is Zoomed

Herdr Zoom Indicator: Know When a Pane Is Zoomed

Herdr's built-in zoom marker is a tiny Z on the tab — easy to miss and confusing when agents act on the wrong pane. I built a plugin that paints a 💠 in the tab bar and sidebar rows while the active pane is zoomed, driven by a status command and a five-second expiry.

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_right already exists, merge into the existing array — don’t add a second [ui] block.
  • The command must stay in tab_bar_right even 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.