用途:当 h0x-ADE 的运行编辑器/运行时是事实来源时,使用 h0x CLI 操作其管理的 worktree、文件夹上下文、终端、仓库、自动化、worktree 评论以及应用内嵌浏览器。触发场景包括 worktree 与子 worktree 操作、在 worktree 中启动 codex/claude、读取/等待/发送终端内容、完整交接给其他智能体,以及控制 h0x-ADE 内浏览器。若 h0x-ADE 状态无关,应使用普通 shell 工具。
主要能力:管理 worktree、文件夹上下文、终端、仓库、自动化、产物、技能共享与 worktree 评论;控制内置浏览器;支持 --json 输出,便于智能体调用。
使用方式:先确定本次会话的可执行文件并全程复用。若设置了 ORCA_CLI_COMMAND 环境变量,使用其值(h0x-ADE 为受管 WSL 会话导出)。否则在暴露 ORCA_DEV_REPO_ROOT 的开发检出中使用 h0x-dev。否则在 Linux 且非 h0x-ADE 受管终端中使用 h0x,切勿在此处运行裸 orca,因为它通常解析为 GNOME Orca 屏幕阅读器(/usr/bin/orca)并启动语音。否则使用 orca。文中 ORCA 是占位符,运行前需替换,不要创建 shell 变量或直接运行 ORCA。若所选可执行文件无法运行,报告其确切错误并停止,不要回退到其他可执行文件。运行 h0x 命令前先加载完整指南: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,并告知用户更新 h0x-ADE 可恢复完整指南;除此之外应询问用户而非猜测。
限制:本文件仅为发现存根,非使用指南;完整参考由 h0x 二进制提供,以避免与版本漂移。子命令与标志随版本变化,本文件不再列出。