Keyboard
Introduction
Herdr is a terminal workspace manager for AI coding agents: persistent sessions of workspaces, tabs, and panes, with agent detection built in.
- Herdr documentation (herdr.dev)
- GitHub repository (github.com)
- Herdr concepts (herdr.dev)
Learn these first
| Shortcut | Action |
|---|---|
prefix+c | New tab |
prefix+v / prefix+minus | Split right / down |
prefix+h/j/k/l | Move between panes |
prefix+w | Workspace navigation |
prefix+q | Detach; everything keeps running |
The prefix is ctrl+b by default; prefix+? lists every active binding.
Getting started
Concepts
Layout
session
└── w1 workspace project container (one repo or task)
├── w1:t1 tab layout: agents, logs, server, review
│ ├── w1:p1 pane a real terminal; can host an agent
│ └── w1:p2 pane
└── w1:t2 tab
Commands
herdr session list # persistent server namespaces
herdr workspace list # w1, w2, ...
herdr tab list --workspace w1 # w1:t1, w1:t2, ...
herdr pane list --workspace w1 # w1:p1, w1:p2, ...
herdr pane current --current # the calling pane's ID
A pane is a real terminal, preserved across detach. An agent is a process
Herdr recognizes in a pane. A session is a persistent server namespace;
herdr attaches to the default one.
See: Concepts
Quick start
herdr # launch, or reattach to a session
claude # run an agent; Herdr detects it
Split with prefix+v, open a tab with prefix+c, and detach with prefix+q; panes and agents keep running.
See: Quick start
Command map
Layout
Workspaces and tabs
| Command | Purpose |
|---|---|
herdr workspace | Create, focus, rename, close workspaces |
herdr tab | Manage tabs inside a workspace |
Panes and worktrees
| Command | Purpose |
|---|---|
herdr pane | Split, run, read, move, close panes |
herdr worktree | Create, open, remove git worktrees |
See: CLI reference
Agents
| Command | Purpose |
|---|---|
herdr agent | Start, prompt, wait on, read agents |
herdr integration | Install agent integrations |
herdr plugin | Install, update, manage plugins |
Sessions and server
Sessions and machines
| Command | Purpose |
|---|---|
herdr session | Named sessions: list, attach, stop, delete |
herdr machine | Saved SSH machines; --machine routes commands |
Server
| Command | Purpose |
|---|---|
herdr server | Headless server; stop, reload-config, manifests |
herdr status | Show client and server state |
See: CLI reference
Utilities
| Command | Purpose |
|---|---|
herdr api | Socket API snapshot and schema |
herdr terminal | Attach to raw terminal streams |
herdr notification | Show a notification |
herdr update | Update a direct install |
herdr channel | Show or set the update channel |
herdr config | Validate config or reset keybindings |
herdr completion | Generate shell completions |
See: CLI reference
0 Comments for this cheatsheet. Write yours!