tmuxp load

Load tmux sessions from workspace configs.

tmuxp load

tmuxp shell

Interactive Python shell with tmux context.

tmuxp shell

tmuxp freeze

Export running sessions to config files.

tmuxp freeze

tmuxp convert

Convert between YAML and JSON formats.

tmuxp convert

Exit Codes

Exit codes for scripting and automation.

Exit Codes

Recipes

Copy-pasteable command invocations.

Recipes

Main command

The tmuxp command is the entry point for all tmuxp operations. Use subcommands to load sessions, manage configurations, and interact with tmux.

Command

tmuxp - tmux session manager.

Manage and launch tmux sessions from YAML/JSON workspace files.

Usage

usage: tmuxp [-h] [--version] [--log-level log-level]
             [--color {auto,always,never}]
             {load,shell,import,convert,debug-info,ls,search,edit,freeze} ...

Load Examples

$ tmuxp load ./workspace.yaml

$ tmuxp load -d myproject

$ tmuxp load -y dev staging

Freeze Examples

$ tmuxp freeze mysession -o session.yaml

Ls Examples

Search Examples

$ tmuxp search name:myproject

$ tmuxp search --json dev

Shell Examples

$ tmuxp shell -L mysocket

$ tmuxp shell -c 'print(server.sessions)'

Convert Examples

$ tmuxp convert workspace.yaml

$ tmuxp convert workspace.json

Import Examples

$ tmuxp import teamocil ~/.teamocil/project.yml

$ tmuxp import tmuxinator ~/.tmuxinator/project.yml

Edit Examples

Debug-Info Examples

$ tmuxp debug-info --json

Options

--version, -V

show program's version number and exit

--log-level log-level

log level (debug, info, warning, error, critical) (default "warning")

Default
warning

Choices
debug, info, warning, error, critical

--color

when to use colors: auto (default), always, or never

Default
auto

Choices
auto, always, never