CLI = Orca 的脚本化接口Orca CLI 就是
orca 命令：从任意 shell 对正在运行的 Orca 编辑器发指令——创建/检查工作树、驱动 Agent 终端、打开文件与 diff、自动化内置浏览器、跑定时任务、分享产物。CLI 是什么
Orca CLI 随桌面应用一起发布。注册后（Settings → General → Orca CLI），任何 shell 里的脚本或 AI Agent 都能用它驱动一个正在运行的 Orca 实例：
| 能力域 | 典型命令 |
|---|---|
| 工作树 | orca worktree ps / create / set / rm |
| 终端 | orca terminal list / read / send / wait |
| 文件 | orca file open / diff / open-changed |
| 浏览器 | orca goto / snapshot / click / fill / screenshot |
| 定时任务 | orca automations create / list / edit |
| 产物分享 | orca artifacts share / update / list / delete |
| 移动模拟器 | orca emulator list / tap / type / rotate |
Agent 也能装上对应的 CLI 技能，让编码 Agent 自己来驱动 Orca：
npx skills add https://github.com/stablyai/orca --skill orca-cli
# 无设置界面的无头环境：
orca skills install --skill orca-cli
验证运行时
CLI 是「会话型」的——它必须能连到一个正在运行的 Orca 实例：
command -v orca
orca status --json # 检查能否连上运行时
Orca 没在跑时先启动它：
orca open --json # 打开 Orca
orca status --json # 再验证
任何时候脚本要解析输出，都加 --json——人类可读输出只适合终端快速检查。
浏览器自动化：快照-交互-再快照
CLI 驱动内置浏览器的方式是经典的「快照-交互-再快照」循环：
orca goto --url https://example.com --json
orca snapshot --json # 返回 @e1、@e3 等元素引用
orca click --element @e3 --json
orca fill --element @e1 --value "hello" --json
orca screenshot --json
Agent 看到的是同一个浏览器、同一批标签页——和你手动操作的完全一致。响应式检查还能切命名设备：
orca set device --name "iPhone 12" --json
orca screenshot --json
移动模拟器桥
CLI 还能驱动 iOS Simulator：orca emulator list、attach、tap 0.5 0.7（归一化坐标）、type、gesture、rotate landscape_left、kill。作用域在当前工作树内，Agent 和脚本可以附着模拟器做端到端验证。
落地练习：让 CLI 和 Orca 握手
- 确认桌面版已装，找到 CLI（macOS 通常在应用菜单注册）
- 跑
orca status --json，确认输出包含运行时信息 - 用
orca open --json体验一次未运行时的自动打开 - 对一个本地页面跑一轮
goto → snapshot → screenshot - 装好 orca-cli 技能：
npx skills add https://github.com/stablyai/orca --skill orca-cli --global
怎么判断做对了？——你能不看文档写出「验证连接」与「浏览器快照」两个最小命令，并解释为什么脚本统一用
--json。
卡住了怎么办？ command -v orca 没输出：先在 Settings → General → Orca CLI 里注册 CLI 路径；连不上运行时：确认桌面应用在跑（orca status --json 报错时先 orca open）。
小结
- Orca CLI = 对运行中 Orca 的脚本化接口，随桌面版发布
- 能力域：工作树 / 终端 / 文件 / 浏览器 / 定时 / 产物 / 模拟器
orca status --json验证连接，脚本一律--json- 浏览器自动化走「快照-交互-再快照」循环，Agent 共享同一浏览器
- 技能安装：
npx skills add ... --skill orca-cli
下一节，CLI 的实战命令。