Luwu 陸吾

luwu 指令

指令 用途
luwu 你的電腦與終端機的儀表板。第一次執行時會登入並設定這台電腦。
luwu login / logout 在這台電腦上登入或登出。 luwu login --browser 在 app.luwu.dev 上核准這台電腦即可登入(Luwu Bar 就用這種方式)。
luwu up / down 啟動或停止讓這台電腦可被連線的背景服務。
luwu status 你的帳號、這台電腦和服務的狀態。
luwu ls [--json] 你的電腦、各自的 tmux 工作階段和代理狀態,例如「claude · needs you」。
luwu attach [computer] [session[:window]] 開啟另一台電腦上的終端機。按 Ctrl-] 離開。
luwu fs ls|get|put|find|mkdir|mv|rm 電腦上的檔案。
luwu share <computer> <session>[:<window>] 與朋友分享視窗。另有 luwu share ls、luwu share end <id>。
luwu join <code|link> 加入別人分享給你的視窗。
luwu agent [--on <電腦>] ls|new|watch 代理模式:在一台電腦上啟動 Claude 並跟進,核准它的每一步。
luwu hooks [install|uninstall] Claude Code 和 Codex 的代理通知。
luwu update [--check] [--auto on|off] 安裝最新版本。--on <電腦> 可以更新你的另一台電腦。
luwu token [ls|new 名稱|revoke ID] 給腳本和 CI 用的存取權杖。設定好 LUWU_TOKEN 後,luwu notify --title "建置通過" [--body …] [--url https://…] 可以在任何地方傳通知到你的手機,不需要配對電腦。
luwu shell-integration [install|uninstall] 讓 Luwu 知道每個指令和它的輸出在哪裡(zsh、bash、fish;只在 tmux 裡生效)。這樣 App 能把上一個指令的輸出原樣存到筆記,並標出上一個指令失敗的視窗。
luwu unpair 從你的帳號移除這台電腦。
luwu version 已安裝的版本。

Luwu Bar(macOS)

這台 Mac 上 Luwu 服務的選單列 App:顯示這台 Mac 能否從你的裝置存取(經過哪些中繼)、哪些代理在等你,還可以暫停、恢復和更新 Luwu。下載 Luwu Bar(macOS 13 或更新的版本),解壓縮後移到「應用程式」。它使用你已經安裝的 luwu,不會取代它。

檔案存放位置

Luwu 保存的所有資料都在 ~/.luwu(設定 LUWU_HOME 可以改到別的位置):這台電腦的金鑰、服務的狀態和記錄檔(~/.luwu/logs/luwud.log)、上傳收件匣,以及 files.json。

服務在 macOS 上以 launchd agent(dev.luwu.luwud)執行,在 Linux 上以 systemd 使用者服務執行。luwu up 會安裝服務;luwu down 會停止服務。

更新

從 Luwu 0.2.3 起,執行 luwu update 就可以。它會下載最新版本、檢查 checksum,然後讓服務改用新版本重新啟動。tmux 工作階段會繼續執行,手機幾秒後會重新連線。如果新版本沒有正常啟動,會自動退回原本的版本。

有新版本時,服務也會在沒有人使用終端機的時候自動更新。要關閉自動更新:luwu update --auto off。在 App 裡,執行舊版本的電腦會顯示更新按鈕。

更早的版本:重新執行安裝程式(curl -fsSL https://luwu.dev/install.sh | sh),然後執行 luwu down && luwu up。