Herdr

Run persistent, observable work as a Herdr sidecar, independent of the main agent turn.

1. Confirm the session

Before controlling Herdr, check test "${HERDR_ENV:-}" = 1. Under HERDR_ENV=1, prefer native herdr_layout, herdr_pane, and herdr_agent tools when available. In other sessions, use ordinary execution tools.

Before issuing any Herdr CLI control command, read CLI-REFERENCE.md. Outside a Herdr session, do not inspect or control the focused Herdr session unless the user explicitly asks.

This step is complete when the available control surface and caller context are known.

2. Choose the execution surface

• Keep short, bounded commands in the ordinary command tool.
• Proactively move persistent or continuously observable work into a background pane.
• Use the pane surface for shells and ordinary processes. Use the agent surface for a recognized interactive coding agent.

This step is complete when each planned command is assigned to ordinary, pane, or agent execution.