vastsa/PI-Desktop

프로젝트, 에이전트, 모델, 플러그인 및 워크플로우를 하나의 영구적인 데스크톱 환경으로 통합합니다.

로컬 우선(Local-first) · 모델 비종속적(Model-agnostic) · 플러그인 기반 · macOS / Windows / Linux

다운로드 ·
문서화(Documentation) ·
플러그인 구축(Build a Plugin) ·
스크린샷(Screenshots) ·
简体中文

당신의 프로젝트는 로컬에 유지되고 · 당신의 모델은 교체 가능하며 · 당신의 작업 공간은 당신의 것입니다.

현재 릴리스 라인: 0.17.x (Early Preview).

터미널 에이전트는 실행(execution)에 탁월합니다. IDE 에이전트는 편집기 내부에 거주하는 데 탁월합니다.

PI-Desktop은 한 단계 더 나아갑니다:

AI 에이전트에게 자체적으로 영구적이고, 독립적이며, 확장 가능한 데스크톱 작업 공간을 제공합니다.

|
특정 IDE나 터미널에 의존하지 않습니다. 프로젝트, 세션, 리뷰, 미리보기 및 모든 에이전트는 자체 워크스페이스에서 작동합니다. |
플러그인은 에이전트 이상을 확장합니다. 패널, 뷰, 위젯, 도구, MCP 서버, 테마 및 백그라운드 서비스를 추가할 수 있습니다. |
하나의 에이전트만으로는 충분하지 않을 때가 있습니다. 서브에이전트(Subagents)에게 작업을 위임하거나 전체 워커 세션(Worker Sessions)을 병렬로 조정할 수 있습니다. |
클라우드 모델, 로컬 모델, 사용자 지정 게이트웨이, 호환 API. 워크플로우를 재구축하지 않고도 모델을 전환할 수 있습니다.

이는 단일 모델을 감싸는 래퍼(wrapper)가 아닙니다. 또 다른 IDE 확장 기능도 아닙니다.

PI-Desktop은 코어 기능을 유지합니다.

실제 워크플로우는 확장 기능을 통해 조립됩니다.

|
에이전트가 수행할 수 있는 것을 확장하기 |
데스크톱 자체를 확장하기 |
런타임을 확장하기 |

플러그인은 '단지 또 다른 도구'일 필요가 없습니다.

그것은 전체 제품이 될 수 있습니다:

Voice Agent
├── Floating Widget
├── Speech Service
...

플러그인은 .piplug 패키지 형태로 배포되거나 마켓플레이스를 통해 설치할 수 있습니다.

PI-Desktop
│
┌──────────────────┼──────────────────┐
...

PI-Desktop은 단순히 코딩 에이전트가 될 수도 있고,

AI 개발 작업 공간 · 음성 에이전트 · DevOps 콘솔 · GitHub 작업 공간 · 데이터 어시스턴트 · 멀티 에이전트 제어 센터 · 자동화 플랫폼으로 변신할 수도 있습니다.

Core는 기반을 제공하며, 플러그인이 작업 공간의 형태를 결정합니다.

| 코드를 읽고, 파일을 편집하고, 명령어를 실행하고, 테스트하고, 반복합니다. 일상적인 개발에 가장 적합합니다. | 에이전트가 먼저 프로젝트를 연구한 후 구현 계획을 생성합니다. 리팩토링 및 고위험 변경 사항에 가장 적합합니다. | 목표와 수용 기준(acceptance criteria)을 잠그고, 에이전트가 실행을 주도하도록 합니다. 복잡하고 장기적으로 실행되는 작업에 가장 적합합니다. |

특권(Privileged) 작업은 여전히 PI-Desktop의 권한 계층을 통과합니다.

복잡한 작업은 하나의 컨텍스트 창에 강제로 넣어서는 안 됩니다.

PI-Desktop은 두 가지 수준의 위임(delegation) 기능을 제공합니다.

독립적인 작업을 백그라운드 에이전트에게 위임합니다:

코드 탐색 · 구현 · 테스트 분석 · 연구 · 검토

각 서브에이전트는 자체 컨텍스트를 가지며 결과를 부모 에이전트에게 보고합니다.

더 오래 지속되는 작업의 경우, 전체 워커 세션(Worker Sessions)으로 위임합니다.

Main Session
│
├── Worker A
...

워커는 완전한 PI-Desktop 세션입니다:

독립적인 컨텍스트 · 독립적인 실행 · 직접 검사 가능 · 재사용 가능 · 전체 스크립트

|

|

'하나의 에이전트가 코딩을 도와주는 것'에서 '여러 에이전트가 역할을 분담하고 작업을 완료하는 것'으로 이동하세요.

PI-Desktop은 다음을 중심으로 구성되었습니다:

—일회성 채팅 스레드를 중심으로 하는 것이 아닙니다.

사용자는 다음을 할 수 있습니다:

• 여러 프로젝트와 세션 관리
• 세션 고정(Pin), 보관(archive), 브랜치, 검색
• 에이전트가 이미 실행 중일 때 프롬프트 대기열 추가
• @를 사용하여 프로젝트 파일 참조
• 슬래시 명령어 사용
• diff 검토
• 명령어 출력 검사
• 오른쪽 작업 패널(Work Panel) 활용
• 스트리밍 체크포인트 유지
• 가능한 경우 중단된 작업 복구

