Skip to content

workspace

Change the name of a workspace or change focus to a specific workspace.

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>

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"