tmuxp

Session manager for tmux. Load, freeze, and convert tmux sessions through YAML/JSON configuration files. Powered by libtmux.

Quickstart

Install and run your first command.

Quickstart

CLI Reference

Every command, flag, and option.

CLI Reference

Configuration

Config format, examples, and environment variables.

Workspace files

Topics

Workflows, plugins, and troubleshooting.

Topics

Contributing

Internals, development setup, and release process.

Project

Install

$ pip install tmuxp

$ uv tool install tmuxp

$ brew install tmuxp

See Quickstart for all installation methods and first steps.

Load a workspace

session_name: my-project
windows:
  - window_name: editor
    panes:
      - shell_command:
          - vim
      - shell_command:
          - git status

$ tmuxp load my-project.yaml