purplemux / for Claude Code

Claude Code, 多個工作階段 同時進行. 更快.

以 tmux 為基礎的多工作階段儀表板。
瀏覽器、行動裝置、終端 — 一個無縫的工作流程。

$ npx purplemux
下載 macOS 應用程式
● Node.js 20+ ● 需要 tmux ● macOS / Linux
purplemux 桌面儀表板 purplemux 行動版畫面
為何選 purplemux

所有工作階段,一個儀表板。

工作階段越多,狀態越難追蹤。
purplemux 把所有工作階段集中到一個畫面,讓你一眼看見 目前正在進行什麼、哪裡需要輸入。

速率限制 側邊欄
5h 剩 2h 14m (85%)
7d 剩 4d 9h (60%)

你的額度,即時呈現。

專注時撞到限制,思路就被打斷。 在等下一次重設之前,工作只能停在那裡。

purplemux 將 5 小時與 7 天額度固定顯示在側邊欄。 到 50% 和 80% 時顏色會切換,讓你在撞牆前先調整節奏。

purplemuxin progress
docs-siteneeds input
landingreview
refactoridle
多工作階段儀表板
一眼看見所有 Claude Code 工作階段的 執行中 / 待輸入 狀態。
Refactor auth module
readsrc/lib/auth.ts
editsrc/lib/auth.ts
00:24
即時工作階段檢視
進度以時間軸呈現 — 不再需要捲動 CLI 記錄。
IN PROGRESS3
landing-copy
REVIEW2
fix-auth-bug
tsc-errors
DONE7
依狀態分組的工作階段
所有工作階段會自動歸類為 Review · In Progress · Done。
term diff
web
工作區儲存與還原
以 tmux 為基礎,關閉瀏覽器工作階段也不會消失。面板佈局、分頁、工作路徑都會在第二天一鍵還原。
src/lib/auth.ts
12
13
14
15
12
13
14
15
Git diff 檢視器
在終端旁的面板直接看 diff。並列 / 行內切換,附語法標示。
~/dev❯docker compose up
~/dev❯vim src/handler.ts
~/dev❯ssh prod.example.com
~/dev❯pnpm dev
真正的終端
不限於 Claude Code。xterm.js + node-pty 打造的完整終端,vim · docker · ssh · REPL 任你用。
行動裝置 & 推播

離開桌子,一樣順暢。

你不需要只為了盯著長時間任務而守在桌前。 用行動裝置瀏覽器打開並加到主畫面,它就像原生應用一樣。關閉分頁後,任務完成 / 待輸入通知依然透過 Web Push 送達。

purplemux 行動裝置推播通知

加入主畫面 (PWA)

用瀏覽器開啟後加入主畫面,就會產生一個全螢幕應用圖示。

iOS (Safari)
  1. 在 Safari 中開啟 http://<主機>:8022
  2. 點下方的分享按鈕
  3. 在清單中選擇加入主畫面
  4. 點右上方的加入
Android (Chrome)
  1. 在 Chrome 開啟網址
  2. 打開右上方的 ⋮ 選單
  3. 選擇安裝應用程式或加入主畫面

開啟推播通知

  1. 在 Settings → Notification → On 啟用,並允許瀏覽器通知權限
  2. 即使在背景也會透過 Web Push 送達
  3. 在任務完成與需要輸入時提醒
  4. 點通知可直接跳到對應的工作階段

透過 Tailscale 進行外部存取

若要從外部網路存取,Tailscale Serve 是最乾淨的方式。 自動附上 WireGuard 加密與 HTTPS 憑證。 

$ tailscale serve --bg 8022

之後可透過 https://<machine>.<tailnet>.ts.net 從任何地方存取。 iOS Safari 必須是 HTTPS,PWA 和 Web Push 才能正常運作。

統計 & 分析

所有使用量,在一個畫面。

今天用掉的 token、本月費用、依專案的使用量、依模型的分布 — 將分散的數字集中到一處,工作節奏與成本結構一目了然。

purplemux 使用量統計儀表板
01
四張概覽卡 Sessions · Total · Today · Month
02
每日活動趨勢 最近 30 天的工作階段 · 訊息圖表
03
連續工作天數 Longest · Current · Count · Avg
04
每週時間軸 星期 × 時段 + 並行工作階段
AI 每日報告

今日工作,自動摘要。

一天結束後,系統會集合工作階段記錄,讓 LLM 產生一行簡報和詳細摘要。 以 Markdown 儲存,回顧、報告、1:1 隨時可用。

