pi-herdr-worker

Spawn worker pi agents in isolated Herdr panes for delegated task execution. The primary agent acts as orchestrator, delegating work to isolated workers.

Install

pi install npm:@duskoide/pi-herdr-worker

Requirements

• pi must be running inside a Herdr-managed pane (HERDR_ENV=1)
• Herdr must be installed and running
• Settings file at ~/.pi/agent/herdr-worker.json (optional — sensible defaults are built in)

Slash Commands

| Command | Usage | Description | |---------|-------|-------------| | /worker | /worker <prompt> [name] [model] [timeout] | Spawn worker with full control | | /workerp | /workerp <prompt> [model] | Quick spawn with auto-generated name | | /workerlist | /workerlist | List all running workers | | /workerkill | /workerkill <name> | Kill a specific worker |

Examples

/worker Implement the login page
/worker Review code worker-review claude-sonnet-5
/workerp Run the linter and fix errors
/workerlist
/workerkill worker-test-runner

The spawn_worker Tool

spawn_worker({
  prompt: "Run tests and report any failures",
  name: "worker-tests",
  model: "gpt-4o",
  timeout: 180000,
  direction: "right"
})

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | prompt | string | required | The task to send to the worker | | name | string | auto-generated | Unique worker name (lowercase, hyphens, max 31 chars) | | model | string | from settings | Model ID (e.g. gpt-4o, claude-sonnet-5) | | timeout | number | 120000 | Timeout in milliseconds | | direction | "right" | "down" | "right" | Pane split direction |

Settings

Configuration lives at ~/.pi/agent/herdr-worker.json:

{
  "defaultModel": "claude-sonnet-5",
  "allowedModels": ["gpt-4o", "claude-sonnet-5", "claude-sonnet-4-5", "gpt-4o-mini"],
  "defaultTimeout": 120000,
  "defaultDirection": "right"
}

How It Works

1. Splits the current pane for an isolated terminal
2. Launches a pi worker with the chosen model
3. Submits the task and waits for completion
4. Reads the worker's output
5. Closes the pane and stops the worker automatically

License

MIT