Tmux on Windows Powershell - tmux for PowerShell, Windows Terminal, cmd.exe. Includes psmux, pmux, and tmux commands. This is native High-Performance Tmux designed for Windows in Rust π¦
See the code
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β βββββββ ββββββββββββ βββββββ ββββββ βββ β
β βββββββββββββββββββββ ββββββββ βββββββββββ β
β ββββββββββββββββββββββββββββββ βββ ββββββ β
β βββββββ ββββββββββββββββββββββ βββ ββββββ β
β βββ βββββββββββ βββ ββββββββββββββββ βββ β
β βββ βββββββββββ βββ βββββββ βββ βββ β
β 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 Β· 90+ commands Β· blazing fast
Install Β· Usage Β· Get Started Β· Use Cases Β· Tutorials Β· Claude Code Β· Architecture Β· Features Β· Compatibility Β· Performance Β· Plugins Β· Keys Β· Scripting Β· Config Β· Mouse/SSH Β· FAQ Β· Related Projects
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
tmuxandpmuxaliases. Just typetmuxand 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/psmux/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/psmux/psmux.git
cd psmux
cargo build --release
Built binaries:
target\release\psmux.exe
target\release\pmux.exe
target\release\tmux.exe
A ready-made Windows container with Rust + MSVC + SSH for building psmux:
cd docker
docker build -t psmux-dev .
docker run -d --name psmux-dev -p 127.0.0.1:2222:22 -e ADMIN_PASSWORD=YourPass123! psmux-dev
ssh ContainerAdministrator@localhost -p 2222
See docker/README.md for full details.
winget install --id Microsoft.PowerShellIf 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, full mouse support, tmux themes, 90+ tmux-compatible commands (run psmux list-commands for the live list), 140+ format variables, 53 vim copy-mode keys. Your existing .tmux.conf works. Full details: docs/features.md Β· docs/compatibility.md
Use psmux, pmux, or tmux. They're identical:
psmux # Start a new session
psmux new-session -s work # Named session
psmux ls # List sessions
psmux attach -t work # Attach to a session
psmux list-commands # List every command psmux accepts
psmux --help # Show help
psmux has first-class support for Claude Code agent teams. When Claude Code runs inside a psmux session, teammate agents automatically spawn in separate tmux panes instead of running in-process.
psmux new-session -s work # Start a psmux session
claude # Run Claude Code, agent teams just work
No extra configuration needed. Full guide: docs/claude-code.md
The full index with one line summaries of every page lives in docs/README.md. AI assistants and crawlers can start from llms.txt.
| Tutorial | What you will learn |
|---|---|
| Getting Started on Windows | Install, first session, prefix key, splits, detach and reattach, first config, Windows Terminal profile |
| Cross Platform tmux Scripts | Write one tmux automation script that runs unchanged on Windows (psmux), Linux and macOS (tmux) |
| Terminal AI Agents and TUIs | Run Claude Code, Codex CLI, Gemini CLI, neovim, lazygit and other TUIs in scripted multi pane layouts |
| Dev Environment Layouts | Multi window and multi pane project sessions, layout presets, bootstrap scripts, save and restore |
| Topic | Description |
|---|---|
| Windows Use Cases | Practical Windows scenarios: startup services, AI agents, dashboards, remote admin |
| Architecture | How psmux multiplexes natively: client/server, one ConPTY per pane, input and output paths, warm pool |
| Features | Full feature list: mouse, copy mode, layouts, format engine |
| Compatibility | tmux command/config compatibility matrix |
| Performance | Benchmarks and optimization details |
| Key Bindings | Default keys and customization |
| Scripting | Commands, hooks, targets, pipe-pane |
| Command Reference | Per-command flag tables |
| Configuration | Config files, options, environment variables |
| Multi-Shell | Running pwsh, cmd, Git Bash, WSL, and nushell side by side |
| Pane Titles | Pane titles, border labels, and why pwsh shows a path |
| Chooser Preview | Live preview pane in choose-tree and choose-session |
| Warm Sessions | The pre-spawned server behind instant session creation |
| Diagnostics | Debug logs, crash logs, state files, what to attach to a bug report |
| Plugins & Themes | Plugin ecosystem: Catppuccin, Dracula, Nord, and more |
| Mouse Over SSH | SSH mouse support and Windows version requirements |
| Control Mode | The -C / -CC wire protocol for IDE and plugin authors |
| iTerm2 Control Mode | Driving psmux from the iTerm2 tmux gateway over SSH |
| Developer Integration | Driving psmux from Python, Node.js, Go, Rust, and libtmux |
| Claude Code | Agent teams integration guide |
| FAQ | Common questions and answers |
 pstop htop for Windows: real-time system monitor with per-core CPU bars, tree view, 7 color schemes cargo install pstop
