pi-delegate

로컬 pi 에이전트에 구현 및 테스트를 위임하고, 디스패치 규율을 강제하는 훅을 제공합니다.

Claude는 테크 리드 역할을 합니다. 프로브, 태스크 북, 승인 스크립트, 판정을 생성합니다. pi가 소스 코드를 작성합니다.

Claude는 RPC 프로토콜을 직접 말하지 않습니다 — MCP 서버가 파이프를 쥐고 있으며, 이것이 실행 중간에 pi_steer와 pi_abort를 가능하게 하는 이유입니다.

설치

/plugin marketplace add LarryStanley/pi-delegate
/plugin install pi-delegate@pi-delegate

두 명령 모두 Claude Code 안에서 실행하세요. 첫 번째 명령은 이 저장소를 플러그인 마켓플레이스로 등록하고, 두 번째 명령은 그곳에서 플러그인을 설치합니다. 설치 요약에 Run /reload-plugins to activate.가 표시되면 그것도 실행하세요.

Node ≥ 22와 이미 설정된 pi 설치가 필요합니다. 의존성은 커밋된 lockfile에서 자동으로 설치됩니다 — 직접 npm install할 것은 없습니다.

나중에 업데이트하려면:

/plugin marketplace update pi-delegate

게시된 버전 대신 작업 복사본을 실행하려면:

claude --plugin-dir /path/to/pi-delegate

--plugin-dir 복사본은 해당 세션에서 설치된 버전보다 우선하므로, 제거하지 않고 변경 사항을 테스트할 수 있습니다.

그런 다음 /pi-delegate:setup을 실행하여 안내되는 첫 실행 워크스루를 진행하세요: pi와 그 프로바이더를 확인하고, 규율 모드를 설명하며 원하는 모드를 묻고, 수정 가능한 것은 수정을 제안하며, 도구를 실제로 사용하기 전에 검증 디스패치를 제안합니다.

Related MCP server: Claude Code Manager WAN

구성: 기본적으로 필요한 것은 없습니다

pi_dispatch는 프로바이더나 모델을 지정하지 않으므로, pi는 사용자 자신의 기본값(~/.pi/agent/settings.json의 defaultProvider / defaultModel)을 사용합니다. 즉, 이미 pi가 가리키고 있는 모델이 무엇이든 디스패치도 그쪽으로 갑니다 — anthropic, openai, litellm, ollama, LM Studio, 또는 로컬 OpenAI 호환 서버(예: omlx) 모두 동일하게 작동하며, 이 플러그인을 위해 특별히 구성할 것은 없습니다.

장기적으로 다른 모델을 고정하고 싶다면(예: 대화형 pi가 다른 것을 사용하는 동안 디스패치 전용으로 저렴한 로컬 모델을 사용), ~/.claude/pi-delegate/config.json을 작성하세요:

{
  "provider": "ollama",
  "model": "qwen3:8b",
  "timeout_s": 1500,
  "thinking": "off",
  "tools": "read,write,edit",
  "no_context_files": true,
  "drafter_patterns": ["-draft", "_assistant", "-assistant"]
}

모든 필드는 선택 사항입니다. 해석 순서는 pi_dispatch 호출 인자 → 이 파일 → pi 자체 기본값입니다.

/pi-delegate:doctor는 디스패치가 실제로 도달할 모델을 알려주며, 실제로 성립하는 조건에서만 문제를 제기합니다.

아래 기본값은 추측이 아니라 측정된 값입니다

재정의하려면 pi_dispatch 호출에서 직접 지정하세요(thinking, tools, no_context_files, append_system_prompt, provider, model, timeout_s).

--mode rpc, --session-id, --no-skills, --no-extensions는 구조적이므로 재정의할 수 없습니다. --no-session은 의도적으로 절대 전달되지 않습니다 (생략하는 것이 세션이 디스크에 기록되게 하며, 이것이 pi_transcript가 읽을 내용을 제공합니다).

모드

/pi-delegate:mode <mode>로 모드를 전환합니다. 상태는 ~/.claude/pi-delegate/modes.json에 저장되며 프로젝트별로 기억됩니다. "기존 제품 코드"란 프로젝트 루트의 src/ 아래에 이미 존재하는 소스 파일을 의미합니다. tasks/, scripts/, docs/, 마크다운, 구성 파일, 그리고 새로 생성된 파일은 모두 통과됩니다.

strict는 규율 가드레일이지 강제가 아닙니다: 훅은 Write|Edit에만 연결되어 있으므로, Bash로 같은 파일을 편집하는 것(sed -i, heredoc, python - <<EOF, …)은 결코 차단되지 않습니다. 항상 우회 방법이 있습니다 — 습관적으로 파일을 직접 편집하는 것을 막는 것이지, 의도적인 우회를 막는 것이 아닙니다.

한 번의 수동 편집(프로브)을 허용하려면 먼저 /pi-delegate:probe를 실행하여 일회성 우회를 받으세요.

MCP 도구

디스패치 작동 방식

MCP 서버의 활성화는 전체 세션에 걸쳐 있습니다. 그래서 실행 중간에도 pi 자식 프로세스의 stdin에 steer를 전달할 수 있고, 실행이 끝났는지 결정하는 것도 자식 프로세스가 아니라 MCP 서버입니다.

알려진 한계

pi_stats는 판정에 이미 포함된 tokens와 duration_s만 반환합니다. spec §5의 get_session_stats 패스스루(cost / context 사용량 포함)는 아직 구현되지 않았습니다.

문서

개발

npm test                    # node --test, no external dependencies
claude plugin validate .

fixtures/fake-pi.mjs는 pi --mode rpc를 대신합니다. 의도적으로 test/ 밖에 있습니다 — node --test는 **/test/**/*.{cjs,mjs,js} 아래의 모든 파일을 테스트 파일로 취급하므로, test/에 넣으면 영구적으로 통과하는 유령 테스트가 하나 추가될 것입니다.