用途：orca-cli 是一份发现桩说明，用于指导如何通过公开的 orca CLI 操作由 Orca 编辑器/运行时管理的资源，包括 worktree、文件夹上下文、终端、仓库、自动化、产物、技能共享、worktree 评论，以及 Orca 应用内置浏览器。当 Orca 运行状态是事实来源时应使用它；若 Orca 状态无关，则用普通 shell 工具。典型触发场景有 Orca worktree、子 worktree、在 worktree 中启动 codex/claude、读取/等待/发送 Orca 终端、整体交接（handoff/handover/交给另一个 agent）、控制 Orca 内置浏览器。
主要能力：涵盖 worktree 与子 worktree 管理、文件夹上下文、终端读写与等待、仓库、自动化、产物、技能共享、worktree 评论和内置浏览器控制。
使用方式：先为本会话确定可执行文件并复用：若设置了 ORCA_CLI_COMMAND 环境变量，用其值；否则若开发检出暴露 ORCA_DEV_REPO_ROOT，用 orca-dev；否则在 Linux 非 Orca 管理终端中，用 orca-ide（不要运行裸 orca，它通常解析为 GNOME Orca 屏幕阅读器）；否则用 orca。ORCA 是占位符，执行前替换，不要真的运行 ORCA，也不要用 shell 变量。若所选可执行文件无法运行，报告原始错误并停止，不要回退到其他可执行文件。运行 Orca 命令前先加载完整指南：ORCA skills get orca-cli，它会打印与二进制版本匹配的完整指南，先读再执行具体命令。不要凭记忆猜测子命令或标志，它们会随版本变化。可用 ORCA status --json 确认应用已启动（必要时用 ORCA open --json 启动），agent 驱动调用优先加 --json。若旧版 Orca 不识别 skills get（仅在明确报告该命令未知时），用受限只读引导：ORCA status --json、ORCA worktree ps --json、ORCA terminal list --json，并提示用户更新 Orca；除此之外应向用户询问，不要猜测该旧二进制可能不支持的命令面。
限制：本文件不是用法指南，不列出具体子命令与标志。具体命令、标志与收费、价格、平台等信息暂未提供。