packages / pi-minions
extension Orchestrators

pi-minions

Minimal recursive subagent orchestration for pi. No bundled agents, no opinions.

No reviews yet

Install

$ pi install npm:pi-minions

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.18.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.
  • Keystrokes — Reads raw terminal input Hooks ui.onTerminalInput, so it sees what you type. Legitimate for shortcut handling; the same access a keylogger needs.
  • 🔧
    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.

Tools registered spawnlist_agentshaltlist_minion_typeslist_minionsshow_minionlearn_minions

Events subscribed model_selectsession_starttool_execution_end

APIs called cwd.replacecwd.replace.replaceregisterCommandregisterMessageRendererregisterToolsessionManager.getSessionFileui.notifyui.setFooterui.setStatus

4 calls the source scan did not predict

cwd.replace · cwd.replace.replace · ui.setFooter · ui.setStatus

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.18.0 on 2026-08-02. Registration-time behaviour under default settings; other configurations may differ.

Review before you install. pi packages run with your full system permissions. Check the source, pin versions, and prefer authors you trust.

Reviews

0 published

Sign 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