svkozak/pi-acp

해결하는 문제

pi 코딩 에이전트와 Agent Client Protocol (ACP)를 지원하는 클라이언트(예: Zed 에디터) 간의 다리를 제공합니다. 이를 통해 사용자는 터미널 인터페이스에만 의존하지 않고, IDE 내에서 직접 pi 에이전트의 기능을 사용할 수 있습니다.

작동 방식

pi-acp는 표준 입력/출력(stdio)을 통해 ACP JSON-RPC 2.0을 사용하여 통신하는 어댑터입니다. pi 에이전트를 RPC 모드(pi --mode rpc)로 실행하고, ACP 클라이언트와 에이전트 간의 요청 및 이벤트를 번역합니다.

대상 사용자

pi 코딩 에이전트를 사용하며 Zed과 같은 ACP 호환 에디터에 통합하여 더 원활한 개발 경험을 원하는 개발자입니다.

주요 기능

• IDE 통합: pi를 ACP 클라이언트 내에서 작동 가능하게 하여 스트리밍 어시스턴트 출력 및 도구 호출 매핑과 같은 기능을 지원합니다.
• 컨텍스트 인식: 상대 파일 경로를 해결하고 편집 시 행 번호를 추론하여 에디터가 에이전트의 변경 사항을 따라갈 수 있도록 도와줍니다.
• 세션 관리: 세션 지속성과 기록을 지원하여 사용자가 에디터와 터미널 모두에서 이전 세션에 다시 연결할 수 있습니다.
• 명령어 지원: 파일 기반 슬래시 명령어, 내장 유틸리티 명령어(/compact, /export 등), 스킬 명령어를 통합합니다.
• 구조화된 차이점: 도구 실행 전 파일 스냅샷을 캡처하여 완료 시 구조화된 차이점(oldText/newText)을 출력합니다.