Skip to content

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

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.

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.