Skip to content

llk214/minimux

Repository files navigation

minimux

Minimal terminal session persistence for Windows. Like dtach but native Windows — no WSL, no Cygwin, no MSYS2.

Start a shell session, detach from it, close the window, and reattach later. Your shell and all running processes keep going in the background.

Usage

mm              # Start a new session or attach to an existing one
mm status       # Show session status
mm kill         # Kill the running session

Keybindings (tmux-style):

  • Ctrl+B d — detach from session (session keeps running — reattach anytime with mm)
  • Ctrl+B Ctrl+B — send literal Ctrl+B to the shell

Options

mm --shell cmd          # Use a specific shell (default: auto-detects pwsh > powershell > cmd)
mm --scrollback 5000    # Set scrollback buffer size in lines (default: 1000)

How it works

mm runs a background daemon that holds a ConPTY session. The client connects to the daemon via a Windows named pipe, relays keyboard input, and displays terminal output. On reattach, scrollback history is replayed so you can see what happened while detached.

Known limitations

  • Window resize garbles scrollback. minimux relays raw PTY output to your terminal. When you resize the window, the terminal reflows its buffer and ConPTY sends reflow sequences — the two conflict, producing duplicated/garbled content in scrollback history. The visible screen recovers after the shell redraws, but scrollback history will be messy. If you use a fixed-size terminal (e.g. SSH from a phone/tablet), this is a non-issue.

Requirements

  • Windows 10 (1809+) or Windows 11
  • x86_64

Building from source

cargo build --release --target x86_64-pc-windows-msvc

The binary is at target/x86_64-pc-windows-msvc/release/mm.exe. Copy it anywhere or add it to your PATH.

License

MIT

About

Lightweight, native Windows terminal session persistence. Like tmux sessions, but without the multiplexer.

Topics

Resources

License

Stars

1 star

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages