herdr plugin · linear yaml

Workflows for the herd.

Automate repetitive actions in herdr with simple YAML workflows. Anything you can do by hand in herdr becomes a short, shareable YAML snippet.

Quick start Examples

Needs herdr ≥ 0.8.2

get running

Install, init, run

Two commands, one file. Then prefix+k (herdr's prefix key, then k) runs it.

$herdr plugin install aorumbayev/herdr-workflows

$cd your-repo && hwf init

Install has the requirements, the WSL2 note, and the config.

Save this as .hwf/workflows/scratch.yaml

version: v1alpha1
steps:
  - run: [lazygit]
    pane:
      open: tab
    background: true

Press prefix+k, pick scratch, then press Enter. A lazygit tab opens — swap lazygit for any command you have.

surfaces

Pick how you work

prefix+k

Pick a workflow and run it. Ctrl+P opens actions: create, import, edit, share, delete.

hwf run

The same runner from a terminal or a script, with --input name=value.

Console

Full-screen Charm TUI. From the picker, press Ctrl+P then c. Or run hwf console. See Run and manage.

from the herd

Ready-made workflows

adversarial-revise, branch-check, handoff, prompt-enhance, remote-branch-log, review-gate, and worktree ship with the plugin. Copy one command, read what it contains, and it's yours.

Browse examples