分開 check 與 install
用 grok update --check 或 --check --json 查 availability，不修改 installation。Command 可選 --stable、--alpha 或 specific --version；切 channel 是刻意 policy。
安裝前記錄 version 並讀 release notes；只有修復已知問題才 --force-reinstall。
grok update --check --json
grok --versionFix 前先 diagnose
grok doctor 檢查 terminal、clipboard、color、input、notification、sandbox；--json 供 machine 讀。grok inspect 則檢查 discovered config/extensions，是不同 evidence surface。
先 review doctor fix；--yes 移除確認，只能用於已稽核 proposed modifications 的程序。
- 分享前 review debug-file。
- 先修第一個 failing layer。
- Repair 後重跑 doctor。
刻意產生 completion code
grok completions 需要 shell 並輸出 script。先寫 temp file、inspect，再依 shell convention 安裝，不直接 append unknown text。
Captured ledger 中 TUI /doctor 是 source-preview；grok doctor shell command 是 runtime-confirmed，教學必須保留 availability label。
grok completions zsh > /tmp/_grok
sed -n "1,40p" /tmp/_grok