AEROSPACE-SWAP(1)

📦 version 0.21.3-Beta, in nixpkgs unstable

💅 AEROSPACE-SWAP(1) — the AeroSpace manual, bestie edition 🦋

okay so real talk, this is aerospace-swap from the AeroSpace manual and it's literally about swapping your focused window with another window ✨ no cap, that's the whole vibe.

🌸 NAME 🌸

aerospace-swap — swaps the focused window with another window 🫶

⭐ SYNOPSIS ⭐

aerospace swap [-h|--help] [--window-id <window-id>] [--swap-focus]
               [--wrap-around] (left|down|up|right|dfs-next|dfs-prev)

like, that's the whole shape of it. flags first, direction last, periodt 👑

💖 DESCRIPTION 💖

Swaps the focused window with another window. that's it, that's the girl 💅

the operation is equivalent to dragging a window with the mouse — so if you've ever yeeted a window across the screen with your cursor and thought "wow this is iconic but also my wrist hurts", yeah, this command is that, but fancy ✨

🎀 OPTIONS 🎀

  • -h, --help — print help. the classic "wait what does this do again" button 🫶
  • --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 you're setting those env vars and also passing this flag, the flag wins, sorry not sorry 💅
  • --swap-focus — swap focus away from the currently focused window. because by default, this command does not change the focused window. so the focus stays put unless you explicitly ask for it to move, iykyk 🌸
  • --wrap-around — wrap around if the window is at the edge of the workspace (for (left|down|up|right)) or the start/end of the depth first order (for (dfs-next|dfs-prev)). so instead of hitting a wall and giving up, it loops back around like a main character who refuses to be stopped 🔥

🦋 ARGUMENTS 🦋

  • (left|down|up|right) — swaps the focused window with the nearest window in the given direction. simple, clean, directional slay ⬅️⬇️⬆️➡️
  • (dfs-next|dfs-prev) — swaps the focused window with the next or previous window in the depth-first order (top-to-bottom and left-to-right) of windows in the current workspace tree. yes bestie, there's a whole tree, and this walks it in order, no cap 🌈

🧚 RESOURCES 🧚

go read the guide, it's giving "useful" and honestly obsessed 💜

💀 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, drop it in discussions first, they'll graduate it to issues when it's confirmed fr fr 🙈

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

like, it's MIT, it's free, go wild, but the receipts live in 'legal' 💖

🌟 AUTHOR 🌟

Nikita Bobko and contributors — the icons, the moment, the legends ⭐

ngl, if you're at the edge of a workspace and nothing's happening, that's not a bug, that's --wrap-around not being passed. vibe check your flags first 🫶

AeroSpace · 2026-07-16 · that's the date stamp bestie, and this was AEROSPACE-SWAP(1), k bye, go swap some windows 💅✨🎀

📦 where this page comes from