SuperAPI AI 工具集

orca-cli

通用与其它

查看项目

更新于 10-16 09:47

技能介绍

用途:当任务应通过 Orca 控制面完成,而非直接使用 git、shell PTY 或临时文件系统访问时使用本技能。适用于在运行中的 Orca 应用内编排工作树、更新工作树备注、读取或控制终端、管理计划自动化、访问 Orca 已知仓库,以及驱动内置浏览器。

主要能力:

  • repo:列出、查看、添加仓库,设置 base ref,搜索 refs。
  • worktree:list/ps/current/show/create/set/rm,支持 id:、path:、branch:、issue:、active/current 选择器;创建时可指定 --parent-worktree active 或 --no-parent 表达谱系意图。
  • automations:list/show/create/edit/run/runs/remove;触发器支持 hourly、daily、weekdays、weekly、5 段 cron 或 RRULE;用 --repo 每次运行新建工作树,或用 --workspace/--workspace-mode existing 在已有工作树运行,两者互斥;--reuse-session 复用上一活动终端,--fresh-session 关闭复用。
  • terminal:list/show/read/send/wait/stop/create/split/rename/switch/close;省略 --terminal 时自动解析当前工作树的活动终端;长记录用 cursor 分页读取;句柄可能因重载失效,遇 terminal_handle_stale 需用 list 重新获取。
  • 浏览器:goto、snapshot、click 等,按 snapshot-交互-再 snapshot 循环,元素 ref 如 @e1 仅限单标签页且导航或切换后失效;默认只作用于当前工作树标签页,可加 --worktree all 跨工作树。

使用方式:先检查命令是否存在 command -v orca,再用 orca status --json 确认运行时;未运行可用 orca open --json 启动。若 orca 不在 PATH,应明确说明并停止或请用户先安装/注册 CLI。

限制:不要在普通 shell 更简单且不关心 Orca 状态时使用;不要编辑自动化存储文件,应通过 CLI;不要仅凭通用环境变量判断自己“在 Orca 内”;工作树句柄与浏览器 ref 均会失效,需重新获取;资料未提供安装方式、平台支持与收费信息。