Official palettes
Install the bundled palettes with vellum palettes sync. Existing files remain untouched; --overwrite deliberately replaces them. Vellum refuses to overwrite symlink targets.
| Palette | Dependencies | Enter behavior |
|---|---|---|
herdr-workspaces |
herdr; actions use hwt and gh |
Focus workspace |
herdr-agents |
herdr |
Output agent pane ID |
files |
fd and a Nerd Font |
Output file path |
Herdr workspaces
Section titled “Herdr workspaces”Refreshes every second and renders aligned two-line workspace records. Ctrl-G filters working, done, idle, blocked, and unknown statuses. Enter focuses a workspace. Ctrl-A opens actions to remove eligible HWT worktrees, open repositories, and view pull requests or checks. GitHub PR actions appear only when an availability probe finds a pull request.
Herdr agents
Section titled “Herdr agents”Refreshes every 750ms and renders three-line agent records with normalized Herdr status colors. It outputs a pane ID so another command can focus or otherwise compose with the selected agent.
Runs fd directly, renders a compact filetype icon and path, and outputs the selected path.
The repository also contains opt-in examples/herdr-agents-icons.toml and examples/herdr-workspaces-icons.toml. Their private-use glyphs require a compatible patched font, so they are not official defaults.
