otty / apps
All apps/tmuxp

tmuxp

tmuxp

Session manager for tmux: save and load your tmux sessions through declarative workspace files.

Runs as tmuxp|macOS, Linux|tmuxp.git-pull.com
Open form in Otty otty.toml

Command form

ai-draft · 2 tasks · 7 fields

Load one or more tmuxp workspace files (or project folders) as tmux sessions. Socket, config file, color and progress options are left out.

Opens the form; the finished command lands at your prompt, unrun
Run in Otty
otty gui tmuxp

tmuxp load

Load a workspace
Load a workspaceExample values, fixed in this page — nothing here reaches a terminal
Basic
Workspace file or project*
any
TasksEach one presets the form for one job
Load and attach
workspace
Load in the background
workspacedetach
ParametersOnly these flags are editable in the form
Workspace file or project
A workspace file, a folder holding .tmuxp.yaml, or a name in the tmuxp workspace directory.
path · positional 0 · repeatable
New session name
string
-s
Do not attach
boolean
-d
Append to current session
boolean
--append-a
Answer yes to prompts
boolean
--yes-y
Log file
path
--log-file
No progress spinner
boolean
--no-progress
SourcesEvery flag above is checked against these
help
usage: tmuxp load [-h] [-L socket_name] [-S socket_path] [-f tmux_config_file] [-s new_session_name] [--yes] [-d] [-a] [-2 | -8] [--log-file file_path] [--progress-format FORMAT] [--progress-lines N] [--no-progress] workspace-file [workspace-file ...] -s new_session_name start new sessio…
help2026-10-27

tmuxp.git-pull.com

help
usage: tmuxp load [-h] [-L socket_name] [-S socket_path] [-f tmux_config_file] [-s new_session_name] [--yes] [-d] [-a] [-2 | -8] [--log-file file_path] [--progress-format FORMAT] [--progress-lines N] [--no-progress] workspace-file [workspace-file ...] -s new_session_name start new sessio…
help2026-10-27

tmuxp.git-pull.com

Before it fills your prompt, Otty checks the installed tmuxp against its version. A form that does not match your version is not offered.