mcpField
O
orca-cli

orca-cli

github.com/seven-day-incAgent 工作流0212 次安装9 周前更新
代码仓库

关于 orca-cli

orca-cli 是用于操作 Orca 编辑器和运行时的技能，依赖与当前版本匹配的命令行指南。它要求 Agent 在执行命令前读取实时指南，避免依赖可能过时的说明。

主要功能

  1. 01解析适用的 Orca 可执行文件
  2. 02获取版本匹配的 CLI 指南
  3. 03以 JSON 查看应用状态
  4. 04了解工作树和终端操作

适用场景

  1. 01操作 Orca 管理的工作树
  2. 02读取或控制 Orca 终端
  3. 03将工作交接给其他 Agent
  4. 04使用 Orca 内置浏览器

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/seven-day-inc/morpheus-shell --skill orca-cli

安装后在 Claude Code 中输入/orca-cli确认已加载。

详细介绍

Orca CLI

此文件是发现用的存根，并非使用指南。完整且与版本匹配的 Orca CLI 参考文档由 orca 二进制程序本身提供——特意不放在此文件中，以确保它不会与实际运行并处理命令的二进制程序出现偏差。

当 Orca 正在运行的编辑器／运行时是事实来源时，请使用 Orca：包括 Orca 管理的工作树、文件夹上下文、终端、仓库、自动化、工作树评论，以及嵌入 Orca 应用中的浏览器。触发场景包括“$orca-cli”、“Orca 工作树”、“子工作树”、“在工作树中启动 codex/claude”、“读取／等待／发送 Orca 终端内容”、“完整移交”／“交接”／“交给另一个 Agent”，以及“控制 Orca 内的浏览器”。Orca 状态无关紧要时，请使用普通的 shell 工具。

为本次会话确定 CLI

选择一次可执行程序，并在之后的每条命令中重复使用：

  • 如果已设置 ORCA_CLI_COMMAND 环境变量，请使用其值。Orca 会为受管理的 WSL 会话导出此变量。
  • 否则，如果会话提供了 ORCA_DEV_REPO_ROOT，且当前位于开发检出目录中，请使用 orca-dev。
  • 否则，在 Orca 管理的终端之外的 Linux 系统上，请使用 orca-ide。切勿在那里直接运行 orca——在 Orca 终端之外，它通常会解析为 GNOME Orca 屏幕阅读器（/usr/bin/orca），并在用户的机器上启动语音播报。
  • 否则，请使用 orca。

下文中，ORCA 是你确定的可执行程序的占位符。运行任何命令之前，请将其替换为实际程序；不要创建 shell 变量，也不要直接运行 ORCA。这在 POSIX shell、PowerShell 和 cmd.exe 中的用法相同。

如果所选可执行程序无法运行，请报告其确切错误并停止。不要改用其他可执行程序，否则可能会悄悄指向另一个 Orca 版本。

运行 Orca 命令前先加载完整指南

ORCA skills get orca-cli

这会打印完整且与版本匹配的指南，适用于将处理你后续命令的确切二进制程序，内容涵盖工作树、移交、终端、自动化和内置浏览器。请先阅读，再运行所需的具体命令。

不要凭记忆或缓存的存根副本猜测子命令或标志。它们会随 Orca 版本变化，此文件也已特意不再列出这些内容。使用 ORCA status --json 确认应用已启动（如有需要，使用 ORCA open --json 启动），并在由 Agent 驱动的调用中优先使用 --json。

如果较旧的 Orca 不识别 skills get

只有当所选二进制程序明确报告 skills get 是未知命令时，才使用此回退方案。其他错误并不能证明二进制程序较旧；请报告错误，不要猜测或更换可执行程序。对于已确认的不支持指南的旧版二进制程序，只使用以下有限的只读引导命令来了解情况。不要陷入死路，也不要编造命令：

ORCA status --json
ORCA worktree ps --json
ORCA terminal list --json

然后告知用户，更新 Orca 后即可通过 ORCA skills get orca-cli 获取完整且与版本匹配的指南。除这些命令之外，请先询问用户，不要猜测此旧版二进制程序可能不支持的命令用法。

评论

支持 Markdown