Delegate tasks to subagents with chains, parallel execution, artifacts and TUI controls. The de-facto standard for multi-agent workflows in pi.
★ 4.5 · 2 reviews
Install
$pi install npm: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.38.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.
⌨
Keystrokes — Reads raw terminal input Hooks ui.onTerminalInput, so it sees what you type. Legitimate for shortcut handling; the same access a keylogger needs.
🌐
Network — Talks to the internet Makes outbound network requests. Check the destinations are ones you expect.
🔧
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
observed
Loaded 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.
Chains and parallel execution just work, and the TUI controls make long runs easy to babysit. Pairs beautifully with pi-messenger for coordination. My default install on every machine.
Wwarmongr2026-07-30
Author here — thanks! Tip: chains + the artifacts inbox pattern works great for long research runs.
Aalice★★★★☆2026-07-30
Great, but watch your token bill
Parallel chains are fantastic for big refactors. Just know that fan-outs multiply token usage fast — set caps. Otherwise flawless.
More in
pi-autoresearch — Autonomous experiment loop extension for pi — modify, verify, keep or discard, repeat. Goa…
@tintinweb/pi-subagents — Smart Claude-Code-style autonomous sub-agents for pi, with an alternative take on agent de…
pi-messenger — Inter-agent messaging and file reservation system — let multiple pi agents coordinate acro…
pi-dynamic-workflows — Claude-Code-style dynamic workflows for pi — fan a task out across hundreds of subagents w…