╔═══════════════════════════════════════════════════════════╗
║   ██████╗ ███████╗███╗   ███╗██╗   ██╗██╗  ██╗            ║
║   ██╔══██╗██╔════╝████╗ ████║██║   ██║╚██╗██╔╝            ║
║   ██████╔╝███████╗██╔████╔██║██║   ██║ ╚███╔╝             ║
║   ██╔═══╝ ╚════██║██║╚██╔╝██║██║   ██║ ██╔██╗             ║
║   ██║     ███████║██║ ╚═╝ ██║╚██████╔╝██╔╝ ██╗            ║
║   ╚═╝     ╚══════╝╚═╝     ╚═╝ ╚═════╝ ╚═╝  ╚═╝            ║
║     Born in PowerShell. Made in Rust. 🦀                 ║
║          Terminal Multiplexer for Windows                 ║
╚═══════════════════════════════════════════════════════════╝

The native Windows tmux. Born in PowerShell, made in Rust.
Full mouse support · tmux themes · tmux config · 76 commands · blazing fast

Install · Usage · Performance · Compatibility · Features · Keys · Scripting · Config · FAQ

The real tmux for Windows. Not a port, not a wrapper, not a workaround.

psmux is a native Windows terminal multiplexer built from the ground up in Rust. It uses Windows ConPTY directly, speaks the tmux command language, reads your .tmux.conf, and supports tmux themes. All without WSL, Cygwin, or MSYS2.

💡 Tip: psmux ships with tmux and pmux aliases. Just type tmux and it works!

👀 On Windows 👇

winget install psmux

cargo install psmux

This installs psmux, pmux, and tmux binaries to your Cargo bin directory.

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

choco install psmux

Download the latest .zip from GitHub Releases and add to your PATH.

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

Built binaries:

target\release\psmux.exe
target\release\pmux.exe
target\release\tmux.exe

• Windows 10 or Windows 11
• PowerShell 7+ (recommended) or cmd.exe
  • Download PowerShell: winget install --id Microsoft.PowerShell
  • Or visit: https://aka.ms/powershell

If you've used tmux on Linux/macOS and wished you had something like it on Windows, this is it.

Split panes, multiple windows, session persistence, 76 commands, full mouse, tmux themes, 126+ format variables, 53 vim copy-mode keys. Full details: docs/features.md

psmux is built for speed. The Rust release binary is compiled with opt-level 3, full LTO, and single codegen unit. Every cycle counts.

• Lazy pane resize : only the active window's panes are resized. Background windows resize on-demand when switched to, avoiding O(n) ConPTY syscalls
• Cached shell resolution : which PATH lookups are cached with OnceLock, not repeated per spawn
• 10ms polling : client-server discovery uses tight 10ms polling for sub-100ms session attach
• Early port-file write : server writes its discovery file before spawning the first shell, so the client connects instantly
• 8KB reader buffers : small buffer size minimizes mutex contention across pane reader threads

Note: The primary startup bottleneck is your shell (PowerShell 7 takes ~400-1000ms to display a prompt). psmux itself adds < 100ms of overhead. For faster shells like cmd.exe or nushell, total startup is near-instant.

psmux is the most tmux-compatible terminal multiplexer on Windows:

Your existing .tmux.conf works. psmux reads it automatically. Just install and go.

psmux has a full plugin ecosystem — ports of the most popular tmux plugins, reimplemented in PowerShell for Windows. Themes, key bindings, session management, clipboard integration, and more.

Browse available plugins and themes: psmux-plugins

Install & manage plugins with a TUI: Tmux Plugin Panel (tppanel) — a terminal UI for browsing, installing, updating, and removing plugins and themes.

Themes: Catppuccin · Dracula · Nord · Tokyo Night · Gruvbox

Quick start:

# Install the plugin manager
git clone https://github.com/psmux-plugins/ppm "$env:USERPROFILE\.psmux\plugins\ppm"

Then add to your ~/.psmux.conf:

set -g @plugin 'psmux-plugins/ppm'
set -g @plugin 'psmux-plugins/psmux-sensible'
run '~/.psmux/plugins/ppm/ppm.ps1'

Press Prefix + I inside psmux to install the declared plugins.

Use psmux, pmux, or tmux, they're identical:

# Start a new session
psmux
pmux
tmux

# Start a named session
psmux new-session -s work
tmux new-session -s work

# List sessions
psmux ls
tmux ls

# Attach to a session
psmux attach -t work
tmux attach -t work

# Show help
psmux --help
tmux --help

psmux has first-class mouse support over SSH when the server runs Windows 11 build 22523+ (22H2+). Click panes, drag-resize borders, scroll, click tabs — everything works, from any SSH client on any OS.

Mouse works perfectly when running psmux locally on both Windows 10 and 11.

Windows 10's ConPTY consumes mouse-enable escape sequences internally and does not forward them to sshd. The SSH client never receives the signal to start sending mouse data. This is a Windows 10 ConPTY limitation that was fixed in Windows 11 (build 22523+). Keyboard input works fully on both versions — only mouse over SSH is affected.

Recommendation: Use Windows 11 build 22523+ (22H2 or later) as your psmux server for full SSH mouse support.

Default prefix: Ctrl+b (same as tmux). Full reference: docs/keybindings.md

76 tmux-compatible commands, hooks, targets, capture-pane, pipe-pane. Full reference: docs/scripting.md

Reads ~/.psmux.conf, ~/.tmux.conf, or ~/.config/psmux/psmux.conf. Fully tmux-compatible syntax — your existing config works. Full reference: docs/configuration.md

MIT

Contributions welcome — bug reports, PRs, docs, and test scripts via GitHub Issues.

If psmux helps your Windows workflow, consider giving it a ⭐ on GitHub!

docs/faq.md · docs/features.md · docs/keybindings.md · docs/scripting.md · docs/configuration.md

Made with ❤️ for PowerShell using Rust 🦀