pi install npm:pi-herdr-subagents-lite              # npm
pi install /path/to/pi-herdr-subagents-lite         # local checkout
pi -e /path/to/pi-herdr-subagents-lite/src/index.ts # this process only

{
  "maxConcurrent": 4
}

{
  // Default true. false = no subagent tool for the model. The bridge has its own switch.
  "enabled": true,
  // Default "subagent". Must match ^[a-z][a-z0-9_]{0,31}$. The name prefixes each guideline line.
  "toolName": "subagent",
  // Default "herdr". A plain name resolves from PATH; an absolute path pins a version.
  "herdrBin": "herdr",
  // Default 16, range 1 and up. At the limit run returns max_concurrent. A child with auto-exit: false keeps its slot after it settles.
  "maxConcurrent": 16,
  // Default 16384, range 1024 to 1048576. A longer text goes to an artifact file. The message keeps a truncated head and the path.
  "maxResultChars": 16384,
  // Default 500, range 0 to 10000 milliseconds. 0 = deliver each result at once. A larger value merges more results.
  "aggregateWindowMs": 500,
  // Default empty = never close. Values: new, resume, fork, quit, reload. A listed reason closes the child tabs on parent shutdown.
  "closeChildrenOn": [],
  // Default 250, range 50 to 5000 milliseconds. A larger value wakes less often and delivers later.
  "inboxPollMs": 250,
  // Default 1000, range 100 to 60000 milliseconds. Use while a child works or blocks, or within 30 s of run or send.
  "pollIntervalMs": 1000,
  // Default 8000, range 100 to 60000 milliseconds. Use when every live child only waits for send. A larger value notices a dead pane later.
  "idlePollIntervalMs": 8000,
  // Tool text overrides. Each key defaults to unset, which keeps the built-in text shown below.
  "prompts": {
    // Replaces the built-in description.
    "description": "Use run when a task is self-contained and long-running. Use send to pass information to a subagent.",
    // The one-line entry in Available tools. Empty = keep the tool out of that list.
    "snippet": "",
    // Replaces the built-in guideline lines. Keep {{profiles}} to list the profiles.
    "guidelines": [
      "run only starts; it does not wait. The result arrives later as a message.",
      "send only delivers; no state tracking.",
      "Available profiles:\n{{profiles}}"
    ]
  },
  // Turn pi prompt events into herdr:blocked events.
  "bridge": {
    // Default true. false = no herdr:blocked events.
    "enabled": true,
    // Default all five. Prompt kinds that count as blocked: custom, select, confirm, input, editor.
    "blockedOn": ["custom", "select", "confirm", "input", "editor"]
  }
}

{"action":"run","profile":"explore","task":"Read README.md and answer with its first heading."}

{"action":"send","name":"explore-1","message":"Also check the Windows branch."}

---
# Key run takes; the file name is not used
name: explore
description: "Read-only research: read code, answer questions, change nothing"

# Omit to inherit from the parent
# model: provider/model
thinking: low

# Plain names = strict allowlist. +name / -name adjusts the default set. Never mix both
# Omitted = pi defaults minus this tool (nesting off); "" = empty allowlist
tools: read, bash

# Omitted = pi discovery; "" = no skills; a list = only those
skills: ""

# append / replace: body is appended to or replaces the system prompt
# task: body is the task text, no identity file
system-prompt: append

# Shut down and close the tab when settled. It waits while a prompt is open or the inbox has messages
auto-exit: true

# true = hidden from the guidelines; an explicit run still works
disable-model-invocation: false
---

You are a read-only explorer. Answer with file paths and line numbers.

cd <agent-dir>/pi-herdr-subagents-lite/profiles && cp examples/worker.md worker.md