跳到內容
moshpit
繁中

文件 · 主題

設定主機

設定主機會將程式智能體的生命週期 hooks 串接到 Moshpit,讓你的手機能即時掌握每個智能體的狀態,並在智能體需要你或完成回合時收到端對端加密推播。

Moshpit 絕不悄悄修改主機上的任何檔案。首次連線時會先詢問你的同意,之後隨時都能檢視、測試、修復或移除:

  1. 在 Moshpit 連上目標主機。
  2. 打開設定 › 設定主機並點選已連線的主機。
  3. 在 智能體狀態下選擇一個智能體,點安裝(或更新/重新安裝)。點下方測試列(需在已開啟的 tmux 窗格中)即可驗證標記腳本能正常運作。
  4. 在推播通知下點配對(或重新配對),再保持 Moshpit 停留在前景並點送一則測試通知,確認端到端送達。

推播需要主機裝有 openssl 與 curl。安裝 jq 則為選用,裝了之後「已完成」通知就能一併帶上智能體剛處理完的提示詞。

所有 Moshpit 檔案都集中放在 ~/.moshpit,且除非你主動確認要替其他智能體安裝,否則只會為該主機上偵測到的智能體寫入 hook 設定:

路徑 用途
~/.moshpit/moshpit-stamp.sh 由智能體 hooks 觸發;在 tmux 窗格標記 @moshpit_* 選項,並在「在等你」與「已完成」時觸發推播。
~/.moshpit/moshpit-push.sh 在主機端加密狀態內容,並將密文送往推播中繼伺服器。
~/.moshpit/manifest.json 記錄已安裝檔案的 SHA-256 雜湊值,讓 Moshpit 判斷腳本是否需要更新。
~/.moshpit/push.d/<connection-id>.conf 這部手機專屬的 256 位元配對金鑰與傳送權杖,檔案權限為 0600。
<config>.moshpit.orig Moshpit 首次修改某個智能體設定檔前先留存的一次性原始備份。

視主機上存在的智能體而定,Moshpit 會把 hook 項目合併進 ~/.claude/settings.json、~/.codex/config.toml、~/.gemini/settings.json、~/.qwen/settings.json、~/.qoder/settings.json、~/.factory/settings.json(或 ~/.factory/hooks.json)與 ~/.codebuddy/settings.json,並完整保留檔案中原有的其他設定。

Codex 預設不會執行剛加入的新 hook,必須先在主機上手動核准:

  1. 在主機的 shell 啟動 codex。
  2. 執行 /hooks。
  3. 將 Moshpit 的四個項目設為信任。

在完成這一步之前,Codex 不會在 tmux 回報狀態,也不會送出推播。

連上該主機後,打開設定 › 設定主機:

  • 僅移除單一智能體:在 智能體狀態下選擇該智能體並點移除。
  • 僅停用這部手機的推播:在推播通知下點解除配對,刪除這部手機的配對檔並停止該主機發推播過來。
  • 全部移除:點移除主機設定並確認。Moshpit 會從各智能體設定檔抽離自己的 hook 項目(保留其餘設定不變)、移除這部手機的配對,若沒有其他手機仍與該主機配對,還會一併刪除 ~/.moshpit。