세션은 여러 앱 실행에 걸쳐 지속될 수 있습니다.

PI-Desktop은 워크플로우를 단일 모델 공급업체에 묶지 않습니다.

다음 모델들을 사용하세요:

OpenAI · Anthropic · OpenAI 호환 API · 사용자 지정 게이트웨이 · Ollama · LM Studio · 로컬 모델

각 모델을 독립적으로 구성할 수 있습니다:

공급업체(Provider) · 모델 ID · 컨텍스트 창 · 출력 제한 · 추론/사고(Reasoning / Thinking) · 온도(Temperature) · OAuth · API 키 · 엔드포인트

서로 다른 세션은 서로 다른 모델을 사용할 수 있습니다.

동일한 세션도 언제든지 모델을 전환할 수 있습니다.

계획(Planning) → Model A
코딩(Coding) → Model B
검토(Review) → Model C
...

모델은 워크플로우 자체가 아니라, 워크플로우의 교체 가능한 구성 요소입니다.

기존 작업을 유지하세요.

PI-Desktop은 다음 곳에서 로컬 세션을 가져올 수 있습니다:

Claude Code · Codex · OpenCode · Pi

PI-Desktop은 개발 환경을 당사 클라우드로 옮길 것을 요구하지 않습니다.

필수 PI-Desktop 릴레이(relay) 없음.

원격 모델을 사용할 때, 요청에 필요한 컨텍스트는 해당 공급업체로 직접 전송됩니다.

에이전트는 파일을 읽고, 코드를 편집하고, 명령어를 실행하고, 도구를 호출하고, 확장을 사용하고, 작업을 위임할 수 있습니다.

특권 작업(Privileged operations)은 여전히 권한 계층을 통과합니다:

Agent
↓
Tool Request
...

각 세션이 얼마나 많은 자율성을 가질지 사용자가 결정합니다.

|
Install PI-Desktop |
Configure a Provider |
Choose a local repository |
Agent / Plan / Goal |

Linux 호환성

Linux 패키지는 glibc 2.35 이상이 필요합니다.

일반적으로 지원되는 배포판은 다음과 같습니다:

• Ubuntu 22.04+
• Debian 12+
• Fedora 36+

다음 명령어로 현재 버전을 확인하세요:

ldd --version

PI-Desktop은 pi 에코시스템을 기반으로 구축되었습니다.

Agent Runtime은 다음을 사용합니다:

pi-ai

pi-agent-core

pi-coding-agent

Pi는 Agent Engine을 제공합니다. PI-Desktop은 이를 중심으로 영구적인 데스크톱 작업 공간, 세션, 권한, 플러그인 및 에이전트 오케스트레이션을 구축합니다.

PI-Desktop은 또한 에이전트 제품을 빌드하기 위한 호스트 플랫폼으로 사용될 수 있습니다.

다음 항목들을 빌드할 수 있습니다:

플러그인 · MCP 서버 · 스킬(Skills) · 에이전트 도구(Agent Tools) · pi 확장 기능(pi Extensions) · 테마(Themes) · 패널(Panels) · 플로팅 위젯(Floating Widgets) · 백그라운드 서비스(Background Services)

내장 템플릿에는 다음이 포함됩니다:

panel-basic

agent-tool-basic

skill-pack

full-demo

플러그인은 개발 플러그인(Development Plugins)으로 직접 생성하고 로드할 수 있습니다.

개발 환경 설정(Development Setup)

• Node.js
  >=22.19

• pnpm
  >=10

• 안정화된 Rust 툴체인(Stable Rust Toolchain)

git clone https://github.com/vastsa/PI-Desktop.git
cd PI-Desktop
pnpm install
...

pnpm typecheck
pnpm lint
pnpm test

문서(Documentation) · 아키텍처(Architecture) · 명세(Specification) · 플러그인 개발(Plugin Development) · E2E 테스트 계획(E2E Test Plan) · 릴리스 런북(Release Runbook) · AGENTS.md

기여는 환영합니다:

이슈(Issues) · 풀 리퀘스트(Pull Requests) · 플러그인(Plugins) · 스킬(Skills) · MCP 통합(MCP Integrations) · 문서화(Documentation) · 번역(Translations)

독립적인 기능을 위해 먼저 하나의 질문을 고려해 보세요:

이것이 플러그인으로 더 나은가?

핵심 기능에 집중하세요. 에코시스템이 성장하도록 두세요.

이슈 보고(Report an Issue) ·
개방된 이슈(Open Issues) ·
플러그인 구축하기(Build a Plugin)

Linux.Do — 새로운 이상적인 커뮤니티

한 명의 천재가 아닌, 토큰 기반 건설 크루에 의해 만들어졌습니다.

PI-Desktop은 여러 제공업체의 모델 도움을 받아 구축되었습니다.

개발, 리팩토링, 검토, 설계, 디버깅 과정에서 270억 개 이상의 토큰이 사용되었습니다.

저희를 구축하는 데 도움을 준 모든 인간 기여자들과 모델들에게 감사드립니다.

PI-Desktop은 GNU Lesser General Public License v3.0에 따라 라이선스가 부여됩니다.

자세한 내용은 LICENSE를 참고하십시오.