sajad torkamani

What is Herdr?

Herdr is a terminal workspace manager that is useful for organising multiple terminals for a given project.

Glossary

TermDescription
WorkspaceA project-level container for your tabs, panes and agents.
TabA layout inside a workspace. Use tabs to separate views like agents, logs, server or review.
PaneA real terminal. Herdr shows the terminal output, sends your input back to the process and preserves the pane even after a client detach.
SessionA persistent Herdr server namsepace. The default herdr command attaches to the default session.

Agent states

  • working
  • blocked
  • done
  • idle
  • unknown

Common recipes

List sessions

herdr session list

Attach to session

herdr session attach <session>

Delete session

herdr session delete <session>

Keyboard shortcuts

The default prefix is ctrl+b.

ActionKey
New tabprefix+c
Close paneprefix+x
Zoom the focused paneprefix+x
Split rightprefix+v
Split downprefix+minus
Navigate between panesprefix+h/j/k/l
Swap panesprefix+shift+h/j/k/l
Navigate workspacesprefix+w
Detach & leave everything runningprefix+q
Toggle sidebarprefix+b
Tagged: AI