CLI 参考

所有 cryochamber 二进制及其命令。cryo.toml 和 cryohub.toml 的字段见配置。

每个二进制都接受 --version（打印版本并退出）和 --help。

操作员 CLI（`cryo`）

除非另有说明，请在 chamber 目录内运行这些命令。

类别	命令	作用
生命周期	`cryo init [--agent <cmd>]`	初始化目录：写入 `cryo.toml`、`plan.md`、`NOTES.md` 和 `README.md`。已有文件会被保留。未给出 `--agent` 时使用 `cryohub.toml` 中的主机级 `default_agent`（内置默认：`pi`）。
	`cryo start [--agent <cmd>]`	启动守护进程。读取 `cryo.toml` 并把覆盖项写入 `timer.json`。
	`cryo start --max-session-duration 3600`	为本次运行覆盖会话超时时间。
	`cryo status`	显示守护进程是否在运行、当前会话编号以及下一次唤醒时间。
	`cryo restart`	重启正在运行的守护进程。若它已安装为操作系统服务，则重启现有服务而不重写或移除它。
	`cryo cancel`	停止守护进程并移除运行时状态。
日志	`cryo watch [--all] [--viewpoint cryo\|agent]`	实时跟踪日志。`--all` 从头显示日志。`--viewpoint cryo`（默认）跟踪结构化事件日志；`--viewpoint agent` 跟踪智能体原始输出（`cryo-agent.log`）。
日志	`cryo log`	打印完整会话日志。
消息	`cryo send "<message>" [--from <name>] [--subject <text>]`	向智能体的收件箱发送消息；守护进程的收件箱监视器会唤醒智能体。`--from` 设置发送者（默认 `human`），`--subject` 设置主题（默认根据正文生成）。
消息	`cryo receive`	读取智能体发送到发件箱（outbox）的消息。
维护	`cryo clean [--force]`	移除日志、状态、消息等运行时文件。
维护	`cryo ps [--kill-all]`	列出（或终止）本机上所有正在运行的 cryo 守护进程。可从任意目录运行。

Hub（`cryohub`）

命令	作用
`cryohub start [--host <ip>] [--port <n>] [--default-agent <cmd>]`	安装一个重启后依然存活的服务。默认强制 bearer 鉴权，并在首次运行时打印 owner token（之后可用 `cryohub token owner` 再次打印）。提供的主机、端口和默认智能体会更新已保存的主机配置。
`cryohub start --foreground`	在当前终端运行 hub，而不是安装服务。
`cryohub stop`	卸载全局 hub 服务。
`cryohub restart`	重启已安装的全局 hub 服务，无需重新安装。
`cryohub status`	显示全局 hub 的 URL、模式（`public (bearer auth)` 或 `open (loopback)`）、chamber 根目录、配置文件路径、日志路径、控制台来源（`embedded`，或 `console_dir` 覆盖路径及构建是否存在）和服务状态。同时列出旧版本遗留的、以当前目录为作用域的 hub 服务。
`cryohub start --public`	对所有 `/api` 路由强制启用 bearer token 鉴权——这是默认行为。若尚无 owner token 则创建并打印。该值写入 `cryohub.toml`，因此之后的普通 `cryohub start`、重启或重新开机都保持鉴权。
`cryohub start --no-public`	以无鉴权的开放模式运行（仅限回环地址）。开放模式下分享与邀请无法工作。必须显式指定：关闭鉴权绝不隐式发生，之后的普通 `cryohub start` 也会保持已保存的开放模式。
`cryohub token owner`	打印 owner token，首次运行时创建。幂等——重复运行打印同一个密钥。
`cryohub token create --name <名称> --chambers <id,...>`	创建一个限定到这些 chamber id 的具名邀请。打印 token 及其 `#invite=` 链接片段；这是密钥唯一一次显示的时机。
`cryohub token list`	列出邀请及其作用域、创建时间和吊销状态。绝不打印 token 字符串。
`cryohub token revoke <名称>`	按名称吊销邀请。立即生效，包括已经打开的 SSE 流。若没有同名的有效邀请则失败。

