Reasonix × Herdr

A native Reasonix plugin that makes Reasonix visible and controllable inside Herdr.

What it provides

• Live working, blocked, and idle Reasonix state in Herdr.
• A bundled herdr skill for workspace, tab, pane, and agent control.
• Herdr actions that open Reasonix in a split or a new tab.
• A doctor action that verifies both plugin registrations and the live socket.
• No model prompts, tool arguments, or tool results are sent to Herdr. Only a short lifecycle status and approval/attention label are reported.

Install

Install from GitHub (recommended)

Herdr can install plugins directly from GitHub in one command:

herdr plugin install uuie/reasonix-herdr

This clones the repo, runs any build steps, registers the plugin, and keeps the checkout managed by Herdr. Reinstall from the same source to update.

The plugin is discovered automatically on herdr.dev/plugins via the herdr-plugin GitHub topic.

Dev / linked install

For local development, link the working directory instead:

herdr plugin link /path/to/reasonix-herdr

Restart Reasonix after installing so it loads the lifecycle hooks.

Verify

herdr plugin list --plugin reasonix-herdr --json
herdr plugin action invoke doctor --plugin reasonix-herdr

Use

The launcher actions register Reasonix immediately. If you run reasonix manually in a Herdr pane, its first lifecycle event (such as a prompt or new session) registers it. Use either launcher action for the smoothest start:

herdr plugin action invoke start-split --plugin reasonix-herdr
herdr plugin action invoke start-tab --plugin reasonix-herdr

Ask Reasonix to use its herdr skill when you want it to inspect sibling agents, split panes, run commands, or wait for another agent.

Scope of the integration

Herdr 0.7.3 plugins cannot add a new built-in detector, integration-install target, or native session-resume adapter. This package uses Herdr's supported agent lifecycle API, so live labels, state, notifications, persistence across detach/reattach, and orchestration work. Automatic Reasonix conversation resume after a full Herdr server restart requires upstream support in Herdr and a Reasonix hook payload that exposes a resumable session reference.

Remove

reasonix plugin remove reasonix-herdr
herdr plugin unlink reasonix-herdr