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.

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.