@zhizhi-ai/cli

Zhizhi 命令行客户端。

用法

不全局安装，直接通过 npx 运行：

npx @zhizhi-ai/cli@latest --help

也可以全局安装后使用 zhizhi 命令：

npm install -g @zhizhi-ai/cli
zhizhi --help

远端机器接入

在远端机器上使用 Web 端生成的 pairing token 注册 runtime connector：

npx @zhizhi-ai/cli@latest connect \
  --server https://your-zhizhi-server.example.com \
  --workspace-id <workspace-id> \
  --pairing-token <pairing-token> \
  --name "Remote Computer"

注册成功后，启动 connector：

npx @zhizhi-ai/cli@latest serve

后台启动 connector，并把日志写入本机 Zhizhi root 下的 daemon 日志文件：

npx @zhizhi-ai/cli@latest serve --background

只执行一轮 heartbeat/claim，用于轻量诊断：

npx @zhizhi-ai/cli@latest serve --once

常用命令

# 查看本地 connector profile 和 server live status
npx @zhizhi-ai/cli@latest status

# 查看本地 daemon 状态
npx @zhizhi-ai/cli@latest daemon status

# 查看本地 daemon 日志尾部，默认 80 行
npx @zhizhi-ai/cli@latest daemon logs --tail 120

# 停止后台 daemon
npx @zhizhi-ai/cli@latest daemon stop

# revoke connection key 并删除本地 profile
npx @zhizhi-ai/cli@latest disconnect

# 轮换 connection key
npx @zhizhi-ai/cli@latest rotate-key

# 输出 CLI 版本
npx @zhizhi-ai/cli@latest version

# 本地轻量诊断
npx @zhizhi-ai/cli@latest doctor

本地配置位置

所有命令都支持全局参数 --root <PATH> 覆盖本机 Zhizhi root；它的优先级高于 ZHIZHI_ROOT 环境变量。

npx @zhizhi-ai/cli@latest --root /opt/zhizhi-client status