ZimaOS CLI

$ zima_

ZimaOS 的命令行客户端。注册多台设备，在终端里完成管理与观测 ——当前覆盖设备管理全套能力，服务模块随 ZimaOS 持续扩展。

一键安装 · Linux / macOS需要 curl 与 tar

$ curl -fsSL https://cli.zimaos.com/install.sh | sh

脚本会探测系统与架构、校验 sha256，按 /usr/local/bin → /DATA/local/bin（ZimaOS）→ ~/.local/bin 选择安装目录。安装前可先阅读脚本内容。

zima — cli.zimaos.com

icewhale@zimaos ~ $ zima device status fan-8086:1001-i2c0-69
ID:      fan-8086:1001-i2c0-69
Kind:    fan
Name:    backplane fan subsystem
State:   online
Telemetry:
fan1_rpm:  2312 ↓
fan2_rpm:  2327
percent:   56
target:    54 ↓
Fan settings (fan.settings.v1):
Mode:         policy  (curve/governor control loop, the smart default)
Min percent:  40%  (hard floor on the target regardless of curves)
Curve hdd:    40C→35% 45C→45% 50C→60% 55C→80% 60C→100%

features_

当前能力：主机管理与设备管理

auth 负责注册与切换多台 ZimaOS 主机；device 围绕统一设备模型提供观测与控制。全部经由 ZimaOS 网关，本机免配置直接可用—— 更多服务模块将以同样的方式加入。

device ls / get / status: 统一设备拓扑：背板、风扇、温区、硬盘槽、硬盘乃至三方设备，按 kind / 状态 / 能力过滤，status 一屏融合身份、遥测与设置。
device telemetry --history --watch: 实时与历史遥测：24 小时内存环 + 30 天 JSONL 归档，--watch 以 tail -f 的方式持续追加新数据点，趋势箭头标注涨跌。
device settings describe / edit / patch: 声明式设置：resource_version 乐观并发防覆盖；describe 从服务端 schema 实时渲染字段、约束与说明，三方设备同样适用。
device events --severity alert: 事件归档查询：风扇停转、磁盘故障、provider 上下线等事件按 severity 分类落盘，事后可按时间窗与级别追溯。
device cmd / op: 异步命令管线：硬盘槽上下电、三方自定义命令，统一 operation 生命周期，支持 --wait、取消与幂等键。
--profile a,b,c · -o json|yaml: 多设备并发：一条命令同时操作多台已注册主机；table / json / yaml 三种输出，脚本消费与人眼阅读两不误。

manual_

常用命令速查

完整行为以 zima <命令> --help 为准。

主机管理 · zima auth

auth login <address>	注册远程 ZimaOS 设备；不带凭据参数时交互式询问用户名，回车跳过即免凭据注册
auth list / status --all	已注册主机清单；并发核查连通性与 token 有效性
auth switch <alias>	切换默认主机，此后所有命令默认指向它（local 免登录）

设备管理 · zima device

device ls [--kind] [--state] [--capability]	设备清单与过滤
device status [device_id]	身份 + 遥测 + 设置融合视图；省略 id 时逐台汇总
device telemetry <id> --history --watch	历史遥测与实时追踪（--interval 控制轮询）
device settings get / patch --set k=v	读取与合并更新期望状态（自动携带 resource_version）
device settings describe <id>	渲染设置 schema 的字段、类型、约束与说明
device cmd <id> <command> [--wait]	提交命令（power-on/off、三方自定义 + --set 载荷）
device events [--severity] [--from/--to]	查询已归档事件
device schema <id>	遥测指标目录：名称、类型、单位

CLI 自身 · zima update / skill

update [--check] [--version vX.Y.Z]	自更新：下载校验后原子替换二进制
skill install / update / status	为 Claude Code / Codex 安装与更新 zima 技能包

skill_

给 AI Agent 的技能包

按 Agent Skills 开放标准（SKILL.md）打包的 zima 使用说明，让 Claude Code、Codex 等编码 Agent 学会正确地用 zima 管理 ZimaOS 设备——包括 JSON 输出解析、乐观并发的设置修改、危险命令的确认约定。

安装 CLI 后一条命令装入（Claude Code / Codex 自动探测）skill install / update / status

$ zima skill install

技能随每次发布同步版本：`zima skill status` 查看已装与最新版本，`zima skill update` 升级；`--agent claude|codex` 或 `--dir` 可指定目标目录。包内容可直接查看：skill.tar.gz。装入后，用自然语言即可驱动 Agent 完成设备操作：

claude — 自然语言驱动示例

icewhale@zimaos ~ $ claude
> 把 ZimaCube 的风扇最低转速调到 45%，保持智能温控

⏺ 加载 zima skill，先定位风扇设备
⏺ Bash(zima device ls --kind fan -o json)
  └ fan-8086:1001-i2c0-69 · backplane fan subsystem · online
⏺ Bash(zima device settings patch fan-8086:1001-i2c0-69 \
        --set min_percent=45 --set mode=policy)
  └ resource_version 自动携带 · 200 OK
⏺ Bash(zima device telemetry fan-8086:1001-i2c0-69 -o json)
  └ percent: 56 · target: 54（曲线 + 新下限共同决定）

已完成：最低转速下限调至 45%，模式保持 policy（曲线智能温控），
当前转速 56% 由温度曲线决定、不会低于新下限。

download_

手动下载

四平台归档；校验和见 checksums.txt。

linux/amd64linux-amd64-zima-v0.2.3.tar.gz静态 musl，upx 压缩

linux/arm64linux-arm64-zima-v0.2.3.tar.gz静态 musl，upx 压缩

darwin/amd64darwin-amd64-zima-v0.2.3.tar.gz已签名并公证

darwin/arm64darwin-arm64-zima-v0.2.3.tar.gz已签名并公证

当前版本 v0.2.3 · 安装指定版本：ZIMA_VERSION=v0.2.3 sh -c "$(curl -fsSL https://cli.zimaos.com/install.sh)"