비동기 서브 에이전트의 조율과 리드 컨텍스트 관리를 위한 Pi Herdsman을 만들었습니다
I built Pi Herdsman for async subagents with tighter coordination and cleaner lead context
핵심 요약
Pi와 Herdr 환경에서 서브 에이전트 간의 조율과 리드 컨텍스트를 효율적으로 관리하는 Pi Herdsman을 개발했습니다.
- 비동기 조율 — 서브 에이전트 간의 명확한 소유권과 예측 가능한 생명주기를 제공함
- 리드 컨텍스트 유지 — 리드 에이전트가 전체 맥락을 유지하면서 서브 에이전트와 상호작용함
- 다양한 환경 지원 — 로컬, 서버, VPS 등 다양한 환경에서 SSH 컨테이너를 통해 실행 가능함
- 확장성 및 감독 — 병렬 에이전트, 중첩 위임, 리드 간 조율 및 최고 관리자 감독 기능을 지원함
Pi Herdsman 만들었다. 원래 Pi랑 서브 에이전트 쓰던 방식에서 발전시킨 거임.
처음엔 pi-subagents + pi-intercom 조합으로 매니저/워커 구조 써봤는데, 쓰다 보니까 에이전트끼리 좀 더 빡세게 조율됐으면 싶더라고. 누가 뭘 담당하는지 명확하고, 생명주기 예측 가능하고, 질문이나 결과값이 자동으로 왔다 갔다 하고, 예전 에이전트 세션 때문에 헷갈리는 일 없게 만들고 싶었음.
제일 신경 쓴 건 리드(lead)의 컨텍스트를 유지하는 거였어.
Herdsman을 쓰면 상세 조사나 구현은 별도의 Pi 세션에서 돌아가고, 리드는 계속 전체적인 그림에 집중할 수 있음. 에이전트들이 뭘 하는지 다 파악하고 질문이나 결과도 받지만, 리드가 그 모든 작업 컨텍스트를 다 짊어질 필요는 없는 거지.
병렬 에이전트, 중첩 위임, 조종/중단, 리드 간 조율, 그리고 여러 독립적인 리드를 관리하는 총괄 감독 기능까지 다 지원함.
실제 Pi 세션이랑 배치를 담당하는 Herdr이 꼭 필요함. Pi는 각 대화를 담당하고, Herdsman은 그 사이에서 오케스트레이션 역할을 하는 구조야.
최신 릴리즈에는 SSH 가능한 컨테이너(Tailscale 옵션)도 추가했어. 그래서 로컬이든 NAS, 홈랩/서버, VPS 어디서든 똑같이 돌릴 수 있고, 원격 환경도 로컬이랑 똑같이 Herdr 창 하나에서 다 볼 수 있음.
설치:
pi install npm:pi-herdsman
herdr integration install pi
저장소: https://github.com/boadij/pi-herdsman
피드백이나 아이디어, 아니면 쓰다가 불편한 점 있으면 뭐든 알려줘. 진짜 큰 도움 됨.