智能体 IPC（`cryo-agent`）

这些命令由被派生的 AI 智能体用来通过 Unix socket 与守护进程通信。它们不是操作员接口。

类别	命令	作用
休眠	`cryo-agent hibernate --summary "..."`	结束会话；还有更多工作要做。只要收件箱存在未读邮件，就会被拒绝（非零退出）——智能体必须先 `receive`、回复，再重试，因此会话绝不会在还有邮件等着它时结束。若没有任何待办 TODO 声明下次唤醒，同样会被拒绝。调用成功后最多可能阻塞智能体通过 `--linger <秒数>` 请求的回复窗口时长（省略 = 300，上限 86400；`0` 表示立即入睡）。
	`cryo-agent hibernate --complete`	结束会话；计划已完成。此外，只要有 TODO 到期就会被拒绝。它永远不会被回复窗口驻留。
	`cryo-agent hibernate --exit 1`	报告失败的会话。守护进程会把已消费的 TODO 标记为完成，并新增一个带编号的重试 TODO。失败报告永远不会被拒绝，也不会被驻留。
	TODO	`cryo-agent todo add "text" --at <TIME>`	通过 TODO 安排下一次唤醒。`--at` 接受相对偏移（`+30 minutes`）、ISO 8601 时间戳（`2026-04-25T10:00`；容忍秒和空格分隔符），或仅日期（`2026-04-25`，表示午夜）。
`cryo-agent todo list`		列出所有 TODO 项。
`cryo-agent todo done <id>`		将某个 TODO 项标记为完成。
`cryo-agent todo remove <id>`		移除某个 TODO 项。
消息	`cryo-agent send "message"`	向发件箱写入一条给人类的消息。领取话题后，守护进程会自动把消息发回同一话题。
	`cryo-agent send --stdin`	从 stdin 原样读取发件箱消息正文，包括末尾换行；适用于多行或对 shell 敏感的文字。
	`cryo-agent send --question "msg"`	将该消息标记为等待人类回复的问题。
	`cryo-agent receive`	领取一段待处理的人类对话：第一条待处理话题，或主消息流中未加入话题的消息。领取话题时会同时得到根消息和回复历史。Hub 附件链接会转换为本地 `messages/attachments/...` 路径。回复后才能领取另一段对话。
	`cryo-agent dialog [--last N \| --all \| --since <iso>]`	渲染对话记录（默认：最近 20 条消息）。`--last N` 显示最近 N 条，`--all` 显示所有已归档消息，`--since <iso>` 显示某个 ISO 8601 时刻之后的消息；三者互斥。副作用是最多领取并归档一段待处理对话。新领取话题时，即使指定了范围限制，也会包含根消息和完整历史；之后的读取只显示当前话题，并正常应用指定范围。Hub 附件链接会转换为本地 `messages/attachments/...` 路径。
时间	`cryo-agent time`	以 ISO 8601 格式打印当前本地时间。
	`cryo-agent time "+30 minutes"`	计算相对偏移。单位：`minutes`、`hours`、`days`、`weeks`。
	`cryo-agent time "2026-04-25T10:00"`	校验并规范化 ISO 8601 时间戳。

Zulip 同步（`cryo-zulip`）

命令	作用
`cryo-zulip init --config <zuliprc> --stream <name> [--topic <topic>] [--history]`	校验凭据、解析 stream，并写入 `zulip-sync.json`。
`cryo-zulip sync [--interval N]`	启动后台同步守护进程。默认间隔来自 `cryo.toml`，否则回退为 5 秒。
`cryo-zulip unsync`	停止同步守护进程。
`cryo-zulip pull`	单次拉取。
`cryo-zulip push`	单次推送。
`cryo-zulip status`	显示同步配置。