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。基于 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 中打开 URL
  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 板块与统计仪表板连起来。统一文案调性,全面替换 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