Local-first AI coding agent desktop: Electron + Rust host core + pi Agent Harness + user-installable plugins

PI‑Desktop – AI 에이전트를 위한 모듈형 로컬 우선 데스크톱

개요

PI‑Desktop은 AI 에이전트에게 지속적이고 확장 가능한 작업 공간을 제공하는 크로스 플랫폼(macOS, Windows, Linux) 데스크톱 애플리케이션입니다. IDE 플러그인이나 단일 LLM의 얇은 래퍼가 아니라, 에이전트, 플러그인, 모델 백엔드를 실행, 오케스트레이션 및 관리할 수 있는 데스크톱 플랫폼을 제공합니다.

핵심 개념

개념	의미
독립적인 작업 공간	프로젝트, 세션, 에이전트는 IDE나 터미널과 분리된 자체 샌드박스 내에서 실행됩니다.
플러그인 기반	패널, 명령어, 위젯, 서비스, 테마, 새로운 에이전트 도구 등을 추가할 수 있는 플러그인을 통해 기능이 확장됩니다.
에이전트 오케스트레이션	에이전트는 하위 에이전트(경량 백그라운드 워커)나 각각 고유한 컨텍스트를 가진 병렬 실행 가능한 워커 세션을 생성할 수 있습니다.
모델의 자유	OpenAI, Anthropic, Ollama, LM Studio, 사용자 지정 게이트웨이 또는 모든 로컬 모델을 런타임에 지정할 수 있습니다. 모델은 세션별로, 또는 세션 도중에도 즉시 전환 가능합니다.

사용 방법

앱을 다운로드합니다 (DMG, installer, AppImage 등).
공급자(API 키, 엔드포인트 등)를 추가하여 모델을 연결합니다.
로컬 프로젝트(git 리포지토리나 폴더)를 엽니다.
워크플로우 모드를 선택합니다:
- Agent – 구체적인 작업을 부여하여 에이전트가 코딩, 테스트 실행, 파일 편집을 수행하게 합니다.
- Plan – 에이전트가 코드를 수정하기 전에 먼저 구현 계획을 생성합니다.
- Goal – 결과와 수락 기준을 설정하면 에이전트가 경로를 결정합니다.

모든 작업은 로컬에 저장됩니다. 프로젝트, 세션, 로그, 설정은 원격 모델에 명시적으로 요청을 보내지 않는 한 머신 외부로 나가지 않습니다.

플러그인 – 확장성

플러그인은 일급 시민이며 다음 기능을 자유롭게 추가할 수 있습니다:

Commands (전역 동작)
Panels (독립적인 UI 창)
Floating widgets (예: 음성 오브, 상태 표시등)
Work‑panel views (오른쪽 작업 공간 탭)
Agent tools / skills / completions (에이전트가 호출할 수 있는 함수)
Themes
MCP servers (데스크톱이 통신할 수 있는 로컬/원격 서비스)
Background services
Message bus (플러그인 간 통신용)

플러그인은 .piplug 패키지로 배포되거나 내장 마켓플레이스를 통해 제공됩니다.

세션 모델

Project → Session → Agent → Work 계층 구조.
세션은 앱 재시작 후에도 유지되며, 아카이브, 브랜치, 검색, 큐잉이 가능합니다.
@로 파일을 참조하거나, 슬래시 명령어를 사용하고, 차이를 확인하거나, 명령어 출력을 검사할 수 있습니다.
하위 에이전트와 워커 세션을 통해 단일 LLM 컨텍스트 창에 과부하를 주지 않고 병렬 처리가 가능합니다.

모델 비의존적 아키텍처

각 모델의 설정 항목:

공급자, 모델 ID, 컨텍스트 창, 온도 등.
세션마다 다른 모델을 사용할 수 있으며, 단일 세션 내에서 모델을 즉시 전환할 수도 있습니다(예: Model A로 계획하고 Model B로 코딩).

로컬 우선 및 개인정보 보호

모든 데이터(프로젝트, 세션, 로그)는 기기에 유지됩니다.
API 자격 증명은 OS 키체인에 저장됩니다.
강제적인 계정 생성, 텔레메트리, 릴레이 서비스가 없습니다.
권한 레이어를 통해 특권 작업(파일 쓰기, 명령어 실행 등)을 승인하거나 거부할 수 있습니다.

개발 및 확장

pi 생태계 (pi-ai, pi-agent-core, pi-coding-agent) 기반으로 구축되었습니다.
소스 코드는 Node ≥22, pnpm, 안정적인 Rust 툴체인이 필요합니다.
퀵 스타트: git clone … && pnpm install && cargo build -p host-core && pnpm dev.
문서에는 아키텍처 사양, 플러그인 개발 가이드, E2E 테스트 계획이 포함되어 있습니다.

대상 사용자

채팅 창이 아닌 전용 AI 어시스턴트 데스크톱을 원하는 개발자.
플러그인을 통해 사용자 지정 AI 에이전트 제품(음성 에이전트, DevOps 콘솔, 데이터 어시스턴트 등)을 구축하는 팀.
멀티 에이전트 오케스트레이션과 모델 전환을 실험하는 연구자.

라이선스

GNU LGPL v3 – 코어를 오픈 소스로 유지하면서 사용, 수정, 재배포가 가능합니다.

결론: PI‑Desktop은 모듈성, 모델 비의존성, 개인정보 보호에 중점을 두고 자신의 머신에서 AI 에이전트를 실행, 관리, 확장할 수 있는 본격적인 오픈 소스 플랫폼입니다.

vastsa/PI-Desktop