Clankie herdr plugin

Clankie's UI surfaces inside herdr, declared through herdr's plugin v1 manifest. Everything else about Clankie's herdr integration is plain vanilla CLI and socket API — this plugin carries only what a plugin can uniquely declare: panes, keybindable actions, and (in the future) event hooks (ADR 0139).

The plugin is optional: Clankie runs the same without it. Linking it puts his board, console, and status report one keystroke from any herdr workspace.

What you get

Setup

Requirements: macOS (the manifest declares platforms = ["macos"]), herdr 0.7.3 or newer, and two commands on PATH — clankie (pnpm cli:install symlinks it into ~/.local/bin) and herdr-lead (the board CLI from the herdr-lead skill).

Link this directory from the root of your checkout:

herdr plugin link "$PWD/integrations/herdr-plugin"

An installed release ships the same directory. clankie doctor reports herdrPlugin.bundlePath when it is present; link that path instead of a checkout.

herdr records an absolute path and loads plugins when the server starts, so restart the herdr server after linking, and relink (herdr plugin unlink clankie, then link again) if the checkout moves.

Then confirm it took:

pnpm doctor                                # the `herdr plugin` row says linked and enabled
herdr plugin list --plugin clankie         # registry entry and manifest path
herdr plugin action list --plugin clankie  # both actions registered
herdr plugin pane open --plugin clankie --entrypoint board

Keybindings

herdr qualifies action ids as clankie.<id>. Bind them in ~/.config/herdr/config.toml:

[[keys.command]]
key = "prefix+b"
type = "plugin_action"
command = "clankie.board"
description = "herdr-lead board"

[[keys.command]]
key = "prefix+shift+b"
type = "plugin_action"
command = "clankie.focus-board"
description = "jump to/from the board"

Unbound actions still run from herdr's plugin menu or from the CLI: herdr plugin action invoke board --plugin clankie.

Troubleshooting