~ moshterm-hook
Companion
moshterm-hook 是執行在您代理程式所在電腦上的小程式。它讓終端機能夠知道什麼時候有代理程式正在等您。
取得手機 App
Android 版 moshterm 現已在 Google Play 上架,iPhone 與 iPad 版即將推出。終端機與 Companion 功能免費;moshterm Pro 新增即時預覽。
新增的功能
- 核准:代理程式的權限詢問會送到您的手機,您的回覆會傳回給它。
- Inbox 與通知:哪些工作階段需要您、哪些正在處理中、哪些已完成。
- 聊天檢視(Chat View):在您的電腦本機讀取代理程式工作紀錄,並以對話方式顯示。
- Jump To 與工作階段選擇器中的 tmux、Zellij 與 Herdr 清單。
- 終端機所在資料夾的 Diff 檢視與檔案瀏覽。
不裝它,moshterm 依然是完整的 Mosh、Eternal Terminal 與 SSH 終端機。
輕鬆方式
從 App 連線到您的電腦。若尚未安裝 Companion,moshterm 會詢問是否透過同一條連線幫您安裝;同意後其餘會自動完成。日後發現舊版 Companion 時,連線也會以同樣的方式更新。
手動安裝
在 macOS、Linux 或 WSL 上:
curl -fsSL https://mickmosh-relay.mick-fb5.workers.dev/install.sh | sh若您的系統具備 SHA-256 驗證工具,安裝程式會依公開的校驗和核對下載檔案。接著為您的代理程式新增掛鉤:
moshterm-hook install支援託管掛鉤的代理程式:Claude Code、Codex、OpenCode、Cursor、Grok Build、Kimi Code、Hermes、Pi 與 OMP。moshterm-hook uninstall 只會移除 install 寫入的項目。
配對
無需複製任何權杖。手機首次透過 SSH 連線時,會在同一工作階段向 Companion 取得權杖,之後便透過該 SSH 連線通訊。如果想掃描 QR Code 新增電腦而不用手動輸入位址,請執行 moshterm-hook pair --qr 並用 App 掃描。
安裝位置與權限
- 以您的使用者身分執行,僅監聽
127.0.0.1。在多人共用的電腦上,手機傳送任何資料前都會先確認對象確實是您的 Companion,而非其他使用者的。 - 其狀態儲存在
~/.moshterm/,僅您本人可讀取。 - 單一靜態二進位檔,支援 macOS 與 Linux 的 ARM 及 x86 架構。
主機上的 Mosh 與 tmux
要在切換網路時維持工作階段,電腦需要安裝 mosh-server;要讓工作階段在斷線後繼續存活,則需要多工器。Eternal Terminal 為選用項目。
brew install mosh tmuxsudo apt install mosh tmux遇到異常時
moshterm-hook doctor 會印出執行中 Companion 所看到的資訊:監聽位址、偵測到的工具、各代理程式的掛鉤狀態,以及是否已完成配對。它支援透過 SSH 執行,因此可直接從手機檢查。
還是卡關嗎?支援頁面(英文)提供聯絡信箱。