Keyboard

Introduction

Herdr is a terminal workspace manager for AI coding agents: persistent sessions of workspaces, tabs, and panes, with agent detection built in.

Learn these first

ShortcutAction
prefix+cNew tab
prefix+v / prefix+minusSplit right / down
prefix+h/j/k/lMove between panes
prefix+wWorkspace navigation
prefix+qDetach; 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

CommandPurpose
herdr workspaceCreate, focus, rename, close workspaces
herdr tabManage tabs inside a workspace

Panes and worktrees

CommandPurpose
herdr paneSplit, run, read, move, close panes
herdr worktreeCreate, open, remove git worktrees

See: CLI reference

Agents

CommandPurpose
herdr agentStart, prompt, wait on, read agents
herdr integrationInstall agent integrations
herdr pluginInstall, update, manage plugins

Sessions and server

Sessions and machines

CommandPurpose
herdr sessionNamed sessions: list, attach, stop, delete
herdr machineSaved SSH machines; --machine routes commands

Server

CommandPurpose
herdr serverHeadless server; stop, reload-config, manifests
herdr statusShow client and server state

See: CLI reference

Utilities

CommandPurpose
herdr apiSocket API snapshot and schema
herdr terminalAttach to raw terminal streams
herdr notificationShow a notification
herdr updateUpdate a direct install
herdr channelShow or set the update channel
herdr configValidate config or reset keybindings
herdr completionGenerate shell completions

See: CLI reference

Also see

0 Comments for this cheatsheet. Write yours!