KernelHub v1.0.2

CLI 参考

下面每一条命令，构建时都会拿正式产物核一遍。命令改了名而这一页没改，构建会失败。

icloser 就是 执行体。它建工作区、持有权限、驱动 Runtime、报告发生了什么。

同一个程序也可以敲 icli。Windows 上如果 PATH 里已经有别的东西叫 icloser，安装器会当场说出来、并点名你敲下去会拿到谁 —— 那台机器上就用 icli。

接上

命令做什么
icloser pair建一个工作区、问一次权限、出一个二维码。在你的项目目录下跑一次就行。
icloser qr把当前工作区的码再画一遍，不新建任何东西。码被滚屏冲掉了、或者要让第二台设备接进来时用它 —— 别用 pair，那会新建一个空工作区。
icloser run轮询并执行任务。保持它开着。
icloser console这台机器什么状态、管理台在哪、下一步做什么。不需要工作区。
icloser open在浏览器里打开本机管理台；非交互 shell 里改成打印地址。

权限

icloser perms这台设备当前被允许做什么。
icloser grant read在本机追加一档权限。授权只加不减；六档是 read、write、exec、web、push、danger，而且一次授权不会带到另一台设备上。
icloser grant write
icloser grant exec
icloser approval list有什么在等你。

工作区与设备

icloser workspaces这台机器上所有的工作区，箭头指着当前那个。
icloser workspace list同一份视图，走 workspace 子命令。
icloser status工作区身份，以及从它恢复出来的 Agent 视图。
icloser agents谁在跑、各自绑在哪个工作区上。切了工作区却好像没反应时先敲它。
icloser device list来找过活的机器。

Runtime 与环境

icloser runtimes这儿装了哪几家编码 Agent、各自能约束住什么。它只跑各自的 --version —— 不消耗你任何模型额度。
icloser runtimes --json同上，机器可读。
icloser runtime list这个工作区里有哪些 Runtime。
icloser run --runtime-kind claude直接钉死适配器种类，不按可执行文件名去认。
icloser env probe探测这台机器上的开发工具链。
icloser env bootstrap把已注册员工缺的那几样装上。

任务与 AI 员工

icloser task list这个工作区里的任务。
icloser task result一条任务产出了什么。
icloser task diff一条任务改了什么。
icloser employee list已注册的岗位。
icloser skill list全局技能目录。

让它一直跑着

icloser daemon install让 执行体 常驻 —— 登录自起；macOS 与 Linux 上挂了还会自动拉起。Windows 上它是一条计划任务，不需要密码 —— 优先用它，别用 service install：那条要把 Windows 密码写在命令行上。
icloser daemon status它常驻没有，以及它认为自己在干什么。
icloser service status平台服务那一层的视图（Windows 服务 / launchd / systemd）。
icloser logs -n 50常驻 Agent 最近 50 行。

诊断

icloser version装的是哪一版。报障时先说这个。它不带任何参数。
icloser doctor「这台机器现在能不能用」的一次性回答。

配置

命令行 > 环境变量 > ~/.kernelhub/config.json。

参数环境变量是什么
--apiKERNELHUB_API网关地址。
--wsKERNELHUB_WS工作区 uuid。
--tokenKERNELHUB_TOKEN工作区访问令牌 —— 建工作区时只交出一次。
--deviceKERNELHUB_DEVICE本设备 id，默认取主机名。
--pathKERNELHUB_PATH本机工作目录。
--runtimeKERNELHUB_RUNTIME驱动哪个 Runtime 命令。留空则由 Resolver 挑最佳可用的。

Runtime 用的是你自己的登录态。KernelHub 不持有、也不需要任何模型 API key。

下一篇：版本与诊断 —— 该跑什么，以及该把什么发给我们。