Herdr Plannotator

Herdr Plannotator opens Plannotator's existing review page in a Herdr Browser pane. Plannotator still owns approvals, feedback, and agent behavior. This plugin only changes where the page appears.

Requirements

• Herdr 0.7.5 or newer
• A Plannotator release with external presenter support
• Herdr Browser, installed and enabled
• Bun
• Google Chrome or Chromium
• Herdr's experimental Kitty graphics support

Install Browser first:

herdr plugin install ogulcancelik/herdr-browser --yes

Run the same command again if your installed copy predates Browser's initial URL support.

Enable graphics in Herdr's configuration:

[experimental]
kitty_graphics = true

Then reload Herdr:

herdr server reload-config

Install

Install the plugin and connect it to Plannotator:

herdr plugin install plannotator/herdr-plannotator --yes
herdr plugin action invoke configure --plugin official.plannotator

Plugin actions run asynchronously. Repeat the following command until the latest configure record has status succeeded; stop and inspect its error if the status is failed:

herdr plugin log list --plugin official.plannotator --limit 1

Then run Doctor and wait for its log record the same way:

herdr plugin action invoke doctor --plugin official.plannotator
herdr plugin log list --plugin official.plannotator --limit 1

Configuration preserves the rest of ~/.plannotator/config.json. It records the previous presenter value so unconfiguration can restore it. If you change the presenter yourself afterward, unconfiguration leaves your replacement alone.

PLANNOTATOR_PRESENTER, when present in the agent environment, overrides this file-based configuration; an empty value disables external presenters. Unset it or point it at the managed presenter reported by the configure action.

If PLANNOTATOR_DATA_DIR is relative, configuration resolves it from the focused Herdr pane's working directory. Invoke the action with a focused pane, or use an absolute or ~/... path.

How it works

When Plannotator has a page ready, it runs the plugin's presenter helper with one JSON request. The helper asks Herdr to open a focused, zoomed official.browser pane at Plannotator's local URL. Herdr returns the pane ID. When the review finishes, the helper closes that pane. Browser closes its own view when the pane exits.

The helper never interprets approval or feedback. The existing Plannotator server receives those choices directly from its web page.

Remove the integration

Run unconfigure before uninstalling the plugin:

herdr plugin action invoke unconfigure --plugin official.plannotator

Repeat the log command until the latest unconfigure record is succeeded. Do not uninstall while it is running, and do not uninstall after a failure:

herdr plugin log list --plugin official.plannotator --limit 1

Only after that record is succeeded, uninstall the plugin:

herdr plugin uninstall official.plannotator

Development

herdr plugin link /path/to/herdr-plannotator
bun install --cwd /path/to/herdr-plannotator
bun test
bun run typecheck