Terminal Multiplexer for Windows

Features

Configuration

psmux reads its configuration on startup from the first file found (in order):

1. ~/.psmux.conf
2. ~/.psmuxrc
3. ~/.tmux.conf
4. ~/.config/psmux/psmux.conf

The configuration syntax is tmux-compatible, meaning most of your existing .tmux.conf lines will work as-is.

Basic Config Example

Create a file at ~/.psmux.conf:

# Change prefix key to Ctrl+a
set -g prefix C-a

# Enable mouse support
set -g mouse on

# Window numbering starts at 1
set -g base-index 1

# Customize status bar
set -g status-left "[#S] "
set -g status-right "%H:%M %d-%b-%y"
set -g status-style "bg=green,fg=black"

# Cursor style
set -g cursor-style bar
set -g cursor-blink on

# Increase scrollback history
set -g history-limit 5000

# Key bindings
bind-key -T prefix h split-window -h
bind-key -T prefix v split-window -v

Choosing a Default Shell

psmux launches PowerShell 7 (pwsh) by default, but you can change this:

# Use cmd.exe
set -g default-shell cmd

# Use PowerShell 5
set -g default-shell powershell

# Use Git Bash
set -g default-shell "C:/Program Files/Git/bin/bash.exe"

# Use WSL
set -g default-shell wsl

Neovim Rendering Workaround

If Neovim looks slow or shows artifacts, disable prediction dimming:

set -g prediction-dimming off

FAQ