mcpField
O
orca-cli

orca-cli

github.com/vjk7989Agent 工作流0296 次安装7 周前更新
代码仓库

关于 orca-cli

供 h0x-ADE 管理的工作树、终端、自动化和内嵌浏览器使用的 h0x CLI 技能指南。它要求从选定的可执行文件获取匹配版本的命令文档，避免凭猜测使用命令。

主要功能

  1. 01为当前会话确定可执行文件
  2. 02获取与二进制版本匹配的 CLI 指南
  3. 03管理 h0x-ADE 工作树上下文
  4. 04检查和控制托管终端
  5. 05使用自动化与内嵌浏览器

适用场景

  1. 01在 h0x-ADE 管理的工作树中工作
  2. 02将工作交接给其他 Agent
  3. 03检查或操作托管终端
  4. 04控制 h0x-ADE 内嵌浏览器

安装

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

$npx skills add https://github.com/vjk7989/h0x-ade --skill orca-cli

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

详细介绍

h0x CLI

此文件是发现用途的存根，并非使用指南。完整且与版本匹配的 h0x CLI 参考由 h0x 二进制文件本身提供——特意不放在此文件中，这样它就不会与实际运行命令的二进制文件脱节。

当 h0x-ADE 正在运行的编辑器／运行时是事实来源时，请使用 h0x-ADE：包括 h0x-ADE 管理的工作树、文件夹上下文、终端、仓库、自动化、工作树评论，以及嵌入 h0x-ADE 应用中的浏览器。触发情形包括 "$orca-cli"、"h0x-ADE worktree"、"child worktree"、"spawn codex/claude in a worktree"、"read/wait/send h0x-ADE terminal"、"full handoff" / "handover" / "give this to another agent"，以及 "control the browser inside h0x-ADE"。如果 h0x-ADE 状态无关紧要，请使用普通 shell 工具。

为此会话确定 CLI

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

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

下文中的 ORCA 是你确定的可执行文件的占位符。运行任何命令前，请将其替换为实际值；不要创建 shell 变量，也不要直接运行 ORCA。此方法适用于 POSIX shell、PowerShell 和 cmd.exe。

如果选定的可执行文件无法运行，请报告其确切错误并停止。不要转而使用另一个可执行文件，否则可能会悄然指向另一个 h0x-ADE 构建版本。

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

ORCA skills get orca-cli

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

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

如果较旧的 Orca 不识别 skills get

仅当选定的二进制文件明确报告 skills get 是未知命令时，才使用此回退方式。其他故障并不能证明二进制文件较旧；请报告故障，而不要猜测或更换可执行文件。对于已确认的指南发布前版本，只使用以下有限的只读引导来了解情况。不要陷入死胡同，也不要编造命令：

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

然后告知用户，更新 h0x-ADE 后，就能通过 ORCA skills get orca-cli 获取完整且与版本匹配的指南。除上述命令外，请询问用户，而不要猜测此较旧二进制文件可能不支持的命令界面。

评论

支持 Markdown