SuperAPI AI 工具集

orca-cli

通用与其它

查看项目

更新于 10-15 23:41

技能介绍

用途:当 Orca 正在运行的编辑器/运行时是唯一事实来源时,使用公开的 orca CLI 操作其管理的工作树/工作区、终端、仓库、自动化、工作树评论以及内置浏览器。Linux 上凡本文提到 orca 处改用 orca-ide。若 Orca 状态无关,则用普通 shell 工具。

主要能力:仓库管理(repo list/show/add/set-base-ref/search-refs);工作树管理(list/ps/current/show/create/set/rm),支持 id:、path:、branch:、issue: 及 active/current 选择器,创建时可指定 --agent、--prompt、--setup run|skip|inherit、--run-hooks、--no-parent 等;工作树评论用于在列表/卡片显示简短进度;终端管理(list/show/read/send/wait/stop/create/split/rename/switch/close),支持 --for exit 与 --for tui-idle;自动化(list/show/create/edit/run/runs/remove),支持 hourly、daily、weekdays、weekly、5 段 cron 或 RRULE 调度;内置浏览器(goto/snapshot/click/fill/type/select/check/scroll/hover/focus/keypress/upload/wait/eval/tab/cookie/capture/console/network/exec)。

使用方式:先确认 command -v orca || command -v orca-ide,再执行 orca status --json、orca worktree ps --json、orca terminal list --json;未运行则 orca open --json。智能体调用优先加 --json。终端句柄为运行时作用域,Orca 重启或返回 terminal_handle_stale 后需用 terminal list 重新获取。浏览器采用 snapshot-interact-re-snapshot 循环,导航、切换标签或 browser_stale_ref 后需重新 snapshot。

适用场景:需要以 Orca 状态为准的工作树/终端编排、定时自动化、内置浏览器交互与进度评论更新。

限制:内置浏览器仅指 Orca 内嵌浏览器标签,不是 Chrome/Safari 或桌面应用 UI;桌面控制需用 orca computer ...。--repo 与 --workspace 互斥。旧版 CLI 若不支持 --agent、--prompt、--setup,需先普通创建再 terminal create/send。资料未提供收费、价格与平台支持等细节。