AEROSPACE-LAYOUT(1)

📦 version 0.21.3-Beta, in nixpkgs unstable

🎀 aerospace-layout — the glow-up-your-windows manual 🎀

okay bestie, welcome to the AeroSpace manual page for aerospace-layout, aka the moment your windows stop being a mess and start serving. This is from the AeroSpace Manual, section 1, and it's genuinely the most fun you can have rearranging rectangles. iykyk.

✨ NAME ✨

aerospace-layout — change the layout of the focused node to whatever layout you just asked for 💅

🌸 SYNOPSIS 🌸

aerospace layout [-h|--help] [--window-id <window-id>|--workspace <workspace>]
                 [--root] [--fail-if-noop]
                 (<target-layout>)...

look at that. iconic. one command, so many vibes.

🦋 DESCRIPTION 🦋

Change the layout of the focused node to the given layout.

that's it, that's the whole thing. it takes your windows and makes them look intentional. main character energy fr fr 🫶

💖 OPTIONS 💖

  • -h, --help — print help. the classic "what even is this" button ✨
  • --window-id <window-id> — act on the specified window instead of the focused window. heads up bestie: this flag outranks the AEROSPACE_WINDOW_ID and AEROSPACE_WORKSPACE environment variables. it takes precedence, no cap.
  • --workspace <workspace> — act on the specified workspace instead of the focused workspace. same hierarchy rules: this flag takes precedence over the AEROSPACE_WINDOW_ID and AEROSPACE_WORKSPACE environment variables 👑
  • --root — instead of the focused window, change the layout of the workspace tiling root node. 🫶 and like, lowkey important: when you use this flag, tiling and floating become invalid values for <target-layout>. not me warning you before you try it 😭
  • --fail-if-noop — exit with a non-zero exit code if you're already in the requested layout. petty? maybe. useful for scripts? absolutely. and note: when you use this flag, the command permits only one <target-layout> argument. just one. periodt.

🌈 ARGUMENTS 🌈

  • <target-layout> — the layout you're manifesting. possible values:
    • h_tiles | v_tiles | h_accordion | v_accordion — change both tiling layout and orientation in one go. a two-for-one deal, we love efficiency 💅
    • tiles | accordion — change the tiling layout but preserve orientation. respect the orientation, honestly.
    • horizontal | vertical — change the orientation but preserve the layout. vibe shift only 🌸
    • tiling | floating — toggle between floating/tiling mode. the classic switcheroo ✨
if several <target-layout> are supplied, then the first one that doesn't describe the currently active layout is applied. so like, the list is a priority queue and the first non-matching one gets the job. 🎀

🔥 EXAMPLES 🔥

  • toggle between floating and tiling layouts (order of args doesn't matter):
aerospace layout floating tiling
  • toggle orientation (order of args doesn't matter):
aerospace layout horizontal vertical
  • toggle between tiles and accordion layouts (order of args doesn't matter):
aerospace layout tiles accordion
  • switch to tiles layout. toggle the layout orientation if already in tiles layout:
aerospace layout tiles horizontal vertical

see how the order literally doesn't matter in the first three? ate. 🔥

💜 RESOURCES 💜

go read the guide, it's giving lore. 📚

💀 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

so like, discussion first, then the official issue once it's confirmed. no skipping the queue bestie 🙈

🧚 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 🫶

and that's the whole page, bestie — no crumbs left. this one's AeroSpace, dated 2026-07-16, from the AEROSPACE-LAYOUT(1) section of the manual. go forth and rearrange your windows, you're gonna slay 💖✨🎀

📦 where this page comes from