pi-herdr-status

Reports pi active model and status metadata to Herdr's sidebar agents panel without colliding with other extensions.

Packages

Package details

extension

Install pi-herdr-status from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-herdr-status
Package
pi-herdr-status
Version
0.2.1
Published
Aug 24, 2026
Downloads
818/mo · 221/wk
Author
dereknex
License
MIT
Types
extension
Size
17.2 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-herdr-status

A pi extension that reports active model and status metadata to Herdr's sidebar agents panel.

Uses Herdr's pane.report-metadata socket/CLI API with --token model_info=<value> under a dedicated --source pi-model namespace to prevent collisions with other plugins (such as gh-pr).

Features

  • Model Synchronization: Automatically updates Herdr's sidebar status whenever the model changes (on startup, session restore, /model, or Ctrl+P).
  • Agent State Reporting: Automatically syncs agent lifecycle states (working, blocked for waiting user confirmation, idle) to Herdr's sidebar.
  • Multi-Pane Aware: Accurately targets the current pane using HERDR_PANE_ID.
  • Collision-Free: Uses --source pi-model and --token model_info=<value> to isolate metadata.
  • Graceful Cleanup: Clears model_info token on session shutdown.

Installation

pi install npm:pi-herdr-status

Herdr Configuration

Add model_info to your [ui.sidebar.agents.rows_by_agent] configuration in ~/.config/herdr/config.toml:

[ui.sidebar.agents.rows_by_agent]
pi = [
  ["state_icon", "workspace", "tab"],
  ["agent", "model_info"]
]

License

MIT