AEROSPACE-WORKSPACE(1)

📦 version 0.21.3-Beta, in nixpkgs unstable

💅 AEROSPACE-WORKSPACE(1) 💅

okay so this is a page from the AeroSpace Manual bestie, and it's literally all about aerospace-workspace — the command that focuses the workspace you want. no cap, that's the whole vibe. let's get into it 🫶

✨ NAME ✨

aerospace-workspace — focus the specified workspace 👑

🌸 SYNOPSIS 🌸

aerospace workspace [-h|--help] [--auto-back-and-forth] [--fail-if-noop] [--] <workspace-name>
aerospace workspace [-h|--help] [--wrap-around] [--stdin|--no-stdin] (next|prev)

🦋 DESCRIPTION 🦋

1. <workspace-name> syntax

Focus the specified workspace. that's it. that's the move 💖

2. (next|prev) syntax

Focuses next or prev workspace in the list.

  • If --stdin is specified, then the list is taken from stdin 📥
  • Otherwise, the list is defined as all workspaces (even empty ones) on the focused monitor in alphabetical order 🔤

🎀 OPTIONS 🎀

  • -h, --help — print help. iconic. always there for u 🫶
  • --wrap-around — makes it possible to jump between the first and last workspaces using (next|prev) 🎠
  • --auto-back-and-forth — automatic back-and-forth when switching to an already focused workspace. highkey convenient. incompatible with --fail-if-noop 🚫
  • --fail-if-noop — exit with a non-zero exit code if you switch to the already focused workspace. incompatible with --auto-back-and-forth 💀
  • --stdin — read the list of workspaces from stdin. incompatible with --no-stdin 📥
  • --no-stdin — ignore the list of workspaces from stdin, even if it's provided. incompatible with --stdin 🙈

💜 ARGUMENTS 💜

  • <workspace-name> — workspace name to focus. pick one, any one ✨

🔥 EXAMPLES 🔥

  • Go to the next non empty workspace on the focused monitor:
aerospace list-workspaces --monitor focused --empty no | aerospace workspace --stdin next

she ate that 🍓

🌈 RESOURCES 🌈

⭐ BUGS ⭐

Bugs can be reported to https://github.com/nikitabobko/AeroSpace/discussions/categories/potential-bugs

Maintainers will move verified bugs to https://github.com/nikitabobko/AeroSpace/issues 🐛➡️📋

👑 LICENSE 👑

Copyright © 2023 Nikita Bobko

Free use of this software is granted under the terms of the MIT License.

You can find the full text of AeroSpace license and its dependencies in the legal directory of the distributed zip archive. 📁

🧚 AUTHOR 🧚

Nikita Bobko and contributors 💖

okay that's the whole page bestie, go focus some workspaces and slay 💅✨

AeroSpace · 2026-07-16 · AEROSPACE-WORKSPACE(1) — mwah, see u in the next manpage 🎀
📦 where this page comes from