Desktop app for the pi coding agent: streaming timeline, Git review with hunk staging, session tree, native UI for pi extensions. Windows · macOS · Linux. pi 编程 Agent 桌面客户端

pi Desktop – pi 코딩 에이전트를 위한 GUI

무엇인가요 – pi Desktop는 크로스플랫폼 데스크톱 앱(Windows, macOS, Linux)으로, 터미널에서 pi CLI로 실행할 수 있는 pi 코딩 에이전트와 상호작용할 수 있게 해줍니다. 새로운 모델을 제공하지는 않으며, 기존의 pi SDK를 백그라운드 워커에서 실행하고, CLI에서 이미 사용 중인 세션, Git 차이점, 파일 탐색, 확장 기능을 위한 시각적 UI를 제공합니다.

핵심 개념

기능	제공되는 기능
공유 세션 저장소	CLI와 데스크톱은 모두 `~/.pi/agent`(세션, 모델 로그인, `settings.json`, 확장 기능)을 읽고 씁니다. 폴더를 열면 터미널에서 시작한 동일한 세션이 즉시 표시됩니다.
타임라인 보기	에이전트의 각 턴(생각, 도구 호출, 파일 읽기/편집)이 요약된 단계로 표시됩니다. 편집은 `+N −M` 줄 변경을 보여주며, 변경된 파일 카드를 클릭하면 차이점을 열 수 있습니다.
검토 패널	범위(단일 턴, 전체 세션, 전체 Git 트리)를 선택하고 Git 스타일의 차이점을 볼 수 있습니다. 하unks를 스테이징/언스테이징하고, 줄 주석을 대화로 다시 보낼 수 있습니다.
파일 패널	채팅과 함께 프로젝트를 병렬로 탐색할 수 있습니다. 줄을 클릭하면 `path:line`을 컴포저에 인용하고, 파일 미리보기, 채팅으로 드래그 앤 드롭이 가능합니다.
컴포저 단축키	`@`는 프로젝트 파일 검색(`.gitignore`를 `fd`로 존중), `/`는 pi 명령어 및 확장 기능 등록 명령어 목록, `Enter`는 전송, `Alt+Enter`는 후속 작업 대기열, `Shift+Enter`는 줄 바꿈.
병렬 세션	각 세션은 별도의 Electron 워커에서 실행되므로, 첫 번째 세션이 처리 중일 때도 두 번째 세션을 시작할 수 있습니다.
패널	트리(세션을 트리로), 실행(모델/생각 수준 및 토큰 분할), 컨텍스트(토큰 추정이 포함된 메시지).
테마 및 외관	라이트/다크 프리셋, 사용자 정의 CSS, 다섯 가지 아이콘 세트, 밀도 스케일링, `pi-theme-v1` / `codex-theme-v1` 문자열에서 가져오기.
확장 기능	기존 터미널 설치된 pi 확장 기능은 그대로 로드됩니다. UI 대화상자, 도구 카드, `/commands`는 선언적 어댑터(36개 내장)를 통해 네이티브 패널로 매핑됩니다. JSON 파일로 어댑터를 추가/재정의할 수 있습니다.
음성 입력	ChatGPT의 엔드포인트를 사용한 내장 음성 인식(API 키 필요 없음) 또는 사용자 정의 `codex-asr` 서비스.
WSL 런타임(Windows)	워커는 선택한 WSL 디스트로에서 실행 가능하며, Git과 파일 미리보기는 Linux 측에서 유지됩니다.

누구에게 적합한가요?

pi CLI를 이미 사용 중인 개발자로, 코드 변경 내용을 검토하고, 세션 트리를 탐색하며, Git 하unks를 스테이징하는 데 시각적 UI를 원하는 사람.
동일한 ~/.pi/agent 디렉터리를 공유하는 팀 – 데스크톱과 터미널이 동기화되어, 동료가 당신이 시작한 세션을 이어갈 수 있습니다.
순수한 터미널 출력보다 타임라인, 차이점, 파일 미리보기와 같은 시각적 피드백을 선호하는 사람.

시작하기 (README에서)

다운로드 – Releases 페이지에서 OS에 맞는 설치 프로그램을 다운로드하세요 (Windows: .exe/포터블, macOS: .dmg/.zip, Linux: .AppImage 또는 .deb).
폴더 열기 – 이 폴더가 에이전트의 작업 디렉터리가 됩니다. Conversations 옆의 + 버튼을 눌러 일시적인 채팅을 시작할 수 있습니다.
세션 선택 – 기존 터미널 세션이 표시됩니다. **+**를 클릭하여 새 세션을 시작하세요.
프롬프트 전송 – Enter로 전송, Shift+Enter로 줄 바꿈. 에이전트가 실행 중일 때는 Enter로 턴을 조정, Alt+Enter로 후속 작업을 대기열에 넣습니다.
UI 탐색 – 리뷰, 실행, 컨텍스트, 트리, 파일 패널은 오른쪽 사이드바에 있으며, 드래그로 크기를 조절할 수 있습니다.

기술 사양 (개발자용)

스택: Electron 43, React 18, TypeScript, Tailwind, Zustand, i18next, @earendil-works/pi-coding-agent.
아키텍처: 메인 프로세스는 IPC를 처리하고 세션당 하나의 워커를 생성합니다. 각 워커는 pi SDK를 실행(로컬 또는 WSL 내부). 렌더러는 SDK에 직접 연결하지 않습니다.
빌드: npm install → npm run dev (개발), npm run build (생산용 번들), npm run package (electron-builder를 통한 설치 파일 생성).
테스트: 단위 테스트, 스크립트, 타입 체크, 린트 스크립트 제공.

라이선스 및 지원

라이선스: MIT.
지원: LinuxDo 커뮤니티, GitHub Issues, 스폰서십 QR 코드.

결론 – pi Desktop은 기존의 pi 코딩 에이전트를 완전히 기능하는 GUI 래퍼로 제공하며, 타임라인 시각화, Git 스타일 리뷰, 파일 탐색, 병렬 세션, 확장 기능 지원을 제공하면서 CLI 워크플로우와 완전히 호환됩니다.

justhil/pi-app