workspace

Change the name of a workspace, change focus to a specific workspace, or change how a workspace places new windows.

Syntax

# Sets the name on the workspace to <name>.
workspace <name>

# Set the number on the workspace and optionally the name.
workspace <num>: [<name>]

# `workspace next` focuses the numerically greater workspace after the currently
# focused one. `workspace prev` focuses in the opposite direction.
# `workspace next_on_output` and `workspace prev_on_output` does the same thing
# as the previous two commands, but instead the focus list is confined to those
# on the focused output.
workspace next|prev|next_on_output|prev_on_output

# `workspace back_and_forth` focuses the previously focused workspace.
workspace back_and_forth

# `workspace [--no-auto-back-and-forth] <name>` focuses a workspace by name.
workspace [--no-auto-back-and-forth] <name>

# `workspace [--no-auto-back-and-forth] number <name>` focuses a workspace by name
# and number.
workspace [--no-auto-back-and-forth] number <name>

# Sets the window placement policy of a workspace. Windows that are opened on a
# `tile` workspace are added to the tiling grid, while windows opened on a
# `float` workspace are floated over it. Windows that are already open are left
# where they are.
#
# If <num> or <name> is provided, the policy is applied to that workspace,
# otherwise it is applied to the currently focused workspace. The target may
# also be given in the `<num>: <name>` form, in which case it must be quoted.
workspace [<num>|<name>] policy float|tile

Example

miraclemsg workspace hello # Change the name of the current workspace to 'hello'
miraclemsg workspace 1     # Focus workspace 1
miraclemsg workspace next  # Focus workspace after 1 (e.g. if workspace 3 exists, 3 would be focused)
miraclemsg workspace hi    # Focus non-numeric workspace named "hi"

miraclemsg workspace policy float      # New windows on the current workspace will float
miraclemsg workspace 2 policy float    # New windows on workspace 2 will float
miraclemsg workspace hi policy tile    # New windows on the workspace named "hi" will tile
miraclemsg workspace "2: web" policy float # Target a workspace by number and name