vastsa/PI-Desktop

PI‑Desktop – AI 기반 코딩 에이전트를 위한 로컬 우선 데스크톱

무엇인가요 – PI‑Desktop는 macOS, Windows, Linux를 지원하는 크로스플랫폼 데스크톱 애플리케이션으로, 대규모 언어 모델 기반 코딩 에이전트를 위한 전용 작업 공간을 제공합니다. 채팅 창이나 에디터 플러그인이 아니라, 프로젝트, 세션, 파일 편집, 명령 실행, 장시간 실행 에이전트 작업을 관리하는 완전한 기능의 UI이며, 모든 내용은 사용자의 기계에 로컬에 보관됩니다.

핵심 개념

개념	얻는 것
자신의 모델 연결	OpenAI, Anthropic, Ollama, LM Studio, 또는 어떤 OpenAI 호환 엔드포인트에도 연결 가능. 모델별 설정(컨텍스트 창, 온도, 추론 수준 등)을 구성하고 실시간으로 모델을 전환할 수 있습니다.
프로젝트 중심	로컬 리포지토리 어디든 열 수 있습니다. 모든 세션, 차이점, 리뷰, 생성된 파일은 코드와 함께 저장됩니다. Claude Code, Codex, OpenCode, 또는 Pi에서 세션을 가져올 수 있습니다.
제어 레이어	에이전트는 파일 읽기/쓰기 및 명령 실행이 가능하지만, 권한이 높은 작업은 승인 UI를 통해 차이점, 명령 출력, 또는 완전한 자율성을 승인해야 합니다.
세 가지 워크플로우 모드	에이전트 – 자유로운 편집, 빠른 수정; 계획 – 에이전트가 변경 불가능한 구현 계획을 제안하고 승인이 필요; 목표 – 당신이 결과 기준을 설정하고 에이전트가 경로를 결정합니다.
플러그인 및 기술을 통한 확장성	마켓플레이스 플러그인(.piplug 패키지)을 설치하거나 자체 개발 가능. 플러그인은 새로운 에이전트 도구, 워크스페이스 패널, MCP(모델 컨텍스트 프로토콜) 서버, 서브에이전트, 테마 등을 추가할 수 있습니다.
서브에이전트	백그라운드에서 독립적인 작업(탐색, 다중 파일 구현, 리서치, 테스트 분석)을 위임할 수 있으며, 부모에게 보고합니다.
로컬 우선 및 프라이버시 우선	모든 대화, 설정, 로그는 로컬에 저장됩니다 (JSONL + SQLite). API 키는 OS 키체인에 저장됩니다. PI‑Desktop 계정이 필요 없으며, 텔레메트리도 없으며, 모델 요청은 설정한 제공자로 직접 전달됩니다.

작동 방식 (고수준 아키텍처)

• UI – React 렌더러 (채팅, 프로젝트 보기, 차이점 리뷰, 설정). Node 통합 없음.
• Electron 메인 프로세스 – 데스크톱 라이프사이클을 조율.
• Rust 호스트 코어 – 특권 작업을 관리: 파일 시스템 접근, SQLite 지속성, 비밀 저장, 권한 강제.
• pi 에이전트 사이드카 – 실제 LLM 기반 에이전트 루프를 실행, 응답 스트리밍, 설정된 모델 제공자와 통신.
• 모델 제공자 – 클라우드 또는 로컬 엔드포인트.

시작하기

1. 최신 GitHub 릴리스에서 적절한 설치 프로그램을 다운로드 (macOS용: DMG/ZIP, Windows용: NSIS 또는 포터블 EXE, Linux용: AppImage/DEB/RPM).
2. 설정 → 모델 구성에서 제공자 및 API 키 추가 (OS 키체인에 저장).
3. 사이드바를 통해 로컬 프로젝트 폴더 추가.
4. 세션을 시작하려면 에이전트, 계획, 또는 목표 모드 선택.
5. 변경 사항을 승인하기 전에 내장 패널에서 차이점, 명령 출력, 미리보기를 검토.

제품 확장하기

• 플러그인 – 내장 마켓플레이스에서 설치하거나 .piplug 파일을 앱에 드롭. 플러그인은 격리된 프로세스에서 실행되지만 신뢰된 코드이며, 새로운 명령, UI 패널, 백그라운드 서비스를 기여할 수 있습니다.
• 기술 – 에이전트가 호출할 수 있는 재사용 가능한 지침 번들.
• MCP 서버 – 모델 컨텍스트 프로토콜을 통해 에이전트에 외부 도구/서비스를 노출.
• pi 확장 – 기존 pi‑CLI 확장을 플러그인으로 감싸 동일하게 실행 가능.

현재 상태 – 초기 프리뷰 (v0.14.x). 핵심 기능(워크스페이스, 스트리밍 에이전트, 권한 레이어, 다중 모델 지원, 플러그인, 서브에이전트, 세션 가져오기, 체크포인트)은 작동 중입니다. 지속적인 작업에는 macOS 릴리스 인증, 설치 프로그램 업그레이드/롤백, 강화된 세션 복구, 더 엄격한 플러그인 사전 격리, 보다 광범위한 UI 테스트 커버리지가 포함됩니다.

개발 – Node ≥22.19, pnpm ≥10, 안정된 Rust 툴체인으로 로컬 빌드. 일반 워크플로우:

git clone https://github.com/vastsa/PI-Desktop.git
cd PI-Desktop
pnpm install
cargo build -p host-core
pnpm build:js
pnpm dev

검증을 위해 pnpm typecheck, pnpm lint, pnpm test를 실행하세요.

라이선스 – GNU LGPL v3.

---

TL;DR: PI‑Desktop는 로컬 코드베이스에서 LLM 기반 코딩 에이전트를 실행할 수 있는 진정한 오픈소스 데스크톱 환경이며, 모델, 권한, 확장에 대한 완전한 제어를 제공하며, 모든 데이터는 사용자의 기계에 보관됩니다.