Skip to content

Plugins: the agent plugin, the skill, opencode and herdr - #5

Merged
kylemclaren merged 1 commit into
mainfrom
plugin-docs
Sep 29, 2026
Merged

kylemclaren merged 1 commit into
mainfrom
plugin-docs

Conversation

@kylemclaren

Copy link
Copy Markdown
Contributor

A new Plugins sidebar tab (/plugins, puzzle icon) documenting every plugin awp ships:

page covers
/plugins the two kinds of plugin, what each harness gets and how new messages reach its model, which to install, where they live in the repo
/plugins/agent-plugin the Claude Code / Agent Plugins package: installing with bootstrap, from a release or a checkout; layout; the launcher, MCP server and hooks; channels; other clients; update, uninstall, troubleshooting
/plugins/skill when the skill loads, what each section teaches, the file each harness gets, installing by hand, changing it
/plugins/opencode what bootstrap writes, the plugin's code and hooks, JSONC configs, gaps
/plugins/herdr install, actions, keys, popup, inbox, notifications, delivery to an idle agent, configuration, how it works, state files, troubleshooting, uninstall, limits

Also: Harnesses and Watching link to the new pages, and the release-bundle example in Harnesses is 0.6.0.

Facts were checked against awp's source on main (bootstrap, the plugin files, the herdr script) and the herdr plugin was exercised against herdr 0.9.1. bun run build passes and every internal link on the new pages resolves.

The herdr page says the plugin is on the herdr marketplace: that needs the herdr-plugin topic on agentwireprotocol/awp. Companion awp PR: agentwireprotocol/awp#29.

A new sidebar tab, /plugins, with the puzzle icon:

- an overview: the two kinds of plugin, what each harness gets and how
  new messages reach its model, which to install, where they live
- the agent plugin: parts, installing with bootstrap, from a release or a
  checkout, the layout, the launcher, MCP server and hooks, channels,
  other Agent Plugins clients, update, uninstall, troubleshooting
- the skill: when it loads, what each section teaches, the file each
  harness gets, installing and changing it
- opencode: what bootstrap writes, the plugin's code and hooks, JSONC
  configs, what it does not cover
- herdr: install, actions, keys, the popup, the inbox, notifications,
  delivering to an idle agent, configuration, how it works, files,
  troubleshooting, uninstall and limits

Harnesses and Watching link to it, and the release bundle example is
0.6.0.
@kylemclaren
kylemclaren merged commit 57d4750 into main Sep 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant