PiDeck
무엇인가
PiDeck은 로컬 프로젝트 디렉터리에서 pi·DSH 코딩 에이전트 세션을 한 창에서 관리하는 Electron 데스크톱 애플리케이션이다. 에이전트 능력을 자체 구현하지 않고, 이미 설치된 pi CLI 프로세스를 띄우고 그 입출력을 중계하는 프레임 계층에 해당한다. pi의 포크가 아니며 모델 호출, 도구 실행, 세션 파일 읽기·쓰기는 모두 pi가 담당한다.
어떻게 동작하나
동작 단위는 "에이전트 세션 하나 = pi RPC 프로세스 하나"다. PiDeck은 세션마다 `pi --mode rpc`를 별도 프로세스로 실행하고 stdio JSON-RPC로만 통신해 세션 간 간섭을 막는다. DSH(DeepSeek Harness) 백엔드는 utilityProcess로 내장 부팅하며 `dsh web` 실행이나 리스닝 포트, 백그라운드 HTTP를 두지 않는다. 세션 파일은 pi와 DSH가 각자 원래 형식으로 읽고 쓰며 PiDeck은 그 형식을 바꾸지 않는다.
무엇과 다른가
터미널에서 pi를 직접 쓰는 방식과 달리 프로젝트 단위 격리, 세션 이력 브라우징, Codex·Claude 로컬 세션 가져오기를 창 안에서 처리한다. 가져온 세션은 원본 파일을 건드리지 않고 PiDeck 이력 사본으로 변환되며, 이력은 자체 포함 HTML로 내보낼 수 있다. pi의 `models.json` / `auth.json` / `settings.json`은 손으로 쓰는 대신 스키마 기반 폼으로 편집하고 연결 테스트를 실행한다.
어떻게 쓰나
설치는 GitHub Releases의 Windows·macOS·Linux 패키지를 사용한다. 먼저 터미널에서 `pi --version`으로 PATH 등록을 확인하고 Provider와 API Key를 설정한 뒤 실행한다. DSH 백엔드는 설정 페이지 DSH 탭에서 settings와 credentials를 채우고, 새 세션을 만들 때 백엔드를 선택해 켠다. 소스에서 실행하려면 Node.js 20+와 npm이 필요하다.
전제와 한계
pi CLI가 시스템 PATH에 없으면 시작 시 찾지 못한다. 사용 가능한 모델과 능력은 pi 설정에 종속되고, DSH 백엔드는 DeepSeek 계열 모델을 쓴다. 브라우저 미리보기 모드(localhost:5173)는 `window.piDesktop`이 없을 때 mock 데이터로 떨어져 레이아웃만 확인할 수 있고, 에이전트·세션·파일 IPC는 Electron에서만 검증된다. 기본으로 익명 저빈도 `app_heartbeat`를 전송하며 설정에서 끌 수 있다.
관련 논문 3
유사 도구
- claudianObsidian 볼트를 작업 디렉터리로 삼아 Claude Code·Codex 등 코딩 에이전트 CLI를 채팅 사이드바에서 실행하는 TypeScript 플러그인이다.
- opcodeClaude Code 세션·에이전트·사용량을 관리하는 Tauri 2 기반 데스크톱 GUI다. CLI 세션을 시각적으로 탐색하고 커스텀 에이전트를 백그라운드로 실행한다.
- maka모든 모델 메시지·도구 호출·권한 결정을 append-only RuntimeEvent 로그로 남기는 에이전트 워크스페이스다. 데스크톱·TUI·CLI가 하나의 런타임을 공유한다.
- Noi웹 브라우저에 AI 채팅·프롬프트 관리·터미널을 결합한 데스크톱 워크스페이스다. 창마다 세션을 격리하고 데이터를 로컬에 둔다.
- Lumina-Note로컬 폴더를 Markdown 볼트로 두고 편집하는 Electron 데스크톱 노트 앱이다. 내장 opencode 에이전트가 볼트 전체를 읽고 쓰며 모델 라우팅을 직접 고른다.
- openscience목표를 자연어로 주면 문헌을 읽고 코드와 실험을 실행해 결과를 정리하는 과학 연구용 AI 워크벤치다. 데스크톱 앱·브라우저·터미널에서 동작한다.