AgentBox — Herdr plugin

A Herdr plugin for AgentBox. It adds, to your Herdr session:

• a boxes overlay (prefix+a) — a live list of all your AgentBox sandboxes (agentbox list --herdr --watch)
• a new box shortcut (prefix+shift+a) — start a box in the current project
• an agentbox:// Ctrl+click link handler — open a box's web app straight from the terminal

This repo is the marketplace-discoverable mirror of the plugin. The plugin's source of truth lives in the AgentBox monorepo (apps/cli/src/commands/install-herdr.ts); herdr-plugin.toml and build.sh here are kept byte-identical to it.

Install

From the Herdr marketplace

herdr plugin install madarco/agentbox-herdr-plugin

On install, build.sh runs agentbox install herdr --plugin-keys, which writes the shim and wires the keybindings. If the AgentBox CLI isn't on your PATH yet, the plugin still installs (inert) and tells you how to finish:

npm i -g @madarco/agentbox && agentbox install herdr

With the AgentBox CLI already installed

npm i -g @madarco/agentbox && agentbox install herdr

This generates the same plugin under ~/.agentbox/herdr/plugin and links it directly — no marketplace round-trip needed.

How it works

Herdr runs plugin commands as a bare argv with no shell expansion and an unreliable PATH (e.g. under nvm). So AgentBox commands route through a small agentbox-shim.sh, written at install time with the absolute path to your AgentBox CLI — which keeps herdr-plugin.toml fully static and committable.

Keybindings are not declared in the manifest (Herdr ignores manifest keys); they're spliced into your ~/.config/herdr/config.toml by the install step. Remove them any time with herdr config reset-keys.

License

MIT — see LICENSE.