文件 · 主題
設定主機
設定主機會將程式智能體的生命週期 hooks 串接到 Moshpit,讓你的手機能即時掌握每個智能體的狀態,並在智能體需要你或完成回合時收到端對端加密推播。
執行主機設定
Section titled “執行主機設定”Moshpit 絕不悄悄修改主機上的任何檔案。首次連線時會先詢問你的同意,之後隨時都能檢視、測試、修復或移除:
- 在 Moshpit 連上目標主機。
- 打開設定 › 設定主機並點選已連線的主機。
- 在 智能體狀態下選擇一個智能體,點安裝(或更新/重新安裝)。點下方測試列(需在已開啟的 tmux 窗格中)即可驗證標記腳本能正常運作。
- 在推播通知下點配對(或重新配對),再保持 Moshpit 停留在前景並點送一則測試通知,確認端到端送達。
推播需要主機裝有 openssl 與 curl。安裝 jq 則為選用,裝了之後「已完成」通知就能一併帶上智能體剛處理完的提示詞。
主機上會寫入哪些檔案
Section titled “主機上會寫入哪些檔案”所有 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 裡信任 hooks
Section titled “在 Codex 裡信任 hooks”Codex 預設不會執行剛加入的新 hook,必須先在主機上手動核准:
- 在主機的 shell 啟動
codex。 - 執行
/hooks。 - 將 Moshpit 的四個項目設為信任。
在完成這一步之前,Codex 不會在 tmux 回報狀態,也不會送出推播。
連上該主機後,打開設定 › 設定主機:
- 僅移除單一智能體:在 智能體狀態下選擇該智能體並點移除。
- 僅停用這部手機的推播:在推播通知下點解除配對,刪除這部手機的配對檔並停止該主機發推播過來。
- 全部移除:點移除主機設定並確認。Moshpit 會從各智能體設定檔抽離自己的 hook 項目(保留其餘設定不變)、移除這部手機的配對,若沒有其他手機仍與該主機配對,還會一併刪除
~/.moshpit。