Automate repetitive work in herdr
You retype the same sequence every day: run the tests, read the diff, ask an agent to review it. herdr-workflows is a herdr plugin that writes that sequence once, as a short YAML file, and starts it from a hotkey. Each step does one of four things:
| Step | What it does |
|---|---|
run: |
Runs a local command and captures its output |
agent: |
Starts a coding agent, sends a prompt, waits for it |
herdr: |
Calls one herdr API method |
workflow: |
Runs another workflow as a child |
# .hwf/workflows/review.yaml
version: v1alpha1
steps:
- id: diff
run: [git, diff, HEAD]
- agent: |
Review this diff. Blocking issues only.
{{steps.diff.stdout}}
using: claude
when: "{{steps.diff.stdout}}"
pane:
open: besideThis workflow reads your diff, then opens Claude in a split pane for a review. It skips the review when the diff is empty. Press prefix+k to run it.
Important
A workflow file is code that you choose to run. There is no sandbox. Read a workflow before you run it, especially one that another person shared.
You need herdr 0.8.2 or later on Linux or macOS. Windows uses WSL2.
herdr plugin install aorumbayev/herdr-workflows
cd your-repo
hwf inithwf init writes the agents on your PATH into .hwf/config.yaml as profiles. The install page covers PATH setup, updates, and config layers.
| Command or key | What it is for |
|---|---|
prefix+k |
Pick and run a workflow. Ctrl+P opens the actions palette |
hwf run <name> |
Run from a terminal or a script, with --input name=value |
hwf console |
Full-screen console with diagrams and run history |
hwf help |
List every command |
Run and manage covers the rest.
Run hwf skills show herdr-workflow-create and hand the text to your agent. The guide has a prompt to paste.
MIT