pi-subagents는 Pi 코딩 에이전트에서 하위 에이전트(child agent)를 실행하는 확장이다. 코드 리뷰, 자료 조사, 병렬 감사, 구현 보조, 백그라운드 작업처럼 별도 관점이 필요한 일을 reviewer·researcher 같은 전문 에이전트에게 넘길 수 있다.
사용 방식
설치 후 자동으로 백그라운드 리뷰어가 도는 것은 아니다. 부모 Pi 세션에서 명시적으로 하위 에이전트 실행을 요청해야 한다. 내장 에이전트는 현재 Pi 기본 모델을 상속하며, 설정에서 특정 역할만 다른 모델로 고정할 수 있다.
| 기능 | 설명 |
|---|---|
| 역할별 에이전트 | reviewer, researcher 등 내장 역할 제공 |
| 모델 오버라이드 | 역할별 모델과 fallback model 설정 |
| 비동기 작업 | 긴 조사나 리뷰를 부모 세션과 분리해 실행 |
| 권한 통합 | pi-permission-system과 결합해 도구 권한을 제어 |
| intercom 옵션 | child agent 결과를 부모 세션으로 그룹 전달 |
언제 유용한가
대규모 변경 전 코드베이스 조사, 구현 후 독립 리뷰, 여러 후보 라이브러리 비교처럼 병렬성이 있는 작업에 맞다. 단, 하위 에이전트가 많아질수록 비용과 권한 표면도 커지므로 쓰기 도구·셸·네트워크 권한은 역할별로 제한해야 한다.
관련 문서
- herdr — 터미널에서 여러 코딩 에이전트를 조율하는 멀티플렉서
- onecode — Claude Code와 Codex를 한 앱에서 조율하는 오케스트레이터
- agent-harness — 에이전트 하네스 엔지니어링
참고 자료
- nicobailon/pi-subagents — GitHub 공식 저장소