AEROSPACE-SPLIT(1)

📦 version 0.21.3-Beta, in nixpkgs unstable

🦋 aerospace-split(1) — the AeroSpace manual, bestie edition 🦋

okay so this is aerospace-split, and yes it lives in the AeroSpace manual. buckle up, because she's a weird one (affectionate) 💅

✨ NAME ✨

aerospace-split — split the focused window, bestie. that's the whole job 🎀

🌸 SYNOPSIS 🌸

aerospace split [-h|--help] [--window-id <window-id>] (horizontal|vertical|opposite)

💖 DESCRIPTION 💖

okay so real talk: the split command exists solely for compatibility with i3. that's it. that's her whole personality 😭 so unless you're a hardcore i3 user who genuinely knows what they're doing, it's recommended to use join-with instead. no cap 🫶

here's the vibe: if the parent of the focused window contains more than one child, then the command does these three things, in order:

  1. Creates a new tiling container ✨
  2. Replaces the focused window with the container
  3. Puts the focused window into the container as its only child

and what does the argument do? it configures the orientation of that newly created container, duh 💅 and opposite means... opposite orientation compared to the parent container. iconic, honestly.

but wait — there's a second scenario 👀 if the parent of the focused window contains only a single child (the window itself), then the split command changes the orientation of the parent container instead. main character energy fr fr.

Important ⚠️ split command has no effect if enable-normalization-flatten-containers is turned on. like, zero. nada. 💀 Consider using join-with if you want to keep enable-normalization-flatten-containers enabled. you've been warned, bestie.

🎀 OPTIONS 🎀

  • -h, --help — prints help. that's it, that's the whole flag 🌈
  • --window-id <window-id> — act on the specified window instead of the focused window. and listen: this flag takes precedence over the AEROSPACE_WINDOW_ID and AEROSPACE_WORKSPACE environment variables. so if they're beefing, the flag wins, periodt 👑

🔥 RESOURCES 🔥

go read the guide, it's giving helpful 🧚

💀 BUGS 💀

found a bug? bestie, please report it here:

https://github.com/nikitabobko/AeroSpace/discussions/categories/potential-bugs

and then — the maintainers will move verified bugs over to:

https://github.com/nikitabobko/AeroSpace/issues

so like, don't panic if your bug gets relocated, that's just the pipeline 😌

👑 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. slay, legally speaking 🍓

🌈 AUTHOR 🌈

Nikita Bobko and contributors. absolute icons, every single one of them 💜

and that's the whole page!! thanks for coming to my ted talk 🦋

— signed off with love by the AeroSpace manual, dated 2026-07-16, page AEROSPACE-SPLIT(1) 🎀✨

📦 where this page comes from