pi-subagents は、Piが集中した子エージェントに作業を委任できるようにします。コードレビュー、スカウティング、実装、並列監査、保存ワークフロー、バックグラウンドジョブ、そして2セット目や3組目のモデルの目が必要とするあらゆる用途に活用します。

インストール

それだけが必要なステップです。pi-subagentsはPi 1.2.0以降が必要です。バックグラウンドの子はホストのSDKを使用します:npm Piは分離したノードランナーを保持します。公式のPi 1.2.0 Linux x64スタンドアロンリリースは、別途SDKインストールなしでPiの組み込みSDKを通じて同じランナーを読み込みます。サポートされている境界と検証ゲートについては「スタンドアロンバックグラウンド実行」を参照してください。

まずこれを試してみて

エージェントを作成したり、設定を書いたり、スラッシュコマンドを覚えたりする必要はありません。インストール後、平易な言葉でPiに質問してください:

それだけで始めに十分です。Piは[subagentツールを呼び出すか、どのエージェントを使うか、どのように作るかを決定します。

仕組み

Piは親セッションです。サブエージェントは独自の役割を持つ、焦点を絞った子Piセッションです。

サブエージェントを求めると、Piは子を起動し、タスクを与え、結果を戻します。前景の子は親Piプロセス内のセッションとして実行され、会話内でストリームされます。

pi-subagents

pi-subagents lets Pi delegate work to focused child agents. Use it for code review, scouting, implementation, parallel audits, saved workflows, background jobs, and anything else that benefits from a second or third set of model eyes.

Install

pi install npm:pi-subagents

That is the only required step. pi-subagents needs Pi 1.2.0 or newer. Background children use the host’s SDK: npm Pi keeps its detached Node runner; the official Pi 1.2.0 Linux x64 standalone release loads the same runner through Pi’s embedded SDK, without a separate SDK install. See Standalone background execution for the supported boundary and validation gate.

Try this first

You do not need to create agents, write config, or learn slash commands. After installing, ask Pi in plain language:

Use reviewer to review this diff.

Ask oracle for a second opinion on my current plan. Challenge assumptions and tell me what I might be missing.

Use scout to understand this code based on our discussion, then ask me clarification questions.

Run parallel reviewers: one for correctness, one for tests, and one for unnecessary complexity.

That is enough to start. Pi decides whether to call the subagent tool, which agent to use, and how to compose the work.

How it works

Pi is the parent session. A subagent is a focused child Pi session with its own job.

When you ask for a subagent, Pi starts the child, gives it the task, and brings the result back. Foreground children run as sessions inside the parent Pi process and stream in the conversation. Background children run as sessions inside a detached runner process that keeps working and can be checked later.

Installing the extension does not start an automatic reviewer in the background. When the session’s model can take a new tool mid-conversation, fresh parent sessions initially expose the small subagents_enable loader instead of the full subagent schema. When your request or applicable instructions authorize delegation, Pi can call the loader itself; the unchanged subagent tool is available on the next model request. With other models, fresh sessions start with subagent active, because adding a tool later would make the provider miss its prompt cache. The toolActivation setting changes this. Complexity alone does not authorize delegation. bg_wait and supervisor replies remain available without activation.

If you want every implementation reviewed, say so in your prompt or project instructions:

When you finish implementing, run a reviewer subagent before summarizing.

Builtin agents