explaingit

gpakosz/.tmux

📈 Trending★ 24,913ShellAudience · developerComplexity · 2/5ActiveLicenseSetup · easy

TLDR

A polished, ready-to-use tmux configuration with a styled status bar, smart shortcuts, and terminal multiplexing features, no manual setup required.

Mindmap

mindmap
  root((repo))
    What it does
      Terminal multiplexer config
      Status bar styling
      Keyboard shortcuts
      Pane management
    Key features
      Mouse support toggle
      Pop pane to window
      Clipboard integration
      SSH-aware splitting
    Setup
      Two-file layering
      Update-safe customization
      Unix tools required
    Platforms
      Linux
      macOS
      OpenBSD
      Windows WSL

Things people build with this

USE CASE 1

Set up a professional-looking tmux environment with a styled status bar showing battery, uptime, and hostname in minutes.

USE CASE 2

Split terminal windows into multiple panes and manage them with intuitive keyboard shortcuts without writing custom config.

USE CASE 3

Keep terminal sessions alive across disconnects and reconnect to remote servers automatically with SSH-aware pane splitting.

USE CASE 4

Toggle mouse support, pop panes into full windows, and integrate with clipboard and URL pickers out of the box.

Tech stack

tmuxShellPowerlineawkperl

Getting it running

Difficulty · easy Time to first run · 5min

Powerline fonts may need installation for proper glyph rendering.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice and license text.

In plain English

Oh my tmux! is a ready-to-use configuration package for tmux, a terminal multiplexer, a tool that lets you split one terminal window into multiple panes, run programs in the background, and keep sessions alive even after you disconnect. Instead of spending hours tweaking tmux from scratch, you drop in this configuration and get a polished, Powerline-styled status bar (the decorative bar at the bottom of your terminal showing battery, uptime, hostname, and more), smarter keyboard shortcuts, and a handful of extras out of the box. The setup works by layering two files: a main configuration file you never touch, and a local copy you customize freely. This means you can update the project without losing your personal tweaks. Key features include mouse support toggle, the ability to pop any panel into a full window and back again, clipboard integration, URL picker integration, and SSH-aware pane splitting that reconnects automatically to remote servers. You would reach for this if you live in the terminal and want tmux to look good and behave sensibly without manual configuration work. It runs on Linux, macOS, OpenBSD, and Windows via WSL or Cygwin, and requires only standard Unix tools like awk and perl alongside tmux version 2.6 or newer.

Copy-paste prompts

Prompt 1
How do I install and customize oh my tmux for my terminal workflow?
Prompt 2
Show me how to use the mouse support toggle and pop-pane-to-window feature in this tmux config.
Prompt 3
How do I set up SSH-aware pane splitting so tmux reconnects to remote servers automatically?
Prompt 4
What keyboard shortcuts does this tmux config provide for splitting panes and managing windows?
Prompt 5
How do I update oh my tmux without losing my personal configuration changes?
Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.