Orca CLI란? 설치하고 첫 명령까지

🇰🇷 한국어 🇺🇸 English

📌 답변 먼저 보기

Orca CLI는 실행 중인 Orca 데스크톱(에이전트 개발 환경, ADE)을 셸에서 스크립트하는 orca 명령입니다. 모델이 아니라, 이미 쓰는 Claude Code·Codex·Cursor CLI 같은 에이전트를 worktree별로 돌리는 환경입니다. 설치는 공식 Install을 따르고, 첫 확인은 command -v orca와 orca status --json입니다.

이 글은 공식 문서에 적힌 설치·등록·검증만 다룹니다. 요금·체감 후기는 넣지 않습니다. 플래그가 바뀌면 CLI overview와 CLI reference를 우선합니다.

Orca는 뭐가 다른가?

한 줄 답: 일반 IDE가 사람 한 명의 편집기라면, Orca는 작업마다 git worktree·에이전트 터미널·브라우저를 붙이는 ADE입니다.

What is Orca?는 데스크톱에서 여러 코딩 에이전트를 나란히 돌리는 도구라고 설명합니다. 각 작업은 자체 git worktree, 자체 에이전트 터미널, 자체 브라우저 탭을 받습니다. stash나 브랜치 갈아타기 없이 Claude Code, Codex, Cursor CLI를 동시에 쓸 수 있습니다.

Orca가 아닌 것도 문서에 분명합니다.

• 모델이 아닙니다. 이미 쓰는 Claude·Codex·OpenCode 구독을 가져옵니다(bring your own).
• git 대체물이 아닙니다. worktree는 실제 git worktree입니다. cd해서 일반 git을 써도 됩니다.
• 호스팅 VPS 상품이 아닙니다. 기본은 데스크톱입니다. 원격은 본인이 통제하는 SSH·셀프호스트 서버·클라우드 VM입니다.

대상은 이미 코드를 쓰는 사람입니다. diff를 읽고 커밋을 관리한다는 전제입니다. 노코드 도구가 아닙니다. 사이트는 이를 “IDEs were built for you. An ADE is built for you and your agents”로 구분합니다.

CLI는 어떻게 켜나?

한 줄 답: 데스크톱 앱을 설치한 뒤 Settings에서 CLI를 등록하고, 셸에서 orca가 런타임에 붙는지 확인합니다.

앱부터 올립니다. Install 기준입니다.

• macOS / Windows / Linux 데스크톱. Linux는 AppImage·.deb·.rpm.
• macOS Homebrew: brew install --cask stablyai/orca/orca. 안정 채널은 brew upgrade --cask orca.
• 이전 빌드는 GitHub Releases.
• Linux 패키지의 데스크톱 런처 이름은 GNOME Orca 스크린 리더와 겹치지 않게 orca-ide로 적혀 있습니다. 스크립트용 명령은 아래 orca입니다.

첫 실행 시 홈 디렉터리 접근을 묻고, 있으면 ~/.claude·~/.codex·Ghostty 설정을 가져오겠다고 제안한 뒤, 빈 랜딩에서 첫 레포를 추가합니다.

CLI는 앱과 함께 제공됩니다. overview는 Settings → General → Orca CLI에서 등록하라고 하고, reference는 Settings → Experimental → CLI를 가리킵니다. UI 라벨은 빌드마다 다를 수 있으니 두 경로를 Settings에서 찾고, 최신 문구는 공식 페이지를 따릅니다.

에이전트가 같은 CLI 스킬을 쓰게 하려면 문서 예시는 다음과 같습니다.

npx skills add https://github.com/stablyai/orca --skill orca-cli
# headless / Settings UI 없음:
orca skills install --skill orca-cli

orca skills install / update는 런타임에 붙지 않고 Settings가 쓰는 npx skills를 호출합니다.

첫 확인 명령은?

한 줄 답: command -v orca로 PATH를 보고, orca status --json으로 런타임 연결을 확인합니다. 앱이 꺼져 있으면 orca open --json 다음 다시 status입니다.

command -v orca
orca status --json

Orca가 아직 안 떠 있으면:

orca open --json
orca status --json

--json은 다른 도구가 파싱할 때 씁니다. 사람용 출력은 터미널에서 빠르게 볼 때입니다. orca는 이미 떠 있는 런타임에 말 거는 클라이언트입니다. 앱(또는 orca serve)이 없으면 status가 실패하는 것이 정상입니다.

레포를 하나 넣은 뒤에는 문서의 worktree 점검을 이어서 해도 됩니다.

orca worktree ps --json
orca worktree current --json

첫 세션은 docs의 “Your first 3-agent session”을 권합니다. 이 글은 설치·등록·status까지가 범위입니다. worktree 생성과 에이전트 지정은 시리즈 다음 편에서 다룹니다.

출처

• What is Orca?
• Install
• Orca CLI overview
• Orca CLI reference