CLI 参考

Zuno 是单个可执行文件。这套 harness 暴露的每一项能力，从一次性提示到持久 session 的检视，都能通过 zuno 的某个子命令触达。不带子命令运行 zuno 会启动交互式终端应用， 因此 zuno 与 zuno tui 是等价的。

本参考是针对随发布的二进制文件生成的。每个页面都复现该命令实际接受的选项，以及二进制 文件自己报告的默认值。在 --help 中不带默认值的选项，文档中也不写默认值。

zuno --help
zuno <command> --help

有一小部分选项被每个子命令都接受。它们在全局选项中集中记录一次， 而不是在每个页面上重复说明。

一次调用就是一个进程

启动 Zuno 的客户端——通过 zuno acp 接入的编辑器、监管 zuno serve 的服务、脚本、CI 任务——在所有受支持平台上，每次调用都只得到 一个进程。它派生的那个进程就是运行该命令的进程；结束这个进程就结束该命令；命令结束时它的 stdout 与 stderr 也随之到达 EOF。

启动过程把全局选项与 ZUNO_* 变量解析成一个值，命令直接读这个值，因此任何一次调用都不依赖 把它们写回进程环境。在 Unix 上，可执行文件还会在启动时替换自身镜像一次（进程 id 不变）， 这样它之后启动的程序可以从操作系统继承这些解析后的值。Windows 没有等价的替换操作，因此那里 解析后的值只留在 Zuno 进程内部：--sandbox、--sandbox-on-unavailable、--log-level 与 --print-logs 仍然完全按文档约束本次调用，但 Zuno 启动的程序不会从自己的环境里读到它们， Windows 上嵌套的 zuno 会按配置而不是按外层命令行解析约束模式。

运行 Zuno

命令	用途
zuno run	以非交互方式把一条消息送入 harness 运行，可选 JSON 输出。
zuno tui	启动交互式终端应用。也是不带命令时的默认行为。
zuno serve	启动无头服务器供外部客户端使用。
zuno acp	在 stdin 与 stdout 上提供 Agent Client Protocol 服务，用于编辑器集成。

管理状态

命令	用途
zuno session	列出、按期清理、删除持久 session，以及检查受保护的历史恢复。
zuno agent	列出当前配置链解析出的 Agent。
zuno db	对本地 session 数据库执行查询。
zuno export	把配置、Skill、扩展与 Agent 写入一个可移植 bundle。
zuno import	把一个可移植 bundle 还原到本机的用户环境中。

Provider 与扩展

命令	用途
zuno models	列出通过已配置 Provider 可触达的模型。
zuno providers	检视 Provider 并管理其存储的凭据。
zuno mcp	注册、认证与调试 Model Context Protocol 服务器。
zuno plugin	安装、替换、移除与检视扩展包。

维护

命令	用途
zuno self-update	用一份经校验和验证的 GitHub release 替换正在运行的可执行文件。
zuno debug	检视路径、解析后的配置、提示、权限、沙箱与快照。
zuno completion	生成或安装 bash、elvish、fish、powershell 或 zsh 的 Shell 补全。

已排除

命令	用途
已排除的命令	console、web、stats、github、pr、uninstall 与 generate 之所以被注册，只是为了说明有什么替代它们。

参见

• 全局选项
• 配置参考
• Provider 参考
• 编排
• 日志
• FAQ