psmux：Windows 原生 tmux 终端复用器

项目简介

psmux 是专为 Windows 从零构建的原生终端复用器，使用 Rust 编写，直接基于 Windows ConPTY，而不是移植、包装或借助 WSL / Cygwin / MSYS2 的方案。它说 tmux 的命令语言、读取你的 .tmux.conf、支持 tmux 主题，可直接在 PowerShell、Windows Terminal 和 cmd.exe 中使用。

安装后同时提供 psmux、pmux、tmux 三个命令，习惯 tmux 的用户直接敲 tmux 即可。

主要功能

• tmux 兼容：90+ 条 tmux 兼容命令（psmux list-commands 可查看实时列表）、140+ 格式变量、53 个 vim 风格 copy-mode 按键，现有 .tmux.conf 可直接使用。
• 原生多路复用：客户端/服务端架构，每个面板一个 ConPTY，输入输出独立通道，并带预热会话池（warm pool）加快新建会话。
• 完整鼠标支持：包括通过 SSH 使用时的鼠标支持。
• 布局与会话持久化：分屏、多窗口、命名会话、detach / attach、布局预设与保存恢复。
• 主题与插件生态：支持 Catppuccin、Dracula、Nord 等 tmux 主题。
• 多 Shell 并存：可同时运行 pwsh、cmd、Git Bash、WSL、nushell。
• Claude Code 智能体团队：在 psmux 会话中运行 Claude Code 时，协作智能体会自动在独立的 tmux 面板中启动，无需额外配置。
• 面向开发者的控制模式：提供 -C / -CC 线协议，可从 Python、Node.js、Go、Rust 及 libtmux 驱动，也支持 iTerm2 tmux gateway。

安装与使用

使用 WinGet：

winget install psmux

使用 Cargo（会安装 psmux、pmux、tmux 三个二进制）：

cargo install psmux

使用 Scoop：

scoop bucket add psmux https://github.com/psmux/scoop-psmux
scoop install psmux

使用 Chocolatey：

choco install psmux

也可以从 GitHub Releases 下载 .zip 并加入 PATH，或从源码构建：

git clone https://github.com/psmux/psmux.git
cd psmux
cargo build --release

构建产物位于 target\release\psmux.exe、pmux.exe、tmux.exe。

常用命令：

psmux                        # 启动新会话
psmux new-session -s work    # 创建命名会话
psmux ls                     # 列出会话
psmux attach -t work         # 接入会话
psmux list-commands          # 列出所有支持的命令
psmux --help                 # 查看帮助

在 psmux 会话中直接运行 claude，智能体团队即可自动分面板工作。

注意事项

• 运行环境要求 Windows 10 或 Windows 11，推荐 PowerShell 7+（winget install --id Microsoft.PowerShell）或 cmd.exe。
• 项目以 MIT 许可证开源。
• 项目还为构建场景提供了带 Rust + MSVC + SSH 的 Windows Docker 镜像，详见仓库 docker/README.md。

---

本作品整理自 GitHub 开源项目 psmux/psmux，原作者 @psmux，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。