handmux
行動 Vibe Coding 駕駛艙 —— 以 tmux 為基礎:從手機驅動你的即時工作階段、Claude Code / Codex,以及任何終端機可執行的一切。
handmux 是什麼?
行動 Vibe Coding 駕駛艙 —— 以 tmux 為基礎:從手機驅動你的即時工作階段、Claude Code / Codex,以及任何終端機可執行的一切。
handmux 概覽
這是什麼
handmux 是一個自架、開源的工具,能將你的手機變成行動 Vibe Coding 駕駛艙。它基於 tmux 建構,讓你可以從手機瀏覽器操控你電腦上的即時終端機工作階段、Claude Code、Codex 或任何命令列工具。不需要安裝手機 App 或註冊 handmux 帳號;你的瀏覽器直接連接到你的電腦。
主要功能
- 即時終端機 — 從手機和桌面使用同一個 tmux 窗格,支援歷史記錄、實體鍵盤輸入以及原生複製貼上。
- 代理對話 — 在串流聊天畫面中與 Codex 協作;可選的 Claude Code 與 Pi 整合能將同一個工作區帶入它們支援的對話流程。
- 收件匣與核准 — 追蹤多個窗格、接收推播通知,並遠端回覆權限或計畫提示。
- Git 與預覽 — 從瀏覽器檢視儲存庫,並開啟正在執行的網站、內部網路頁面或靜態資料夾。
- 文件與檔案 — 開啟可讀檔案、聽取文件內容,以及雙向上傳、下載或分享檔案。
- 點子與語音 — 為每個視窗保留筆記,並透過支援的科大訊飛或騰訊辨識模式輸入文字。
- 用量一覽 — 檢視支援的代理訂閱限制與已設定的 API 提供者餘額,而不會在瀏覽器中暴露完整金鑰。
- 彈性工作階段 — 在弱網路環境下重新連線,並在重新啟動後還原已儲存的 tmux 工作區結構。
- 腳本推播 — 從本機腳本或 CI 使用
handmux push傳送通知到手機。 - 零安裝 PWA — 將它加入主畫面,即可獲得支援英文、中文、日文或韓文的全螢幕體驗。
使用情境
當你離開電腦時,使用 handmux 從手機繼續以 Claude Code、Codex、Pi 或任何終端機工具進行開發。檢視變更、回覆代理提示、預覽應用程式以及移動檔案,無需啟動另一個遠端工作階段。它專為想要在外出時透過即時 tmux 工作區保持生產力的開發者設計。
快速開始
你的電腦需要 tmux 與 Node ≥ 22.16;手機只需要瀏覽器。選擇一種方式:Homebrew — macOS(建議) · 會自動安裝 Node 與 tmux:bashbrew install handmux/tap/handmuxnpm — 任何平台 · 如果你已經有 Node:bashnpm i -g handmux然後執行:bashhandmux start # 本機 / 同一個 Wi-Fi,不暴露對外````start` 會印出 QR 碼(以及網址和權杖)。用手機掃描 QR 碼 — 權杖已內嵌在碼中,因此第一次開啟就會自動登入。你會看到真實的 tmux 工作階段;點選一個窗格即可開始操控。想從任何地方連線?加上一個旗標即可獲得免費的公開 HTTPS 連結:bashhandmux start --tunnel cloudflare # 即時公開網址(cloudflared 會自動安裝)```
授權與價格
授權:AGPL-3.0。價格類型:開源。
內容整理自該專案公開的 README 與儲存庫資訊。