命令参考

用 shell 命令启动或管理 Harness UI；在 TUI 中使用斜杠命令。需要工作流说明而非语法速查时，从设置或TUI 使用开始。

Shell 调用复制章节链接

a13n-harness-ui [GLOBAL OPTIONS] [COMMAND] [COMMAND OPTIONS]

省略 COMMAND 会打开 TUI。全局选项放在命令前；每层都可用 -h 或 --help。--version 打印版本后退出，不运行任何命令。帮助和版本不初始化 App、数据库、Model 或 Environment。

这些表展示命令行默认值；配置说明实际默认值。对话即根 Thread；--resume 接受其 Thread ID，不能与新对话的 Agent、Environment 或标题覆盖同用。

全局选项复制章节链接

命令复制章节链接

全局选项放在这些子命令前。身份验证和插件命令修改本地存储；config 检查也会打开应用状态。

webui复制章节链接

运行一个前台 WebUI 服务器，使用内置浏览器资源。

update复制章节链接

立即更新当前 uv tool 安装，不启动 TUI 或设置。

没有命令专用参数。

setup复制章节链接

交互式配置 Model、上下文预算和执行权限。

add agent复制章节链接

创建其他 Agent，不改变已有 Agent 或默认值。

add model复制章节链接

创建可复用 Model，不创建或修改 Agent。

run复制章节链接

执行一次提示，不打开 TUI。

config path复制章节链接

显示选中的配置和数据路径。

config validate复制章节链接

验证选中的源配置树。

config show复制章节链接

显示已接受配置。

config subagents复制章节链接

列出包提供的 subagent 和当前选择。

import subagents复制章节链接

预览或应用外部 subagent 导入。

plugin install复制章节链接

从 Git 仓库安装一个 Content Plugin。

plugin list复制章节链接

列出已安装 Content Plugin 及其目录。

plugin uninstall复制章节链接

永久删除已安装 Content Plugin 目录，包括本地修改，不再确认。先备份编辑内容；重新安装不会恢复。

environment list复制章节链接

列出 Environment 模式和配置。

doctor复制章节链接

检查 App 和扩展健康状态。

auth status复制章节链接

显示 Model 身份验证状态。

auth key list复制章节链接

列出已保存密钥引用，不返回密钥字节。

auth key set复制章节链接

通过不回显提示添加或替换密钥，绝不通过命令行传入密钥。

auth key delete复制章节链接

确认后删除已保存密钥。后续使用该密钥解析 Model 可能失败。

auth sources复制章节链接

列出受支持的已存账户来源，不公开凭据。目前只有 Copilot 支持来源选择。

auth select复制章节链接

显式替换此数据根中存储的账户和凭据来源绑定。使用 auth sources copilot 列出的登录；来源路径由 Host 解析，不在命令行提供。

auth logout复制章节链接

移除选中的本地 Model 凭据。来源是共享 Copilot CLI 文件时，也会删除该文件中选中账户受支持的 token 字段，影响 Copilot CLI。其他账户保留；Host 不回退到其他来源。

login复制章节链接

为兼容的 Model 提供方完成身份验证。Copilot 只支持设备授权，默认公共 Copilot App 身份；订阅用户无需注册 OAuth App。权限和兼容性限制见模型与身份验证。

斜杠命令复制章节链接

在 TUI 输入框而非 shell 中输入。Tab 补全支持语法；/help 和 /? 显示原生帮助。没有 /setup、/login、/approve、/deny 或 /result 命令。决策使用对应类型的选择器。

“忙碌时可用”表示解析器允许在执行期间使用，不允许绕过待处理交互或操作不可用资源。/steer 要求根操作当前可接受引导。附件命令修改草稿。Agent 工作期间按 Enter，会把草稿文本和附件一同作为引导发送。见TUI 使用。

/thinking 打开所选 Model 支持的选项；命令补全使用相同列表。default 继承 Model 配置。按模型和适配器，显式选择可能包括 off、minimal、low、medium、high、xhigh 或 max。不支持的选项会被拒绝；未知模型仅提供 default 并解释原因。/environment 在支持时选择 full-control 或 sandbox。原生 /steer 保留整个尾随消息，不拆成 shell 词语。

重要操作与限制复制章节链接

• auth key delete REFERENCE --yes 显式跳过删除确认，不使删除变得可逆。
• plugin uninstall ID 立即删除安装文件和修改，不只是关闭来源。
• update 请求安装，不再次确认。启动更新检查仍需在安装前确认。
• import subagents 未提供 --apply 时只预览；导入文件不会自动加入每个 Agent。
• 单次 run 不打开交互审批选择器；挂起/失败操作以非零状态退出。需要决策时以交互方式恢复。
• webui --dangerous-skip-permissions 只改变 HTTP 身份验证，不改变 Agent 执行权限。暴露监听器前阅读 WebUI。

按任务查阅指南复制章节链接

• 设置连接与管理账户。
• 配置资源、MCP 服务器和 Skill/Content Plugin。
• 使用 TUI介绍忙碌输入、历史、选择器和键盘快捷键。
• 自动化与诊断介绍退出/恢复、日志和中断的工作。