Exit codes and errors

tmuxp 1.74.0 · Source

tmuxp generally uses 0 for success, 1 for operation failures and 2 for argument errors. Some commands have exceptions at this documented revision.

Exceptions to check¶

• $edit does not propagate the editor child’s status.
• Machine $search can return normally with no output for an invalid pattern; a missing query can show human help.
• A missing import source exits with status 2.
• A missing or unsupported tmux executable can print a diagnostic and return status 0 before argument parsing.
• $freeze can catch a missing-session error, print it and return normally.

Read both the command’s output and reference page before using its status as the only success check.

Command source.