Core Guides

Fresh

Deep guides for the systems that make Herdr useful day to day.

Guide	What it covers
Agents	Supported agents, status authority model, blocked detection, detection manifests, state rollups, custom labels, starting and attaching agents
Integrations	Installing official integrations, lifecycle authority vs session identity, per-agent setup details, custom status labels, debugging
Configuration	config.toml, update channel, terminal defaults, worktrees, keybindings, themes, UI/sidebar, notifications, sound, scrollback, experiments
Persistence and Remote Access	Detach/reattach, named sessions, SSH attach, herdr --remote, direct terminal attach, single-process mode
Session State and Restore	Live persistence, snapshot restore, pane history replay, native agent session restore, live handoff, and what survives each path

How the pieces fit

flowchart TD
    A[Herdr Server] --> B[Workspaces]
    B --> C[Tabs]
    C --> D[Panes]
    D --> E[Agents detected in panes]
    E --> F[State: working / blocked / done / idle]
    F --> G[Sidebar rollups]
    A --> H[Local socket API]
    H --> I[CLI wrappers]
    H --> J[Integrations report state + sessions]
    J --> K[Native agent session restore]