2026-04-13 (Mon) 15 sessions · $5.87
撰寫 purplemux 著陸頁初稿,將行動 / PWA 區塊與統計儀表板串起來。把文案統一為 Apple 調性,全面替換 feature 卡片 mockup。
∧ Collapse
purplemux
著陸頁初稿
  • 設計 8 個區塊結構和 Hero / Why / Mobile / Stats 的佈局
  • 將 purple 品牌色抽成 OKLCH 變數
  • 套用桌面 / 行動截圖的 mockup 外框
Feature 卡片 mockup
  • 在多工作階段儀表板中重現真實的 spinner / pulse 指示器
  • 微調 Git Diff、工作區、Self-hosted mockup 的 CSS 細節
  • 為 Tailscale 存取流程圖加上動畫

brief + detailed 雙層摘要

一行的 brief 顯示在儀表板,detailed 點一下就展開。 是 Markdown,可直接複製到回顧或報告。

批次產生與重新生成

缺少的日期可以一次批次補齊,想重做某天也只重做那天。 LLM 會以工作階段為單位處理,不會遺失上下文。

隨時快速開啟

常駐在側邊欄的 筆記,快捷鍵 Cmd ⇧ E (macOS) / Ctrl ⇧ E (Linux) 直接開啟。 只存本地,無須擔心外洩。

功能

只給你需要的,剛剛好。

終端 7
  • 分割面板水平 · 垂直分割,可拖曳調整
  • 分頁管理多分頁、重新排序、依行程名稱自動命名
  • 快捷鍵分割 · 切換分頁 · 焦點切換
  • 主題深色 / 淺色 · 多種配色
  • 工作區儲存 / 還原面板、分頁、工作路徑
  • Git diff 檢視器並列顯示 · 語法標示
  • Web 瀏覽器面板內建 Electron 預覽
Claude Code 整合 10
  • 即時狀態進行中 / 待輸入,瞬間切換
  • 側邊欄工作階段模式Workspace ↔ Sessions 切換,依狀態分組檢視
  • 即時工作階段檢視訊息 · 工具呼叫 · 任務 · 權限提示
  • 一鍵繼續直接在瀏覽器中接續被中斷的工作階段
  • 自動還原伺服器重新啟動後找回之前的工作階段
  • 快速提示詞登記常用提示詞,一鍵執行
  • 訊息歷史重複使用先前訊息
  • 使用量分析token · 費用 · 依專案 · 每日報告
  • 速率限制倒數5 小時 / 7 天剩餘 · 距離重設時間
  • 額度使用警示側邊欄進度條在 50% · 80% 變 amber · red
行動裝置 & 易用性 7
  • 響應式 UI手機 · 平板也能顯示終端 · 時間軸
  • PWA加入主畫面 · 接近原生應用
  • Web Push關閉分頁也能收到通知
  • 多裝置同步工作區變更即時同步
  • Tailscale透過 HTTPS 安全外部存取
  • 密碼認證scrypt 雜湊
  • 多語系한국어 · English · 日本語 · 中文 · 共 11 種
自訂 9
  • 主題Light / Dark / System 自動
  • 字級Normal · Large · X-Large
  • Custom CSS透過 CSS 變數完全覆寫
  • 終端主題淺色 / 深色各自指定配色
  • 側邊欄重新排列顯示 / 隱藏項目 · 拖曳排序
  • Quick Prompts 庫新增自訂提示詞 · 拖曳排序
  • 編輯器整合透過 code-server URL 串接外部編輯器
  • 通知控制系統通知開 / 關
  • Claude 選項切換略過權限等 CLI 選項
架構

瀏覽器 ↔ Node.js ↔ tmux · Claude Code.

xterm.js 透過 WebSocket 連接 node-pty,node-pty 接到專用 purple socket 的 tmux 工作階段。 狀態由 Claude Code hook 與 JSONL 記錄 watcher 共同追蹤。

Browser UI
xterm.js
Terminal
Timeline
events
Status
indicators
Multi‑device
sync
WebSocket
/terminal /timeline /status /sync
Node.js Server :8022
node-pty
Binary PTY ↔ WS
JSONL Watcher
file → parse → send
Status Manager
process tree + JSONL tail
Binary PTY · 二進位 stdin/out Hook + 5–15 秒輪詢 攔截權限提示 1MB 背壓 · 10 佇列
spawn · read
System local
tmux · purple socket
session 1 session 2 …
獨立的 purple socket 重新啟動後並行還原
Claude Code
~/.claude/sessions/ ~/.claude/projects/{id}.jsonl
與官方 Remote Control 的差異

