elidickinson/pi-claude-bridge

해결하는 문제

이 프로젝트는 pi 코딩 에이전트와 Claude Code 사이의 브리지 역할을 하여, 사용자가 pi의 주요 지능으로 Claude 모델(Opus, Sonnet, Haiku)을 사용하면서도 pi의 TUI(Terminal User Interface) 및 도구 호출 기능을 유지할 수 있도록 합니다. 또한 다른 제공자 사용 시 pi가 특정 작업을 별도의 도구로 Claude Code에 위임할 수 있도록 합니다.

작동 방식

브리지의 주요 동작 모드는 두 가지입니다:

1. 프로바이더 모드: Claude 모델을 pi 내부의 프로바이더로 등록합니다. 사용자가 요청을 보낼 때, 브리지는 Agent SDK를 통해 요청과 도구 호출을 Claude Code로 전달하여 bash 명령어 및 기술이 올바르게 처리되도록 합니다. pi의 기록과 Claude Code의 세션 간의 세션 동기화를 관리합니다.
2. AskClaude 도구: 선택적 도구로, pi의 현재 LLM(프로바이더에 관계없이)이 작업이나 질문을 Claude Code에 위임할 수 있도록 합니다. 읽기 전용 접근 또는 "풀" 모드(읽기, 쓰기, bash 접근)로 구성할 수 있습니다.

대상 사용자

pi 코딩 에이전트를 사용하면서 Claude의 최신 모델과 Claude Code CLI 도구의 특별한 기능을 워크플로우에 통합하고자 하는 개발자들.

주요 특징

• 무결함 있는 모델 통합: pi-ai의 카탈로그에서 Claude 모델 목록을 자동으로 가져와, 지원되는 플랜에서는 최대 1M 토큰의 고컨텍스트 창을 지원합니다.
• 유연한 위임: AskClaude 도구를 통해 두 번째 의견, 코드 리뷰, 또는 Claude Code를 통한 자율적인 작업 처리가 가능합니다.
• TUI 유지: 모든 도구 호출 및 도구 결과가 pi의 TUI를 통해 흐르며, 일관된 사용자 경험을 유지합니다.
• 세부 디버깅: 브리지 및 Claude Code CLI 하위 프로세스에 대한 포괄적인 로깅을 포함하여 세션 재개 실패를 진단할 수 있습니다.
• 사용자 정의 제어: 사용자는 플랜 유형, 컨텍스트 창 제한, Claude Code 실행 파일 경로를 사용자 정의할 수 있습니다.