Home|About|Gaming cabinet|Archives|How it works|Starter sites

GeezerVison is showing tmuxp.git-pull.com — tmuxp

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.

CLI Reference

Every command, flag, and option.

Configuration

Config format, examples, and environment variables.

Workspace files

Topics

Workflows, plugins, and troubleshooting.

Contributing

Internals, development setup, and release process.

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

_images/tmuxp-demo.gif