Orca CLI 참조
셸에서 Orca을 구동하기 위한 명령, 선택기 및 에이전트 친화적인 패턴입니다.
orca CLI는 실행 중인 Orca 런타임과 통신합니다. 셸 스크립트나 에이전트가 작업 트리를 검사하고, 터미널을 실행하고, 파일을 열고, 내장 브라우저를 자동화하거나 진행 상황을 Orca에 다시 보고해야 할 때 이 기능을 사용하세요.
런타임 확인
섹션 제목: “런타임 확인”설정 -> 실험 -> CLI에서 CLI를 등록한 후 Orca에 도달할 수 있는지 확인하세요.
command -v orcaorca status --jsonOrca이 아직 실행되고 있지 않은 경우:
orca open --jsonorca status --json다른 도구가 결과를 구문 분석할 때 --json을 사용하세요. 사람이 읽을 수 있는 출력은 빠른 터미널 점검을 위한 것입니다.
선택자
섹션 제목: “선택자”대부분의 명령은 긴 ID를 요구하는 대신 선택기를 허용합니다.
orca repo show --repo id:<repoId> --jsonorca worktree show --worktree active --jsonorca worktree show --worktree path:/abs/path/to/worktree --jsonorca worktree show --worktree branch:feature-name --jsonorca worktree show --worktree issue:123 --jsonactive 및 current는 셸의 현재 디렉터리나 터미널 컨텍스트를 기준으로 이를 포함하는 Orca 관리 작업 트리로 해석됩니다. 대상 작업 트리 외부에서 실행될 수 있는 스크립트에서는 명시적 선택기를 사용합니다. 원격 런타임에서는 로컬 셸의 현재 디렉터리가 런타임 호스트에 존재하지 않을 수 있으므로 id:<repoId>::<absolute-worktree-path> 또는 path:<absolute-server-path>와 같은 전체 서버 측 선택기를 사용하는 것이 좋습니다.
호스트 선택
섹션 제목: “호스트 선택”현재 Orca 호스트가 대상으로 지정할 수 있는 모든 시스템과 각 시스템의 선택자를 나열합니다:
orca host list --json결과에는 이 시스템, 등록된 SSH 대상 및 페어링된 Remote Orca Servers가 포함됩니다. 이 시스템에는 --host local, SSH 대상에는 --host ssh:<target-id>, 페어링된 서버에는 --environment <server-name>을 사용합니다. SSH 레이블과 페어링된 서버 이름도 고유하면 선택자로 해석됩니다. 이름이 충돌하면 host list에서 가져온 ID를 사용합니다. 시스템 이름을 잘못된 선택자에 지정하면 Orca는 빈 결과를 반환하는 대신 일치하는 시스템과 사용해야 할 플래그를 알려 줍니다.
런타임 명령
섹션 제목: “런타임 명령”orca open --jsonorca status --jsonorca serve --port 6768 --pairing-address 100.64.1.20 --jsonorca serve --supervise --jsonorca serve service install --port 6768 --dry-runorca serve service status --jsonorca serve service uninstall --jsonorca serve restore resume --jsonorca serve은 데스크톱 창을 열지 않고 포그라운드에서 런타임 서버를 시작합니다. 원격 Orca 서버 또는 헤드리스 환경에 사용하고 Ctrl-C로 중지합니다.
orca serve --supervise은 서비스 관리자를 위한 명령입니다. 서버가 중지되면 종료하는 대신 점점 길어지는 지연 시간으로 자체 재시작하고, 업데이트가 앱을 교체하는 동안 기다리며, 반복해서 실패하면 재시도를 중단합니다. orca serve service install는 이 프로필에 대해 orca serve --supervise --no-pairing을 실행하는 사용자별 LaunchAgent(macOS) 또는 systemd 사용자 유닛(Linux)을 작성합니다. orca serve service status는 실행 중인지 보고하고 orca serve service uninstall는 서비스를 중지하고 제거합니다. orca serve restore resume은 자동 터미널 복원의 일시 중지를 해제하고 이전 클라이언트가 요청한 복원 목록을 표시합니다. 아직 Windows에서는 이 명령을 사용할 수 없으며, 서비스 및 감독자 명령을 사용하려면 머신에 Orca 앱이 설치되어 있어야 합니다. 원격 Orca 서버 → orca serve을 서비스로 실행을 참조하세요.
저장소
섹션 제목: “저장소”orca repo list --jsonorca repo add --path /abs/path/to/repo --jsonorca repo show --repo id:<repoId> --jsonorca repo set-base-ref --repo id:<repoId> --ref origin/main --jsonorca repo search-refs --repo id:<repoId> --query main --limit 10 --json많은 작업 트리를 생성하기 전에 저장소 기본 참조를 설정하여 기본적으로 새 작업이 올바른 위치에서 분기되도록 합니다.
세션 검색
섹션 제목: “세션 검색”셸에서 인덱싱된 에이전트 대화 기록을 검색합니다:
orca search --query "rate limit" --scope conversation --limit 20 --jsonorca search --query "migration" --agent codex --since 30d --sort recent --jsonorca search --index-status --json대화 일치 항목과 인덱싱된 전체 텍스트 중에서 선택하려면 --scope conversation|all을 사용합니다. --fresh는 검색 전에 인덱스를 새로 고치며, --limit, --cursor, --agent, --path, --since, --sort은 결과 범위를 좁히거나 페이지를 나눕니다. --index-status는 쿼리를 실행하지 않고 인덱싱 상태를 보고합니다. 해당 호스트가 액세스를 허용한 경우 결과에 연결된 컴퓨터와 페어링된 서버의 세션도 포함될 수 있습니다.
작업 트리
섹션 제목: “작업 트리”orca worktree list --repo id:<repoId> --jsonorca worktree ps --jsonorca worktree current --jsonorca worktree show --worktree active --jsonorca worktree create --repo id:<repoId> --name fix-login --jsonorca worktree create --name child-task --agent codex --prompt "Investigate the flaky login test" --jsonorca worktree set --worktree active --comment "reproduced failure; testing token refresh fix" --jsonorca worktree set --worktree active --workspace-status in-review --unread --jsonorca worktree rm --worktree id:<worktreeId> --force --jsonworktree create이 Orca 관리 작업 트리 내부에서 실행되면 Orca은 관계를 유추할 수 있을 때 새 작업 트리를 하위 작업 트리로 기록합니다. 명시적으로 하려면 --parent-worktree active를 전달하고 새 작업이 독립적인 경우에는 --no-parent를 전달합니다.
worktree set --unread 명령은 사이드바의 작업 공간에 읽지 않음 점을 표시합니다. 이는 에이전트가 완료될 때 Orca가 표시하는 점과 같습니다. --read 옵션은 이 표시를 지웁니다.
에이전트 시작 플래그:
orca worktree create --name review-api --agent claude --setup run --jsonorca worktree create --name quick-check --agent codex --prompt "Summarize the diff" --setup skip --jsonorca worktree create --name hidden-setup --setup inherit --json--agent 옵션은 선택한 에이전트를 첫 번째 터미널에서 시작합니다. --prompt는 터미널에서 실행 중인 에이전트를 포함해 해당 에이전트에 초기 작업을 직접 전송합니다. --setup run|skip|inherit 옵션은 저장소 설정 후크를 제어하며, inherit 값은 저장소 정책을 따릅니다.
작업 트리에 이미 저장된 작업 공간 메타데이터를 사용하여 이슈와 리뷰를 연결합니다:
orca worktree create --repo id:<repoId> --name review-task --pr 123 --jsonorca worktree create --repo id:<repoId> --name gitlab-task --gitlab-issue 42 --gitlab-mr 77 --jsonorca worktree set --worktree active --gitlab-issue '#42' --gitlab-mr '!77' --jsonorca worktree set --worktree active --pr null --gitlab-mr null --json--pr은 GitHub 풀 리퀘스트 번호입니다. --gitlab-issue 플래그는 이슈 번호 또는 #42를 허용하며, --gitlab-mr 플래그는 병합 요청 번호 또는 !77을 허용합니다. GitLab 플래그는 자체 호스팅 인스턴스와 중첩 그룹을 포함한 HTTP(S) 이슈 또는 병합 요청 URL도 허용합니다. 단, URL의 호스트와 프로젝트가 작업 공간에 저장된 GitLab 소스 컨텍스트 또는 저장소의 원격과 일치해야 합니다. 플래그를 생략하면 해당 링크가 변경되지 않습니다. set에서 리터럴 null을 지정하면 명시한 링크만 지워지며, create 명령에서는 null을 허용하지 않습니다. 제공자별 필드는 분리되어 있으므로 GitLab 링크를 설정해도 GitHub 및 Linear 링크는 유지됩니다.
기존 작업 공간에서 에이전트 시작
섹션 제목: “기존 작업 공간에서 에이전트 시작”orca agent launch --agent codex --jsonorca agent launch --agent codex --model gpt-6-astra --effort high --prompt "Write the design doc" --jsonorca agent launch --agent claude --worktree path:/projects/myapp --focus --jsonagent launch는 새 에이전트 탭과 같은 방식으로 에이전트를 시작합니다. 채팅 UI 설정이 켜져 있고 에이전트와 호스트가 지원하면 구조화된 채팅으로, 그렇지 않으면 터미널로 시작합니다. 결과에는 열린 화면(outcome.kind)과 그 이유가 표시됩니다. --worktree의 기본값은 현재 디렉터리를 포함하는 작업 트리 또는 폴더 작업 공간입니다. 완전히 새로운 체크아웃에는 orca worktree create --agent를 사용합니다. --model과 --effort(--model 필요)은 어느 화면에도 적용되며, --focus를 전달하지 않으면 탭이 포커스를 가져오지 않고 열립니다. 시작 응답을 잃어버렸다면 두 번째 에이전트를 시작하지 말고 같은 호스트의 같은 디렉터리에서 동일한 명령을 --retry-launch <operationId>과 함께 다시 실행합니다.
작업 공간은 저장소 외부 소스를 포함해 여러 검토와 이슈를 연결할 수 있습니다.
orca reference list --worktree name:api --jsonorca reference add https://github.com/acme/api/pull/5123 https://linear.app/acme/issue/STA-1234 --worktree name:api --jsonorca reference remove https://github.com/acme/api/pull/5123 --worktree name:api --jsonorca reference remove --key '<key-from-list>' --worktree name:api --jsonorca worktree create --name fix --reference https://github.com/acme/api/pull/5123 --reference https://linear.app/acme/issue/STA-1234 --jsonorca reference find STA-1234 --json- 쓰기는 전체 URL을 받습니다.
remove --key은 URL이 없는list의 이전 링크도 처리합니다. 중복 추가와 존재하지 않는 항목 제거는 아무 작업도 하지 않으며 관련 없는 링크는 보존됩니다. 연결된 이슈 플래그(--pr,--gitlab-issue,--linear-issue)와--reference은 한 명령에서 함께 사용할 수 없습니다. - 찾기는 전체 URL 또는
STA-1234같은 기본 이슈 키를 받으며 숫자만 입력하면 거부됩니다. 저장된 메타데이터만 읽고 공급자 요청이나 대화 기록 검색은 하지 않으며, 일치하는 작업 공간과 연결된 에이전트를 각 에이전트의linked상태 및 터미널 또는 사서함 주소와 함께 반환합니다. 대화 텍스트를 검색하려면orca search를 사용합니다.
그런 다음 찾은 에이전트의 명시적 주소로 메시지를 보냅니다.
orca terminal send --terminal '<terminal-from-find>' --text 'Status?' --enterorca orchestration send --to '<mailbox-from-find>' --subject 'Status?' --type question터미널
섹션 제목: “터미널”orca terminal list --worktree active --jsonorca terminal show --terminal <handle> --jsonorca terminal read --terminal <handle> --jsonorca terminal read --terminal <handle> --screen --jsonorca terminal read --terminal <handle> --cursor <cursor> --limit 1000 --jsonorca terminal send --terminal <handle> --text "continue" --enter --jsonorca terminal wait --terminal <handle> --for tui-idle --timeout-ms 300000 --jsonorca terminal create --worktree active --title "tests" --command "npm test" --jsonorca terminal split --terminal <handle> --direction horizontal --command "npm run dev" --jsonorca terminal rename --terminal <handle> --title "runner" --jsonorca terminal switch --terminal <handle> --jsonorca terminal close --terminal <handle> --json현재 작업 트리의 활성 터미널을 대상으로 하려면 --terminal을 생략하세요. 단말기가 무엇을 기다리고 있는지 확실하지 않은 경우 보내기 전에 읽어보십시오.
터미널 핸들
터미널 핸들은 런타임 범위입니다. Orca이 다시 시작되거나 명령이 오래된 터미널 핸들을 보고하는 경우 orca terminal list --json를 실행하고 핸들을 다시 획득하세요.
terminal list는 각 터미널의 executionHostId를 보고하며, Orca가 이를 확인할 수 있는 경우에만 포함합니다. 또한 포함된 호스트 ID와 생략된 호스트 ID가 들어 있는 결과 수준의 hostScope를 보고합니다. 호스트 ID 또는 범위가 없으면 로컬로 간주하지 말고 확인 불가로 취급합니다. 누락된 터미널의 실행 호스트가 hostScope.hostIds에 나열된 경우에만 해당 터미널이 종료되었다는 증거가 됩니다.
기본적으로 terminal read는 터미널 이스케이프 문자를 제거한 누적 출력 스트림을 반환합니다. 따라서 줄을 다시 그리는 프로그램은 여러 조각이 쌓인 것처럼 보일 수 있습니다. 현재 렌더링된 프레임이 필요하면 --screen을 사용합니다. 응답의 source는 stream, screen 또는 screen-unavailable을 식별합니다. 화면 읽기에는 페이지를 이동할 기록이 없으므로 --screen과 --cursor은 함께 사용할 수 없습니다.
출력이 길면 커서 읽기를 사용합니다. 한 번의 스트림 읽기에서 nextCursor를 저장한 다음 --cursor와 함께 다시 전달하여 새 출력만 가져옵니다.
orca file open src/App.tsx --worktree active --jsonorca file diff src/App.tsx --staged --worktree active --jsonorca file open-changed --mode both --worktree active --json경로는 선택한 작업 트리를 기준으로 합니다. open-changed은 git 상태를 읽고 편집, 비교 또는 두 모드 모두에서 변경된 파일을 엽니다.
이 명령은 화면에 표시된 작업 트리에서도 현재 보기를 바꾸지 않고 파일을 탭으로 엽니다. 열린 탭을 화면에 표시하려면 --focus를 전달합니다. 에이전트는 사용자가 파일을 보도록 요청한 경우에만 이 플래그를 전달해야 합니다.
내장 브라우저
섹션 제목: “내장 브라우저”브라우저 명령은 선택한 작업 트리에 대한 Orca의 내장 브라우저 탭을 제어합니다. Chrome, Safari 또는 Orca 데스크톱 UI를 제어하지 않습니다.
스냅샷 -> 작업 -> 스냅샷 루프를 사용하세요.
orca goto --url http://localhost:3000 --worktree active --jsonorca snapshot --worktree active --jsonorca click --element @e3 --worktree active --jsonorca fill --element @e1 --value "[email protected]" --worktree active --jsonorca wait --text "Welcome" --worktree active --jsonorca screenshot --worktree active --json@e3과 같은 참조는 snapshot에서 나옵니다. 탐색, 탭 전환, 페이지를 변경하는 클릭 및 오래된 참조 오류 후에 다시 스냅샷을 찍습니다.
탭 및 캡처 명령:
orca tab list --worktree active --jsonorca tab create --url http://localhost:3000 --worktree active --jsonorca tab switch --index 1 --worktree active --jsonorca capture start --worktree active --jsonorca console --limit 50 --worktree active --jsonorca network --limit 50 --worktree active --jsonorca full-screenshot --worktree active --jsonorca pdf --worktree active --json아직 입력된 Orca 명령이 없는 브라우저 작업에만 orca exec --command "<agent-browser command>" --json을 사용하세요.
브라우저 장치 에뮬레이션:
orca set device --name "iPhone 12" --worktree active --jsonorca screenshot --worktree active --json데스크탑 컴퓨터 사용
섹션 제목: “데스크탑 컴퓨터 사용”내장 브라우저 외부의 기본 데스크톱 앱에는 orca computer을 사용하세요.
orca computer permissions --jsonorca computer list-apps --jsonorca computer get-app-state --app com.apple.Safari --jsonorca computer click --app com.apple.Safari --element-index 12 --jsonorca computer paste-text --app com.apple.Safari --text "hello" --json전체 작업 흐름 및 권한 설정은 컴퓨터 사용을 참조하세요.
모바일 에뮬레이터
섹션 제목: “모바일 에뮬레이터”모바일 에뮬레이터 명령은 Orca의 작업 트리 범위 브리지를 통해 iOS 시뮬레이터 장치를 제어합니다. 에이전트가 Orca 내부에서 작동 중일 때 원시 serve-sim 또는 simctl 대신 이를 사용하면 수명 주기 및 활성 장치 상태가 현재 작업 트리에 계속 연결됩니다.
orca emulator list --worktree active --jsonorca emulator attach "<device-name-or-udid>" --worktree active --jsonorca emulator tap 0.5 0.7 --worktree active --jsonorca emulator type "hello" --worktree active --jsonorca emulator gesture '[{"type":"begin","x":0.5,"y":0.8},{"type":"move","x":0.5,"y":0.4},{"type":"end","x":0.5,"y":0.2}]' --worktree active --jsonorca emulator button home --worktree active --jsonorca emulator rotate landscape_left --worktree active --jsonorca emulator exec --command "tap 0.5 0.7" --worktree active --jsonorca emulator kill --worktree active --jsonorca emulator shutdown --worktree active --json좌표는 0에서 1로 정규화됩니다. 단일 탭에는 tap을 선호하고, 드래그 또는 다단계 터치 입력에는 gesture를 사용하세요. 스크립트가 작업 트리의 활성 에뮬레이터 대신 특정 시뮬레이터를 대상으로 해야 하는 경우 --device <udid-or-name> 또는 --emulator <id>을 전달합니다.
Linear 연동
섹션 제목: “Linear 연동”orca linear 인터페이스는 에이전트가 orca-linear 스킬을 통해 사용합니다(이전 설치 이름 linear-tickets도 계속 작동함). --json를 우선 사용합니다. 연결된 작업 트리는 --current로 확인합니다.
orca linear issue --current --full --jsonorca linear issue ENG-123 --comments --children --relations --activity --jsonorca linear search "auth bug" --workspace all --jsonorca linear list --filter assigned --limit 10 --jsonorca linear list-issues --team ENG --state started --assignee me --jsonorca linear list-issues --query auth --updated-at -P7D --cursor <cursor> --workspace <id> --jsonorca linear team list --jsonorca linear team states --team ENG --jsonorca linear team labels --team ENG --jsonorca linear project list --query launch --json--full은 댓글, 하위 항목, 첨부 파일, 관계 및 활동을 확장합니다. 섹션 플래그(--comments, --children, --attachments, --relations, --activity)는 개별적으로 작동합니다.
MCP 형식 쓰기
섹션 제목: “MCP 형식 쓰기”# Create or update (omit id/--current to create; requires --team and --title on create)orca linear save-issue --team ENG --title "Fix auth" --priority high --jsonorca linear save-issue ENG-123 --state "In Progress" --assignee me --jsonorca linear save-issue --current --project null --due-date null --json
orca linear relation add ENG-1 --related ENG-2 --type blocks --jsonorca linear relation remove ENG-1 --related ENG-2 --type related --jsonsave-issue 레이블은 전체 레이블 집합을 대체합니다(Linear MCP의 save_issue 의미 체계). 리터럴 null는 담당자, 추정치, 기한, 프로젝트 또는 상위 항목을 지웁니다.
필드 도우미(계속 유효함)
섹션 제목: “필드 도우미(계속 유효함)”orca linear status set --current --to "In Progress" --jsonorca linear assignee set --current --me --jsonorca linear priority set ENG-123 --to high --jsonorca linear estimate set --current --to 3 --jsonorca linear due-date set --current --to 2026-08-01 --jsonorca linear label add --current --label backend --jsonorca linear comment add --current --body "Investigating regression" --jsonorca linear comment edit <commentId> --body "Investigating the regression" --jsonorca linear comment delete <commentId> --jsonorca linear attach --current --url https://example.com/repro --title "Repro" --jsonorca linear create --title "Flaky login test" --team ENG --priority high --jsoncomment edit와 comment delete는 정확한 Linear 댓글 ID를 대상으로 하며, comment rm은 삭제의 별칭입니다. 대체 텍스트를 파일이나 표준 입력에서 가져오는 경우 편집할 때 --body-file <path|->를 사용합니다.
버전이 일치하는 목록을 확인하려면 orca linear --help 또는 orca skills get orca-linear를 실행합니다. Orca에 연결된 작업 트리 외부에서 스크립트가 실행될 수 있으면 명시적인 이슈 ID(예: ENG-123)를 전달합니다.
스킬(로컬, 런타임 불필요)
섹션 제목: “스킬(로컬, 런타임 불필요)”데스크톱 Settings(설정) UI 없이 번들 가이드 목록을 확인하고, 버전에 맞는 가이드를 출력하거나 하이브리드 스킬 패키지를 install/update합니다.
orca skills listorca skills get orca-cliorca skills get orchestration --fullorca skills install --skill orca-cli --skill orchestrationorca skills install --all --dry-runorca skills update --allinstall / update는 Settings(설정)에서 사용하는 것과 동일한 npx skills 명령을 셸에서 실행합니다. Orca 런타임에는 연결하지 않습니다. Orca 스킬을 참조합니다.
계정(호스트 로컬 런타임)
섹션 제목: “계정(호스트 로컬 런타임)”Orca을 실행하는 헤드리스 호스트(orca serve 또는 데스크톱 앱)에서 원격 클라이언트가 **Add account(계정 추가)**를 사용할 수 없는 경우(원격 런타임 범위에서는 해당 버튼이 비활성화됨) 관리형 Claude/Codex 계정을 추가합니다.
orca account listorca account add # Claude by defaultorca account add --agent codexaccount add는 호스트의 현재 터미널에서 claude login / codex login을 실행한 다음, 수집한 자격 증명을 로컬 런타임에 등록합니다. Codex는 기기 인증을 사용하므로 다른 시스템의 브라우저에서 인증을 완료할 수 있습니다. 클라이언트 전용 원격 세션을 통하지 말고 계정을 소유하는 시스템에서 이 명령을 실행합니다.
아티팩트
섹션 제목: “아티팩트”로그인한 Orca 계정을 통해 HTML 또는 Markdown을 게시합니다. 공개 링크를 보는 데는 로그인이 필요하지 않지만 create/list/update/delete 작업에는 로그인이 필요합니다. 게시 기능은 기본적으로 꺼져 있으며, 사용자가 기기에서 **Settings → Artifacts → Allow publishing public artifact links(설정 → 아티팩트 → 공개 아티팩트 링크 게시 허용)**를 활성화해야 합니다. 이 설정을 허용하는 CLI 플래그는 없습니다. 게시 기능을 끈 뒤에도 링크를 감사하거나 취소할 수 있도록 list, unshare, delete는 계속 사용할 수 있습니다.
orca artifacts share ./report.html --jsonorca artifacts share ./notes.md --jsonorca artifacts update ./notes.md --jsonorca artifacts unshare ./notes.md --jsonorca artifacts list --jsonorca artifacts list --cursor <cursor> --jsonorca artifacts delete <id> --json- 허용되는 파일 형식은
.html,.htm,.md,.markdown입니다. - 공유 아티팩트 콘텐츠는 파일당 10 MiB로 제한됩니다.
share는 편집 토큰을 활성 Orca 프로필에 저장하며 출력하지 않습니다.update과unshare은 파일을 처음 공유한 것과 같은 로컬 경로 및 프로필을 기준으로 대상을 찾습니다.list는 페이지를 나누며(nextCursor→--cursor),delete는list에서 확인한 아티팩트 ID를 사용하므로 원본 파일이 필요하지 않습니다.- 상대 경로 HTML 자산은 업로드되지 않으므로 자체 완결형 HTML 또는 절대 자산 URL을 공유합니다.
- 허용되지 않은 publish/update 작업은
artifact_sharing_disabled오류로 실패합니다. 재시도하지 말고 설정을 수정합니다. - 데스크톱에서는 로컬 HTML 또는 Markdown 파일을 열고 **
Share as artifact(아티팩트로 공유)**를 사용하거나, 사이드바의Artifacts(아티팩트) 페이지에서 링크를 관리합니다.
자동화, 환경 및 후크
섹션 제목: “자동화, 환경 및 후크”예약된 프롬프트:
orca automations list --jsonorca automations create --name "Daily review" --trigger daily --time 09:00 --prompt "Review open changes" --provider claude --repo id:<repoId> --extra-agent-args="--model opus" --disabled --jsonorca automations run <automationId> --json--extra-agent-args 옵션은 호스트의 기본값을 변경하지 않고 특정 자동화의 새 실행에 사용할 모델 또는 노력 수준을 설정합니다. 예약 자동화를 참조합니다.
관리형 SSH 서버:
orca environment list --jsonorca environment status --environment <selector> --jsonorca environment update --environment <selector> --jsonorca environment rollback --environment <selector> --jsonorca environment recover --environment <selector> --jsonorca environment stop --environment <selector> --yes --jsonorca environment forget --environment <selector> --yes --json--environment 옵션은 이 컴퓨터가 SSH를 통해 배포한 관리형 Orca 서버를 지정합니다(**Settings → Managed servers(설정 → 관리형 서버)**와 동일한 동작). stop은 서버를 폐기하고 forget은 호스트가 사라진 서버의 연결을 해제합니다. SSH 작업 트리 → 관리형 Orca 서버를 참조합니다.
원격 런타임 환경:
orca environment add --name work-laptop --pairing-code "orca://pair?code=..." --jsonorca environment list --jsonorca environment rm --environment <selector> --json에이전트 상태 훅:
orca agent hooks status --jsonorca agent hooks on --jsonorca agent hooks off --json상담원 습관
섹션 제목: “상담원 습관”- 자동화 및 에이전트 호출에는
--json을 선호합니다. - UI 레이블을 구문 분석하는 것보다 선택기를 선호합니다.
- 다음 입력이 확실하지 않은 한 입력을 보내기 전에 터미널 상태를 읽습니다.
- 진행 체크포인트에 작업 트리 설명을 사용합니다. 작업 트리 체크포인트를 참조하세요.
- 추적된 다중 에이전트 파견을 위해 임시 터미널 프롬프트 대신 오케스트레이션을 사용합니다.