
herdr Port Labels
A terminal plugin for herdr. Shows which pane is running a dev server, and on which port.
THE PITCH
herdr is a terminal runtime for coding agents. Run a few agents in parallel and you end up with a few dev servers.
Soon nobody remembers which pane owns port 5174.
The plugin puts the answer where you are already looking: a bolt on the tab, the port on the pane border, and every port of a workspace in the sidebar.
WHAT I DECIDED
Process tree, not command names.
Any TCP listener started from a pane counts: vite, next dev, rails, kubectl port-forward. Nothing to configure, and no list of known commands to maintain.
Display only.
It labels and never stops a process. Uninstalling restores every label it changed.
Readable by agents.
Ports are published as pane metadata, so an agent can check which ports are taken before it starts a server.
Say what it misses.
Docker ports, daemonized servers, and anything started outside herdr are not detected. The README lists them.
ALSO APPEARS ON
herdr-worktree-setup, a community plugin that prepares a new worktree: copy .env, install dependencies.
A new worktree looked ready while the install was still running. My pull request reports setup status in the sidebar: running, done, or failed. Merged in September 2026.
INSTRUMENTS
- Runtime
- Node.js 22 · TypeScript, no build step
- Detection
- lsof · ps
- Host
- herdr plugin API
- Tests
- node --test