← back to side a
herdr Port Labels preview

TRACK 1

herdr Port Labels

A terminal plugin for herdr. Shows which pane is running a dev server, and on which port.

open source·design+build·2026

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.

  • 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.

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.

read(opens in a new tab)
Runtime
Node.js 22 · TypeScript, no build step
Detection
lsof · ps
Host
herdr plugin API
Tests
node --test