프로젝트 소개

Pi Agent(pi-agent-desktop)는 macOS(Apple Silicon), Windows 10/11 x64, Linux x64를 위한 로컬 AI 에이전트 데스크톱 앱입니다. earendil-works/pi의 Pi 코딩 에이전트와 pi-web 인터페이스를 Next.js, Tauri, Rust로 빌드된 단일 설치형 애플리케이션으로 래핑합니다. 이 앱은 Node.js 런타임과 Pi SDK를 번들하여 로컬 서버가 자동으로 시작되므로 별도의 터미널, Node.js 설치 또는 수동 웹 서버가 필요하지 않습니다. 주요 기능으로는 프로젝트별 과거 Pi 세션 탐색 및 재개, 에이전트와의 실시간 대화에서 사고 과정, 도구 호출, 컨텍스트 사용량, 비용, 압축 상태 표시, 모든 메시지에서 대화 분기, 모델/OAuth/API 키/사용자 정의 모델/스킬/플러그인 관리, 사이드바에서 Git 워크트리 전환, 소스 코드, diff, Markdown, 이미지, 오디오, PDF, DOCX 파일 미리보기가 있습니다. UI는 다크 모드, 자동 세션 이름 지정, 완료 사운드, 실행 상태 복원을 지원합니다. 업데이트는 pi-agent-desktop의 최신 안정 GitHub Release에 대해 주간 확인으로 처리되며, 원클릭 업그레이드 버튼은 Pi, pi-web, 데스크톱 앱이 일치하는 버전으로 포함된 서명된 전체 빌드를 다운로드한 후 자동으로 다시 시작합니다. 이 앱은 기본적으로 ~/.pi/agent/의 기존 Pi 데이터를 읽으며 서버 측 요청에 대해 HTTP_PROXY/HTTPS_PROXY/NO_PROXY 환경 변수를 존중합니다. 이 프로젝트는 로컬 수정 사항을 유지하면서 pi와 pi-web의 업스트림 변경 사항을 병합하는 자동화된 일일 동기화 워크플로를 사용하며, 릴리스 전에 위험 기반 게이팅과 전체 테스트/빌드 검증을 수행합니다. 공식 릴리스는 서명 및 공증(macOS) 또는 Authenticode 서명(Windows)됩니다. 코드베이스는 MIT 라이선스이며, 세 개의 구성 요소 프로젝트는 각각 자체 라이선스를 유지합니다.