Tổng quan Orca CLI

Bài viết được dịch tự động từ bài viết gốc, chưa được kiểm tra lại bởi con người. Chỉ những bài viết có dấu tick xanh cạnh tiêu đề là đã được kiểm tra.

Dùng Orca CLI để script hoá Orca từ terminal, quản lý worktree, điều khiển terminal agent, tự động hoá trình duyệt built-in, và cài skill agent.

Orca CLI là lệnh orca để script hoá một editor Orca đang chạy từ bất kỳ shell nào. Dùng nó để tạo và kiểm tra worktree, điều khiển terminal agent, mở file và diff, tự động hoá trình duyệt built-in, chạy automation theo lịch, chia sẻ artifact HTML/Markdown, và điều khiển các tool native của Orca từ script hoặc AI agent.

CLI đi kèm sẵn app desktop; đăng ký nó ở Settings → General → Orca CLI.

Agent có thể cài skill Orca CLI tương ứng bằng:

npx skills add https://github.com/stablyai/orca --skill orca-cli
# headless / không có Settings UI:
orca skills install --skill orca-cli

Xem Skills registry & MCP để biết mọi skill Orca có thể cài, gồm cả orca skills install / orca skills update.

Orca CLI - điều khiển worktree, terminal, và trình duyệt built-in từ bất kỳ shell nào

Cài đặt & xác minh

command -v orca
orca status --json

Lệnh worktree

orca worktree ps --json
orca worktree create --repo id:<repoId> --name my-task --issue 123 --json
orca worktree current --json
orca worktree set --worktree active --comment "reproduced bug" --json
orca worktree rm --worktree id:<id> --force --json

Để biết selector, flag setup, worktree cha/con, và bản đồ lệnh đầy đủ, xem Orca CLI reference.

Lệnh terminal

orca terminal list --json
orca terminal read --json
orca terminal send --text "continue" --enter --json
orca terminal wait --for tui-idle --timeout-ms 30000 --json
orca terminal create --worktree path:/projects/app --command "npm test" --json
orca terminal split --direction vertical --command "npm run dev" --json

Với công việc đa agent cần theo dõi, dùng Orchestration thay vì prompt terminal thuần.

Lệnh file

Mở file và diff trong worktree Orca đang active từ một shell:

orca file open src/App.tsx
orca file diff src/App.tsx --staged
orca file open-changed --mode both

Dùng --worktree <selector> khi thư mục hiện tại của shell không nằm trong worktree đích.

Browser profile

Browser profile cách ly state session tab, để một script hoặc agent có thể test với cookie, local storage, và danh tính đăng nhập khác nhau. CLI expose lệnh profile dưới orca tab profile; bắt đầu với orca tab profile list --json, rồi dùng create, set, clone, hoặc use-default khi cần.

Automation theo lịch

Dùng orca automations để tạo, kiểm tra, chạy, và xóa task Orca theo lịch từ một shell. Bắt đầu với Scheduled automations khi muốn một prompt lặp lại định kỳ chạy trên một repo hoặc một worktree có sẵn.

Artifact

Chia sẻ HTML hoặc Markdown thành link xem công khai qua tài khoản Orca đã đăng nhập (orca artifacts share|update|list|delete). Publish là opt-in ở Settings → Artifacts. Chi tiết lệnh: CLI reference → Artifacts.

Tự động hoá trình duyệt

CLI cũng điều khiển trình duyệt built-in bằng vòng lặp snapshot-tương tác-snapshot lại:

orca goto --url https://example.com --json
orca snapshot --json # trả về ref như @e1, @e3
orca click --element @e3 --json
orca fill --element @e1 --value "test@example.com" --json
orca screenshot --json

Để kiểm tra responsive trình duyệt, chuyển tab đang active sang một device profile đã đặt tên:

orca set device --name "iPhone 12" --json
orca screenshot --json

Mobile emulator

CLI cũng có thể điều khiển một iOS Simulator qua cầu nối mobile emulator của Orca. Nó giới hạn theo worktree đang active, nên agent và script có thể gắn một simulator từ orca emulator list, tap toạ độ đã chuẩn hoá, gõ text, gửi cử chỉ, xoay thiết bị, và tắt nó mà không cần rời khỏi Orca.

orca emulator list --json
orca emulator attach "<device-name-or-udid>" --json
orca emulator tap 0.5 0.7 --json
orca emulator type "hello" --json
orca 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}]' --json
orca emulator rotate landscape_left --json
orca emulator kill --json

Dùng --worktree <selector>, --device <udid-or-name>, hoặc --emulator <id> khi một script cần chỉ định rõ target.

Để xem toàn bộ bề mặt lệnh gồm cả tab, wait, cookie, và frame, xem Orca CLI reference, rồi cài skill Orca CLI (xem Skills registry) và trỏ agent của bạn vào đó.

Phuc Tran

Software Engineer | Learning Claude