@minhduydev/pi-subagents
Herdr-native delegation runtime for Pi with durable task state, foreground/background agents, worktree isolation, claims/lease heartbeats, evidence and independent review gates, grouped completion, schedules, RPC v3, recovery, and SDK/tmux fallback. Runti
Install
pi install npm:@minhduydev/pi-subagents
Installs from npm into ~/.pi/agent/.
Add -l for project-local (.pi/). Manage with pi list / pi update / pi remove.
What this package can reach
Detected automatically from the source at
version 0.11.0.
This describes access, not safety — you decide whether it's appropriate for what
the package claims to do.
- Behavior — Changes how the agent thinks Modifies the system prompt, injects messages, or rewrites conversation context.
- Extension bus — Talks to other extensions Uses pi.events to emit or listen on a shared channel, so it can coordinate with — or be driven by — other installed extensions.
- Commands — Runs shell commands Spawns processes on your machine.
- Credentials — Handles your API keys Reads or passes provider credentials. Highest-trust capability there is.
- Files — Reads files outside your project Touches paths beyond the working directory, such as your home folder.
- Intercepts tools — Can block or rewrite tool calls Subscribes to tool_call/tool_result/input. Can change a command after you approved the one displayed.
- New tools — Adds model-callable tools Gives the agent new abilities. Additive and visible, unlike an override.
- UI — Draws its own interface Renders widgets, footers, dialogs or full-screen views.
What it actually did when run
observedLoaded in a sandbox with no network, a read-only filesystem and a recording stand-in for pi's API. This is what it called — not what the source suggests it might.
Tools registered tasktask_control
Events subscribed pi-subagents:decision-responsepi-subagents:rpc:v3:pingpi-subagents:rpc:v3:spawnpi-subagents:rpc:v3:stoppi-subagents:task-launchedpi-subagents:task-stoppedsession_shutdownsession_starttool_call
APIs called events.bindevents.bind.onevents.onon.bindregisterCommandregisterCommand.bindregisterMessageRenderer.bindregisterToolui.notify
9 calls the source scan did not predict
events.bind · events.bind.on · events.on · on("pi-subagents:rpc:v3:ping") · on("pi-subagents:rpc:v3:spawn") · on("pi-subagents:rpc:v3:stop") · on.bind · registerCommand.bind · registerMessageRenderer.bind
Reached through a value the scan could not follow — passed as an argument, stored on another object, or returned by a helper.
Run against version 0.11.0 on 2026-08-01.
Registration-time behaviour under default settings; other configurations may differ.
Reviews
0 publishedSign in with GitHub to write a review, reply, or vote.
No reviews yet — be the first.
More in Modes & workflows
- pi-dynamic-workflows — Claude-Code-style dynamic workflow orchestration for Pi.
- @raoxxxwq/pi-tasks — A pi extension that brings Claude Code-style task tracking and coordination to pi.
- @ifi/oh-pi-skills — On-demand skill packs for pi: web-search, debug-helper, git-workflow, and more.
- pi-plan-modus — Read-only plan mode with RepoPrompt-aware write blocking; restricts tools, bash commands, …