herdrcheatsheet

The Herdr cheatsheet

The most-used keybindings and CLI commands for Herdr, the terminal workspace manager. Click any key or command to copy it.

Install Herdr

global · one line

Pick one method. The binary lands on your PATH.

curl curl -fsSL https://herdr.dev/install.sh | sh
brew brew install herdr
mise mise use -g herdr
windows powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"
Verify: herdr --version Launch: herdr

Agent setup prompt

paste once

One prompt to install Herdr globally and teach your agent the CLI via the official SKILL.md.

Set up Herdr on this machine and teach yourself how to drive it.

1. Install the Herdr binary globally.
   - macOS/Linux with Homebrew:    brew install herdr
   - macOS/Linux without Homebrew: curl -fsSL https://herdr.dev/install.sh | sh
   - Windows (preview):            powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"
   Verify with: herdr --version

2. Install the official Herdr agent skill so you know the CLI inside a Herdr pane.
   Save and read the skill file:
     curl -fsSL https://raw.githubusercontent.com/ogulcancelik/herdr/master/SKILL.md \
       -o ~/.claude/skills/herdr/SKILL.md
   Then READ that file and keep these invariants:
   - Only run `herdr` CLI commands when HERDR_ENV=1 (from inside a herdr pane).
   - IDs compact when panes/tabs close; always re-read fresh IDs before reuse.
   - `pane run` = text + Enter atomically; `wait output` blocks for future output;
     `pane read` shows current output.
   - Prefix is Ctrl+B; prefix+q detaches, prefix+v splits right, prefix+c new tab,
     prefix+w workspace picker.

3. Report back: installed version, where the skill file landed, and how to launch
   (run `herdr`) and detach (Ctrl+B, then q).
Prefix
Ctrl+B
Press the prefix, release, then press the action key. Example: Ctrl+B then v splits right. Mouse works for everything too.

About

A single-file, print-friendly cheatsheet of the most-used Herdr keybindings and CLI commands. Everything lives in one self-contained index.html — no build step. Not affiliated with Herdr; built from the official docs.

Copied!