超越遠端控制,走向整合工作區。

官方 Remote Control 是一款在其他裝置上繼續 Claude Code 工作階段的遠端存取工具。 purplemux 在其基礎上加上 多工作階段儀表板、終端擴充、使用量分析,形成一套自架的營運環境。

項目 官方 Remote Control purplemux
同時檢視工作階段 從清單一次開一個 所有工作階段、所有狀態同時顯示
狀態指示 線上 / 離線 即時顯示 Busy · Review · Needs-input · Idle
推播通知 需要 Claude 行動應用程式 Web Push · 任何瀏覽器無需安裝
終端持續性 只在 claude 程序執行期間 以 tmux 為基礎 · 重啟後自動還原
附帶工具 僅 Claude Code 工作階段 分割終端 · Git diff · 工作區儲存
使用量分析 — token · 費用 · 依專案 · AI 每日報告
強項 Anthropic 官方 · Claude 行動應用程式整合 · 自動更新 第三方開源 · 需手動安裝與維運
安裝

30 秒搞定。

你只需要 Node.js 20+ 和 tmux。一行安裝,再打開瀏覽器即可。

1

執行

可直接用 npx 啟動,也支援全域安裝。

$ npx purplemux
2

開啟瀏覽器

預設連接埠為 8022,可透過 PORT 環境變數修改。

→ http://localhost:8022
3

遠端存取 (可選)

需要外部存取時建議 Tailscale Serve,自動附帶 WireGuard 加密與憑證。

$ tailscale serve --bg 8022
4

原生應用 (可選)

macOS 上也可使用 Electron 版本,Apple Silicon 與 Intel 皆支援。

下載最新版本 →
常見問題

你可能想問的。

可以幫我省錢嗎?

它讓你的使用情況變得透明。 今天、本月、依專案的費用,依模型的 token 分布,5 小時 · 7 天額度剩餘,都能在一個畫面確認,讓你自己調整支出結構。

權限提示能從手機批准嗎?

可以。purplemux 會從終端攔截 Claude Code 的權限對話框,並推送到儀表板和行動通知。 隨時隨地都能批准,任務不會被擱置。

系統當機會丟失工作階段嗎?

關閉瀏覽器或斷線都沒問題 — tmux 會保留工作階段。 整機重新啟動後,purplemux 也會掃描工作區佈局,並行還原先前的 Claude 工作階段。 無需手動還原。

資料保存在哪裡?

所有設定與工作階段資料都儲存在本地的 ~/.purplemux/ 目錄。 不會向外部伺服器發送任何內容。認證以 scrypt 雜湊存於 config.json。

Windows 能用嗎?

官方不支援。由於 tmux 與 node-pty 的平台限制,只支援 macOS 與 Linux。 WSL2 可能可以執行,但不在測試範圍。

會和現有的 tmux 工作階段衝突嗎?

purplemux 會在專用的 purple socket 啟動獨立的 tmux 實例。 與現有的 tmux 工作階段和 ~/.tmux.conf 完全獨立。

如何從外部存取?

建議使用 Tailscale Serve,提供 WireGuard 加密與自動 HTTPS 憑證。 若使用自己的反向代理,請務必在 Nginx / Caddy 轉發 Upgrade 與 Connection 標頭。

要付費嗎?

purplemux 本身為 MIT 授權開源軟體,免費。Claude Code 的使用費用另計。

行動裝置上真的好用嗎?

是的。內建響應式 UI、PWA、Web Push。加入主畫面後接近原生應用體驗, 關閉分頁也能收到任務完成與待輸入的通知。

有多國語言嗎?

支援 11 種語言:한국어 · English · 日本語 · 简体中文 · 繁體中文 · Deutsch · Español · Français · Русский · Português (Brasil) · Türkçe。

立即開始

一行指令就夠了。

只要準備好 Node.js 20+ 和 tmux,30 秒內就能跑起來。

$ npx purplemux
下載 macOS 應用程式
自架 · 開源

在你的機器,屬於你。

purplemux 是一款在本地執行的自架工具。 工作階段資料、設定、歷史都只保存在 ~/.purplemux/,不會離開你的機器。 全部原始碼以 MIT 開源 — 可以閱讀、修改、貢獻。

MIT 授權 100% 本地 0 遙測
~/.purplemux/
├─ config.json
├─ workspaces.json
└─ sessions/
MIT local-only