CLI 參考

下面每一條指令，建置時都會拿正式產物核對一遍。指令改了名而這一頁沒改，建置就會失敗。

icloser 就是執行體。它建立工作區、持有權限、驅動 Runtime，並回報發生了什麼。

同一個程式也可以敲 icli。Windows 上如果 PATH 裡已經有別的東西叫 icloser，安裝器會當場說出來、並點名你敲下去會拿到誰 —— 那台機器上就用 icli。

接上線

指令	做什麼
`icloser pair`	建立一個工作區、詢問一次權限、印出一個 QR Code。在你的專案目錄下執行一次就好。
`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`	來領過工作的機器。

`icloser runtimes`	這裡裝了哪幾家編碼 Agent、各自約束得住什麼。它只執行各自的 `--version` —— 不會消耗你任何模型額度。
`icloser runtimes --json`	同上，機器可讀。
`icloser runtime list`	這個工作區裡有哪些 Runtime。
`icloser run --runtime-kind claude`	直接指定介面卡種類，不依可執行檔名去辨識。
`icloser env probe`	偵測這台機器上的開發工具鏈。
`icloser env bootstrap`	把已註冊員工欠缺的那幾樣裝起來。

`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。

參數	環境變數	是什麼
`--api`	`KERNELHUB_API`	閘道位址。
`--ws`	`KERNELHUB_WS`	工作區 uuid。
`--token`	`KERNELHUB_TOKEN`	工作區存取權杖 —— 建立工作區時只交出一次。
`--device`	`KERNELHUB_DEVICE`	本裝置 id，預設取主機名稱。
`--path`	`KERNELHUB_PATH`	本機工作目錄。
`--runtime`	`KERNELHUB_RUNTIME`	要驅動哪一個 Runtime 指令。留空則由 Resolver 挑最合適的可用項目。

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

下一篇：版本與診斷 —— 該執行什麼，以及該把什麼寄給我們。