AEROSPACE-JOIN-WITH(1)

📦 version 0.21.3-Beta, in nixpkgs unstable

💫 AEROSPACE-JOIN-WITH(1) 💫

okay bestie, welcome to the AeroSpace Manual — this page is aerospace-join-with, and it's genuinely one of my faves, no cap 🫶

🌸 NAME 🌸

aerospace-join-with — takes the focused window and the nearest node in whatever direction you point at, and puts them both under a common parent container. it's giving "you two are siblings now", periodt 💅

✨ SYNOPSIS ✨

aerospace join-with [-h|--help] [--window-id <window-id>] (left|down|up|right)

🦋 DESCRIPTION 🦋

Put the focused window and the nearest node in the specified direction under a common parent container.

that's it, that's the whole vibe. literally the same thing as the NAME said, but now you're read in 😌

🎀 EXAMPLES 🎀

okay so picture this layout, right:

h_tiles
├── window 1
├── window 2 (focused)
└── window 3

now you hit join-with right, and boom — the layout becomes:

h_tiles
├── window 1
└── v_tiles
    ├── window 2 (focused)
    └── window 3

look at that glow-up 😭 window 2 and window 3 are now under a v_tiles umbrella together. iconic.

Note 🙈 join-with is a high-level replacement for i3's split command <https://i3wm.org/docs/userguide.html#_splitting_containers>. There's this observation that the only reason you might ever want to split a node is to put several windows under a common "umbrella" parent. And unlike split, join-with can be used with enable-normalization-flatten-containers. so yeah — it plays nice, unlike some people 💀

💖 OPTIONS 💖

  • -h, --help — Print help. that's her job and she does it flawlessly ✨
  • --window-id <window-id> — Act on the specified window instead of the focused window. The flag takes precedence over the AEROSPACE_WINDOW_ID and AEROSPACE_WORKSPACE environment variables. yes queen, she overrides, that's the hierarchy 👑

🌈 RESOURCES 🌈

go read the guide bestie, it's lowkey a whole education 📚

💀 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>

fr fr if something's acting up, log it — don't just suffer in silence 😭

👑 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.

MIT ate that 💅 legalize it, or whatever

⭐ AUTHOR ⭐

Nikita Bobko and contributors 🫶

okay that's the whole page, you're officially educated 💖✨🎀🦋

sign-off time, bestie: this is from the AeroSpace manual, dated 2026-07-16 — screenshot it, frame it, whatever, go join some windows 🍓🧚💜

📦 where this page comes from