Skip to content

Herdr Integration

Herdr is a persistent terminal runtime for coding agents. Otito is the independent context and merge-evidence layer inside that runtime.

Herdr workspace/worktree -> coding agent -> changed files
                                      |
                                      v
                       Otito context/impact/review/gate
                                      |
                                      v
                    evidence -> hosted checks -> human decision

The integration is a Herdr v1 plugin under integrations/herdr. It exposes:

  • task-aware context, using selected text when available
  • change-impact mapping against the active repository
  • model-tier routing from Otito AX (model-route: cheap / mid / premium)
  • the composite Otito review verdict
  • protected validation against the exact staged Git tree
  • an interactive trust-status popup

Install Otito and then the plugin:

npm install -g @bashbop/otito
otito doctor
herdr plugin install BASHBOP/otito/integrations/herdr

Open the trust view:

herdr plugin pane open \
  --plugin bashbop.otito \
  --entrypoint trust-status

The plugin does not embed an agent, replace Herdr's runtime, or let an agent award itself approval. Otito stays independently installable and keeps its own deterministic JSON/CLI contracts. Herdr contributes invocation context: the active workspace, worktree, pane, repository, and selected task text.

Local verdicts remain local evidence. Hosted CI, GitHub approvals, CODEOWNERS, unresolved review conversations, and the final merge decision stay with their respective authorities.

See the plugin's README for actions, keybindings, local development, configuration overrides, and the security boundary.