Luwu 陸吾

代理與通知

luwu hooks install

這個指令會在 Claude Code（~/.claude/settings.json）和 Codex（~/.codex/config.toml）中加入 hook。hook 會把代理目前的狀態回報給同一台電腦上的 Luwu 服務，服務接著會：

  • 在視窗旁顯示狀態：luwu ls、儀表板和 app 中都看得到，例如「claude · needs you」；
  • 當代理需要你（要求權限或提出問題）、完成或發生錯誤時，傳送通知到你的 iPhone。要求權限的通知會寫明工具和它要執行的指令，在鎖定畫面上就能判斷。

點一下通知，就會直接開啟那個視窗。

在終端機上回答

當代理的問題帶著選項出現在終端機畫面上，例如 Claude Code 的權限提示、有選項的問題或待核准的計畫，或是 Codex 的核准請求，app 會把它顯示成一個對話框：問題、一行說明，以及每個選項一個按鈕。點按鈕就等於在鍵盤上輸入對應的答案。點對話框外面可以改在終端機上回答；這個問題還在畫面上時，對話框不會再出現。需要 app 1.0.12。

代理模式

代理模式由電腦替你執行 Claude Code 或 Codex，並在 App 裡即時顯示每一步：

  • Claude 說了什麼；
  • 執行的每個指令和它的輸出；
  • 修改的每個檔案，以 diff 顯示；
  • 需要你核准的操作。

你看到的不是終端機，而是一段好讀的對話，每次需要核准時都有允許這一次和拒絕按鈕。它的提問和計畫會以表單開啟。

  • 開始：在 App 裡打開一台電腦，點新增代理工作階段，選好資料夾，告訴 Claude 要做什麼。也可以在另一台電腦上執行：luwu agent --on <電腦> new --cwd ~/code/app "修正失敗的測試"。
  • **核准：**你允許之前什麼都不會執行。每次核准只能回答一次，可以在 App 裡、通知上，或者在電腦上那個工作階段的視窗裡輸入 y 或 n。
  • **會持續執行：**工作階段在 agents 這個 tmux 工作階段的一個視窗裡執行，關掉 App 也不受影響。之後在 App 裡打開，對話會接著上次的地方繼續。luwu agent ls 可以列出所有工作階段。

代理模式需要電腦上的 Luwu 是 0.2.4 或更新的版本（Codex 需要 0.2.6），使用你在那台電腦上的 Claude Code 或 Codex 登入和設定。

不會收到通知的情況

如果你在過去 30 秒內從手機在那個視窗輸入過內容，表示你已經在看它了，因此不會傳送通知。

需求

  • 代理必須在 tmux 中執行，Luwu 才知道它在哪個視窗。
  • 在執行 luwu hooks install 之前就已啟動的代理，需要重新啟動。
  • 在手機上，app 詢問時請允許通知。

luwu hooks 會顯示已安裝的內容；luwu hooks uninstall 會移除 hook。