@yukikisaku/pi-herdr-status

Herdr tab status for the Pi coding agent.

Herdr tracks which of its panes is busy, but its tab labels stay as plain numbers. This extension puts the work back into the tab bar:

• Spinner on the tab label while the agent is working.
• 🔔 mark on the tab label when the agent finishes, cleared automatically once you look at that tab.
• AI-generated title as the tab label, so 1 becomes Fix OAuth callback.

Herdr already plays its own completion sound, so this extension does not add one.

Install

pi install npm:@yukikisaku/pi-herdr-status

It activates only inside Herdr (HERDR_ENV=1) and stays completely inactive anywhere else, so it is safe to leave installed on every machine.

It talks to Herdr's socket API using tab.get and tab.rename only. Herdr's own herdr-agent-state integration keeps reporting agent state; this extension never touches that.

Commands

/rename                     regenerate the tab label from the whole conversation
/rename Fix OAuth callback  set the tab label explicitly

/pi-herdr                   open the settings menu

Use the arrow keys to move, Enter or Space to change a value, and Escape to close the menu. String settings open an input screen. Changes are applied and saved immediately. Any arguments to /pi-herdr are ignored, so it always opens the same menu.

Settings live in ~/.pi/agent/pi-herdr.json.

Title generation

Titles are generated by the model the session is already running on, at low thinking effort, in the language you wrote in. Set naming-model in the settings menu to use a cheaper model instead, or clear the field to go back to the session model.

Following renames from the host

The tab label always follows the session's own title. Renames that happen outside this extension — plain Pi's /name, Oh My Pi's builtin /rename, a rename from another extension — are mirrored onto the tab label without rewriting the session. Oh My Pi announces no rename event, so its renames are picked up by a lightweight watcher that re-reads the session name once per second and only talks to Herdr when it actually changed. An explicitly set title also stops any AI-generated rename that is still in flight, so it is never overwritten afterwards.

License

MIT

Pull requests

Pull requests are handled in the pi-agent-status repository, which defines the AI review and automatic merge policy and activation conditions.