Home

StructuPath Herdr Plugins

Four plugins for Herdr, the terminal agent multiplexer — built and maintained by StructuPath. All four are public, marketplace-listed (they carry the herdr-plugin topic), and verified on herdr 0.7.5.

Plugin	ID	Repo	Purpose
Browser	structupath.browser	herdr-browser	A live, drivable web browser inside a Herdr pane
Guard	structupath.guard	herdr-guard	Cross-agent command policy: audit, alert, interrupt
Swarm	structupath.swarm	herdr-swarm	Run N identical agents in parallel, safely, worktree-per-agent
Conductor	structupath.conductor	herdr-conductor	Orchestrate a role-differentiated feature team as visible agent panes

Swarm vs Conductor: Swarm fans out N interchangeable agents into git worktrees and you keep the best result. Conductor runs a team of different roles (builder, validator, reviewer…), each a real attachable pane, driven by an orchestrating agent.

The three orchestration plugins compose:

CONDUCTOR decides  →  SWARM isolates          →  GUARD enforces
(role dispatch)       (worktree per writer)      (command policy / audit)

Install

herdr plugin install StructuPath/herdr-browser
herdr plugin install StructuPath/herdr-guard
herdr plugin install StructuPath/herdr-swarm
herdr plugin install StructuPath/herdr-conductor

For development, clone a repo and herdr plugin link . — disk edits stay live.

Health checks (all four)

herdr plugin list          # installed + enabled? shows source path
herdr plugin action list   # proves the action scripts actually registered
herdr plugin log list      # per-command logs: exit codes / stderr from failed actions
herdr status server        # is the herdr server up

enabled in plugin list means the manifest parsed; action list means the scripts are wired in. Both green = healthy. A plugin pane shows a label in herdr pane list (plain terminals show none) — that's the tell it's plugin-owned and rendering.

Invoke any action manually:

herdr plugin action invoke <action_id> --plugin <plugin_id>

Exception: swarm fanout can not be action-invoked — panes spawned by the herdr server don't inherit the caller's environment. Use the TUI menu, or run the fan-out pane script directly (see Swarm).

Common ground

• Config: ~/.config/herdr/ (config.toml; plugins.json is the package registry).
• Keybindings: Herdr plugins cannot ship default keybindings — add your own [[keys.command]] entries in config.toml (examples on each plugin page).
• Docs: each repo's README.md is the authoritative reference; these wiki pages are the practical guide.
• License: MIT © StructuPath, all four.