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 與儲存庫資訊。

將此徽章加入你的 README

Featured on YunoDB 徽章樣式與說明

你是這個專案的維護者嗎?展示它已收錄於 YunoDB。

Markdown[![Featured on YunoDB](https://yunodb.com/badge/handmuxhandmux.svg)](https://yunodb.com/tools/handmuxhandmux?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/handmuxhandmux?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/handmuxhandmux.svg" alt="Featured on YunoDB" height="20"></a>