用途:orca-cli 面向需要以 Orca 运行中的编辑器/运行时为事实来源的场景,用于操作 Orca 管理的工作树、文件夹上下文、终端、仓库、自动化、工作树评论以及 Orca 应用内置的浏览器。常见触发场景包括 Orca 工作树、子工作树、在工作树中启动 codex/claude、读取/等待/发送 Orca 终端、完整交接给其他智能体,以及控制 Orca 内置浏览器。当 Orca 状态无关紧要时,应使用普通 shell 工具。
主要能力与用法:先为本次会话解析 CLI 可执行文件并复用。若设置了 ORCA_CLI_COMMAND,使用其值;若处于暴露 ORCA_DEV_REPO_ROOT 的开发检出,使用 orca-dev;若在 Linux 且不在 Orca 管理的终端中,使用 orca-ide(切勿在此处直接运行裸 orca,它通常解析为 GNOME Orca 屏幕阅读器并触发语音);否则使用 orca。文中 ORCA 为占位符,运行前需替换,不要创建 shell 变量或直接运行 ORCA 字面量。
运行具体命令前先加载完整指南:ORCA skills get orca-cli,它会打印与二进制版本匹配的完整指南。不要凭记忆或缓存的发现说明猜测子命令和标志。用 ORCA status --json 确认应用运行(必要时用 ORCA open --json 启动),代理驱动调用优先使用 --json。若旧版 Orca 明确报告 skills get 是未知命令,仅可用有界的只读引导:ORCA status --json、ORCA worktree ps --json、ORCA terminal list --json,并告知用户更新 Orca 可恢复完整指南;其他命令应先询问用户。
限制:本资料为发现存根而非完整用法指南,未提供具体子命令和标志清单、版本支持范围、收费方式及平台细节,这些事实暂未提供。若所选可执行文件无法运行,应报告确切错误并停止,不要回退到其他可执行文件。