Orbit이란
Orbit은 pi 코딩 에이전트를 위한 네이티브 데스크톱 작업 환경입니다. Zed 뒤에 있는 GPU 가속 UI 프레임워크인 GPUI로 그린 Rust 앱이며, 브라우저도, 웹뷰도, Node UI 계층도 없습니다.
Orbit은 모델 API를 감싼 채팅 래퍼가 아닙니다. pi CLI를 자식 프로세스로 실행하고 stdio로 pi 자체의 RPC 프로토콜을 사용합니다. 모델 카탈로그, 도구, 사고 수준, 세션은 pi의 것이고 Orbit은 그것을 비추는 창입니다. Orbit에서 만든 세션과 터미널에서 만든 세션은 같은 파일입니다.
동작 방식
Orbit (Rust · GPUI) │ 줄 단위 JSON RPC (stdio 경유) ▼ pi CLI (열린 세션마다 자식 프로세스 하나) │ ▼ ~/.pi/agent/ 세션 · 설정 · 사용량
요청은 JSON으로 stdin을 통해 pi로 전달되고, pi는 이벤트를 JSON 줄로 stdout에 흘려보냅니다 — 텍스트와 사고 델타, 도구 호출, 질문 대화상자, 종료 신호입니다. 런타임이 pi 자체이므로 CLI가 할 수 있는 일은 Orbit도 조작할 수 있고, 두 번 구현되는 것은 없습니다.
필요한 것
- pi — 실제 작업을 하는 코딩 에이전트 CLI입니다. pi 저장소에서 설치하세요.
- Node.js — 많은 MCP 서버(
npx로 실행)와 pi 패키지가 필요로 합니다. - Git — 리뷰 패널, Git 페이지, 워크트리를 뒷받침합니다.
첫 실행 시 Orbit이 세 가지를 확인하고, 찾지 못한 항목을 설치 명령과 함께 알려 줍니다. 설정에서 언제든 다시 볼 수 있습니다.
데이터가 있는 곳
| 경로 | 내용 |
|---|---|
~/.pi/agent/sessions/ | 당신의 세션 — pi CLI가 읽고 쓰는 것과 같은 파일입니다. |
~/.pi/agent/ | pi 구성. MCP 구성과 자격 증명을 포함합니다. |
~/.orbit-pi/ | Orbit 환경설정: 레이아웃, 접근 모드, 워크플로 모드, 알림, 워크트리 루트, MCP 시크릿 저장소. |
<project>/.pi/ | 프로젝트 단위 pi 구성. 프로젝트의 mcp.json을 포함합니다. |
가이드
워크벤치
빠진 것이 있나요? GitHub에서 이슈를 열어 주세요.