문서

설치와 첫 실행

Orbit은 macOS, Windows, Linux용 서명된 빌드를 제공하며, 서명된 앱 내 업데이트를 지원합니다. 이 페이지는 다운로드부터 첫 프롬프트까지 안내합니다.

내려받기

플랫폼에 맞는 빌드를 최신 릴리스에서 받으세요. 이 사이트 헤더의 내려받기 버튼이 알맞은 것을 자동으로 골라 줍니다.

플랫폼형식
macOS.dmg(서명 및 공증, 유니버설)와 .tar.gz
Windows.exe와 .zip
Linux.deb와 .tar.gz, x86_64 및 Arm64용

요구 사항

Orbit은 앱 바깥에 있는 도구를 조작합니다. 먼저 이것들을 설치하거나, 첫 실행 점검이 알려 주는 부족한 항목을 확인하세요:

  • pi — 코딩 에이전트 CLI입니다. Orbit은 세션마다 이를 자식 프로세스로 실행합니다.
  • Node.js — 많은 MCP 서버가 npx로 실행되고, pi 패키지도 Node에서 동작합니다.
  • Git — 리뷰 패널, Git 페이지, 워크트리를 위해.

첫 실행

  1. Orbit을 엽니다. 첫 실행 시 pi, node, git을 확인하고 찾지 못한 항목을 설치 명령과 함께 나열합니다.
  2. 제공자를 연결합니다. 설정 → 제공자를 열고 API 키나 OAuth로 로그인하세요. Orbit은 pi의 실시간 모델 카탈로그를 읽으므로 이 목록은 CLI가 닿는 범위와 같습니다.
  3. 워크스페이스를 고릅니다. 워크스페이스는 그냥 프로젝트 폴더입니다. 새 작업에는 최근 폴더와 네이티브 찾아보기 버튼이 있는 선택기가 있습니다.
  4. 모델과 사고 수준을 고릅니다. 설정 → 에이전트에서 새 세션이 시작할 기본 모델과 사고 수준을 정합니다.
  5. 접근 모드를 고릅니다. 감독은 변경을 일으키는 모든 호출 전에 확인합니다. 편집 자동 승인은 파일 편집을 적용하지만 명령 전에는 확인합니다. 전체 접근은 묻지 않고 실행합니다.
  6. 프롬프트를 보냅니다. Enter로 보내고, Shift+Enter로 줄을 바꿉니다.

업데이트

릴리스 빌드는 백그라운드에서 업데이트를 확인하고 서명된 앱 내 업데이터로 설치합니다. 업데이트 확인을 ⌘+⇧+U(Windows와 Linux에서는 Ctrl+Shift+U)로 직접 실행하거나, 업데이터 대화상자에서 버전 기록을 열 수 있습니다.

다음

앱을 실행한 뒤에는 세션 가이드가 일상 작업을, 키보드 단축키가 전체 키맵을 다룹니다.