Reference · Using Herdr Effectively

Persistent Agent Workspaces

The mental model and first commands

The hierarchy

session
└── workspace: one project, task, or investigation
    └── tab: agents / logs / server / review
        └── pane: a real terminal
            └── agent: claude, codex, opencode, pi, ...

First run

cd ~/your-project
herdr
claude                 # or codex, opencode, pi, ...

Detach and reattach

ctrl+b q              # detach client; agents keep running
herdr                  # reattach later
herdr server stop      # actually stop the session and panes

Common controls

ActionControl
Split rightctrl+b, then v
Split downctrl+b, then -
New tabctrl+b, then c
Workspace navigationctrl+b, then w
Show bindingsctrl+b, then ?

Useful status commands

herdr status
herdr agent list
herdr integration status
herdr agent explain <target>

Back to Lesson 01 · Official quick start