CLI 安裝
本指南說明如何安裝 KamuiDash CLI（kamui 指令）。
系統需求
- macOS（Intel / Apple Silicon）
- Linux（x86_64 / ARM64）
- Windows（x86_64）
安裝方式
Homebrew（macOS / Linux 建議使用）
brew install kamui-project/tap/kamui
更新方式：
brew upgrade kamui
下載二進位檔
可從 GitHub Releases 直接下載。
macOS
# Apple Silicon (M1/M2/M3)
curl -L https://github.com/kamui-project/cli/releases/latest/download/kamui_darwin_arm64.tar.gz | tar xz
sudo mv kamui /usr/local/bin/
# Intel
curl -L https://github.com/kamui-project/cli/releases/latest/download/kamui_darwin_amd64.tar.gz | tar xz
sudo mv kamui /usr/local/bin/
Linux
# x86_64
curl -L https://github.com/kamui-project/cli/releases/latest/download/kamui_linux_amd64.tar.gz | tar xz
sudo mv kamui /usr/local/bin/
# ARM64
curl -L https://github.com/kamui-project/cli/releases/latest/download/kamui_linux_arm64.tar.gz | tar xz
sudo mv kamui /usr/local/bin/
Windows
- 從 GitHub Releases 下載
kamui_windows_amd64.zip - 解壓縮 ZIP 檔
- 將
kamui.exe放到 PATH 中的任一目錄
使用 Go 安裝
若你已安裝 Go：
go install github.com/kamui-project/cli/cmd/kamui@latest
確認安裝結果
kamui --version
若顯示出版本號，代表安裝成功。
初始設定
登入
kamui login
- 瀏覽器視窗會自動開啟
- 使用你的 GitHub 帳號進行驗證
- 驗證成功後，終端機會顯示「Successfully logged in」
憑證會儲存在
~/.kamui/config.json。
確認登入狀態
kamui projects list
若顯示出你的專案清單，代表已成功登入。
登出
kamui logout
這會清除已儲存的憑證。
解除安裝
Homebrew
brew uninstall kamui
二進位檔
sudo rm /usr/local/bin/kamui
rm -rf ~/.kamui
疑難排解
瀏覽器沒有自動開啟
請手動複製終端機顯示的網址，貼到瀏覽器中開啟。
出現「command not found」錯誤
請確認 PATH 設定是否正確。
# 確認執行檔位置
which kamui
# 確認 PATH
echo $PATH
驗證錯誤
你的權杖可能已過期，請重新登入。
kamui logout
kamui login