tpane

tpane lets you write tmux configuration in Lua. It comes with plugins, themes, status bar widgets, and helpers for key bindings, panes, windows, and common tmux settings.

The docs in this site match the current main branch. For release notes and version history, see the changelog.

Demo

Start here

• Quick start: install tpane and create your first Lua config.
• Install: install script, cargo, mise, and source install.
• Configuration: config files, options, key bindings, and raw tmux commands.
• Migrating from tmux.conf and TPM: adopt tpane gradually and roll back safely.
• Status bar: widgets, jobs, rows, and window tabs.
• Plugins: built-in plugins and git plugins.
• Reusable panes: panes you can toggle without stopping their process.
• Pane detection: recognize panes by command, directory, output, or process tree.
• Lua API reference: Lua API reference.
• Changelog: release notes and version history.

If you already have tpane installed, tpane status shows config errors and tpane reload reloads your Lua config from inside tmux.