Skip to content

Latest commit

 

History

History
55 lines (34 loc) · 1.37 KB

README.md

File metadata and controls

55 lines (34 loc) · 1.37 KB

Tool for Integrating PowerShell and tmux on Windows

This setup script enables you to use tmux keybindings for pane operations in a Windows environment. By running tmux from WSL (Windows Subsystem for Linux), you can control PowerShell using tmux, providing a consistent terminal experience across Windows and macOS.

Features

  • Installs Alpine Linux on WSL and runs tmux within it
  • Launches the host PowerShell inside tmux, allowing for pane splitting and keybinding operations
  • Shares tmux configuration files between macOS and Windows for a unified setup

Limitations

  • No session persistence
    • Sessions reset when the terminal is closed or the system is restarted
    • Attaching to an existing PowerShell session may cause it to become unresponsive

Installation

Run the following command to install:

powershell -ExecutionPolicy Bypass -c "iwr https://raw.githubusercontent.com/ymat19/PoshOnTmux/main/install.ps1 -UseBasicParsing | iex"

Usage

After installation, start tmux and PowerShell with:

wsl -d PoshOnTmux

Configuration Files

Configuration files are located at:

\\wsl$\PoshOnTmux\home\tmux\.tmux.conf

Uninstallation

To uninstall, run:

wsl --unregister -d PoshOnTmux

Reference

License

MIT License