|
 psnet Real-time TUI network monitor: live speed graphs, connections, traffic log, packet sniffer cargo install psnet
|
 Tmux Plugin Panel TUI plugin & theme manager for tmux and psmux: browse, install, update from your terminal cargo install tmuxpanel
|
 OMP Manager Oh My Posh setup wizard: browse 100+ themes, install fonts, configure shells automatically cargo install omp-manager
|
 DeskVNC VNC, RDP and SSH client for Windows, macOS and Linux, with an MCP server so AI agents can drive remote desktops github.com/psmux/DeskVNC/releases
|
 GodwinMix Live video mixer in Rust: headless core, web UI, desktop app, MCP for agents docker compose up
|
 TerminalMap OpenStreetMap vector tiles rendered in your terminal, as an app and a Rust library cargo install terminalmap
|
 vigil Security dashboard for Linux servers: attack radar, every listening port with its risk, a 0 to 100 security score build from source
|
 browserglass Stream real Chrome browsers into any web page, drive them from code or AI agents, and hand control to a person at any moment pnpm install && pnpm -r build
|
 tmuxtop A top for tmux: every process in every session, with session navigation, export and backup pip install psutil
|
Every project, with live demos: psmux.github.io
MIT
Contributions welcome: bug reports, PRs, docs, and test scripts via GitHub Issues.
Filing a bug? See docs/diagnostics.md for the logs and state files to attach.
If psmux helps your Windows workflow, consider giving it a β on GitHub!
Made with β€οΈ for PowerShell using Rust π¦
Tmux on Windows Powershell - tmux for PowerShell, Windows Terminal, cmd.exe. Includes psmux, pmux, and tmux commands. This is native High-Performance Tmux designed for Windows in Rust π¦
See the code
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β βββββββ ββββββββββββ βββββββ ββββββ βββ β
β βββββββββββββββββββββ ββββββββ βββββββββββ β
β ββββββββββββββββββββββββββββββ βββ ββββββ β
β βββββββ ββββββββββββββββββββββ βββ ββββββ β
β βββ βββββββββββ βββ ββββββββββββββββ βββ β
β βββ βββββββββββ βββ βββββββ βββ βββ β
β 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 Β· 90+ commands Β· blazing fast
Install Β· Usage Β· Get Started Β· Use Cases Β· Tutorials Β· Claude Code Β· Architecture Β· Features Β· Compatibility Β· Performance Β· Plugins Β· Keys Β· Scripting Β· Config Β· Mouse/SSH Β· FAQ Β· Related Projects
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
tmuxandpmuxaliases. Just typetmuxand 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/psmux/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/psmux/psmux.git
cd psmux
cargo build --release
Built binaries:
target\release\psmux.exe
target\release\pmux.exe
target\release\tmux.exe
A ready-made Windows container with Rust + MSVC + SSH for building psmux:
cd docker
docker build -t psmux-dev .
docker run -d --name psmux-dev -p 127.0.0.1:2222:22 -e ADMIN_PASSWORD=YourPass123! psmux-dev
ssh ContainerAdministrator@localhost -p 2222
See docker/README.md for full details.
winget install --id Microsoft.PowerShellIf 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, full mouse support, tmux themes, 90+ tmux-compatible commands (run psmux list-commands for the live list), 140+ format variables, 53 vim copy-mode keys. Your existing .tmux.conf works. Full details: docs/features.md Β· docs/compatibility.md
Use psmux, pmux, or tmux. They're identical:
psmux # Start a new session
psmux new-session -s work # Named session
psmux ls # List sessions
psmux attach -t work # Attach to a session
psmux list-commands # List every command psmux accepts
psmux --help # Show help
psmux has first-class support for Claude Code agent teams. When Claude Code runs inside a psmux session, teammate agents automatically spawn in separate tmux panes instead of running in-process.
psmux new-session -s work # Start a psmux session
claude # Run Claude Code, agent teams just work
No extra configuration needed. Full guide: docs/claude-code.md
The full index with one line summaries of every page lives in docs/README.md. AI assistants and crawlers can start from llms.txt.
| Tutorial | What you will learn |
|---|---|
| Getting Started on Windows | Install, first session, prefix key, splits, detach and reattach, first config, Windows Terminal profile |
| Cross Platform tmux Scripts | Write one tmux automation script that runs unchanged on Windows (psmux), Linux and macOS (tmux) |
| Terminal AI Agents and TUIs | Run Claude Code, Codex CLI, Gemini CLI, neovim, lazygit and other TUIs in scripted multi pane layouts |
| Dev Environment Layouts | Multi window and multi pane project sessions, layout presets, bootstrap scripts, save and restore |
| Topic | Description |
|---|---|
| Windows Use Cases | Practical Windows scenarios: startup services, AI agents, dashboards, remote admin |
| Architecture | How psmux multiplexes natively: client/server, one ConPTY per pane, input and output paths, warm pool |
| Features | Full feature list: mouse, copy mode, layouts, format engine |
| Compatibility | tmux command/config compatibility matrix |
| Performance | Benchmarks and optimization details |
| Key Bindings | Default keys and customization |
| Scripting | Commands, hooks, targets, pipe-pane |
| Command Reference | Per-command flag tables |
| Configuration | Config files, options, environment variables |
| Multi-Shell | Running pwsh, cmd, Git Bash, WSL, and nushell side by side |
| Pane Titles | Pane titles, border labels, and why pwsh shows a path |
| Chooser Preview | Live preview pane in choose-tree and choose-session |
| Warm Sessions | The pre-spawned server behind instant session creation |
| Diagnostics | Debug logs, crash logs, state files, what to attach to a bug report |
| Plugins & Themes | Plugin ecosystem: Catppuccin, Dracula, Nord, and more |
| Mouse Over SSH | SSH mouse support and Windows version requirements |
| Control Mode | The -C / -CC wire protocol for IDE and plugin authors |
| iTerm2 Control Mode | Driving psmux from the iTerm2 tmux gateway over SSH |
| Developer Integration | Driving psmux from Python, Node.js, Go, Rust, and libtmux |
| Claude Code | Agent teams integration guide |
| FAQ | Common questions and answers |
|
pstop htop for Windows: real-time system monitor with per-core CPU bars, tree view, 7 color schemes cargo install pstop
|
psnet Real-time TUI network monitor: live speed graphs, connections, traffic log, packet sniffer cargo install psnet
|
|
Tmux Plugin Panel TUI plugin & theme manager for tmux and psmux: browse, install, update from your terminal cargo install tmuxpanel
|
OMP Manager Oh My Posh setup wizard: browse 100+ themes, install fonts, configure shells automatically cargo install omp-manager
|
|
DeskVNC VNC, RDP and SSH client for Windows, macOS and Linux, with an MCP server so AI agents can drive remote desktops github.com/psmux/DeskVNC/releases
|
GodwinMix Live video mixer in Rust: headless core, web UI, desktop app, MCP for agents docker compose up
|
|
TerminalMap OpenStreetMap vector tiles rendered in your terminal, as an app and a Rust library cargo install terminalmap
|
vigil Security dashboard for Linux servers: attack radar, every listening port with its risk, a 0 to 100 security score build from source
|
|
browserglass Stream real Chrome browsers into any web page, drive them from code or AI agents, and hand control to a person at any moment pnpm install && pnpm -r build
|
tmuxtop A top for tmux: every process in every session, with session navigation, export and backup pip install psutil
|
Every project, with live demos: psmux.github.io
MIT
Contributions welcome: bug reports, PRs, docs, and test scripts via GitHub Issues.
Filing a bug? See docs/diagnostics.md for the logs and state files to attach.
If psmux helps your Windows workflow, consider giving it a β on GitHub!
Made with β€οΈ for PowerShell using Rust π¦