tmuxtmuxOptions, hooks and formats

Choose documentation 1

3.7c

tmux catalog version

Latest (3.7c) 3.7c 3.2a
English

option tmux3.7c

command-alias

This is an array of custom aliases for commands.

Scope
server
Type
Text, array of values
Default
Show the default
split-pane=split-window,splitp=split-window,server-info=show-messages -JT,info=show-messages -JT,choose-window=choose-tree -w,choose-session=choose-tree -s
Separator
,
Set
set-option -s command-alias value
Read
show-options -s command-alias

Description#

This is an array of custom aliases for commands. If an unknown command matches name, it is replaced with value. For example, after:
set -s command-alias[100] zoom='resize-pane -Z'

Using:

zoom -t:.1

Is equivalent to:

resize-pane -Z -t:.1

Note that aliases are expanded when a command is parsed rather than when it is executed, so binding an alias with bind-key will bind the expanded form.

Releases#

Source#

Defined in
options-table.c:297
C source reference
options_table
CLI Manual
Original manual entry

Used by#

Library documentation that names this option.

Python
libtmux_mcp.tools.option_tools.set_option, libtmux._internal.sparse_array.SparseArray
Rust
options.generated.COMMAND_ALIAS, server.Server.array_option, server.Server.options, session.Session.options, window.Window.options
Go
tmux.CommandAlias, tmux.CommandAliases, tmux.Server.SetCommandAlias, tmux.ServerOptionValues.CommandAlias, tmux.ServerOptionValues.CommandAliases
Java
io.github.libtmux.Options
Esc

Type to search.

Reference preview Open reference