pi-headless-subagent
Pi extension for spawning isolated subagents in separate pi --mode rpc subprocesses
Install
pi install npm:pi-headless-subagent
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 1.2.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.
- Commands — Runs shell commands Spawns processes on your machine.
- Files — Reads files outside your project Touches paths beyond the working directory, such as your home folder.
- New tools — Adds model-callable tools Gives the agent new abilities. Additive and visible, unlike an override.
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 subagent_startsubagent_listsubagent_waitsubagent_killsubagent_prompt
Events subscribed before_agent_startsession_shutdownsession_start
APIs called registerTool
Run against version 1.2.0 on 2026-08-02.
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 Orchestrators
- @kky42/pi-subagents — Claude Code-style subagents for pi.
- pi-agentteam — Multi-agent team orchestration for pi — leader-coordinator pattern with researcher, planne…
- @usirin/pi-loop — Claude Code-style /loop command for pi-coding-agent.
- pi-btw — A pi extension for parallel side conversations with /btw