pi-subagents는 Pi가 집중된 자식 에이전트에게 작업을 위임할 수 있게 합니다. 코드 리뷰, 스카우팅, 구현, 병렬 감사, 저장된 워크플로우, 백그라운드 작업 등 두 번째 또는 세 번째 모델 아이가 필요한 모든 작업에 활용합니다.

설치

이것이 필요한 유일한 단계입니다. 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