AEROSPACE-MOVE-WORKSPACE-TO-MONITOR(1)

📦 version 0.21.3-Beta, in nixpkgs unstable

💅 aerospace-move-workspace-to-monitor

okay so bestie, welcome to the AeroSpace Manual page for aerospace-move-workspace-to-monitor — literally the glow-up your workspaces deserve. this one yeets a workspace onto a different monitor, and you get to pick how it picks the monitor: by relative direction, by order, or by pattern. slay. 🦋

✨ NAME ✨

aerospace-move-workspace-to-monitor — move a workspace to a monitor, chosen by relative direction, by order, or by pattern. no cap, that's the whole vibe. 💫

🌸 SYNOPSIS 🌸

aerospace move-workspace-to-monitor [-h|--help] [--workspace <workspace>] [--wrap-around] (left|down|up|right)
aerospace move-workspace-to-monitor [-h|--help] [--workspace <workspace>] [--wrap-around] (next|prev)
aerospace move-workspace-to-monitor [-h|--help] [--workspace <workspace>] [--] <monitor-pattern>...

three whole modes, three whole lines, all iconic 👑

🎀 DESCRIPTION 🎀

Move that workspace to a monitor — picked by relative direction, by order, or by pattern. take your pick, main character.

and here's the cute part: focus follows the focused workspace, so the workspace stays focused after the move. it doesn't get abandoned mid-glow-up, iykyk. 🫶

lowkey important 💀 — the command fails for workspaces that have monitor force assignment. like, force-assigned workspaces said "i'm taken" and this command respects that. no drama.

🌈 OPTIONS 🌈

  • -h, --help — print help. that's it. that's the whole option. we love a simple queen. ✨
  • --wrap-around — allows you to move the workspace between the first and last monitors. so when you hit the edge, you don't just stop — you loop around like a little carousel. 🎠
  • --workspace <workspace> — act on the specified workspace instead of the focused workspace. this flag takes precedence over the AEROSPACE_WINDOW_ID and AEROSPACE_WORKSPACE environment variables. so if you set all three, this one wins, periodt. 👑

🦋 ARGUMENTS 🦋

  • (left|down|up|right) — move the workspace to the monitor in that direction, relative to the focused monitor. left is left, down is down, you got this. ⬅️⬇️⬆️➡️
  • (next|prev) — move the workspace to the next or prev monitor. and ngl, the important detail: the next or prev monitor is calculated relative to the monitor that <workspace> currently belongs to. so it's about where the workspace is, not where your cursor is. 🧠✨
  • <monitor-pattern> — find the first matching monitor and move the workspace there. multiple monitor patterns is useful for different monitor configurations, so you can stack them up. monitor patterns follow the same format as in the workspace-to-monitor-force-assignment config option. 👀
also there's a -- you can drop in before the <monitor-pattern>... list (it's right there in the synopsis) 🎀

💖 RESOURCES 💖

go read the guide bestie, it's giving study material 📚🌸

💀 BUGS 💀

found a bug? first of all, rude, but okay — report it at:

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

maintainers will move verified bugs to:

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

so the discussions category is the waiting room, basically. 🙈

👑 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. it's all in there, fr fr.

⭐ AUTHOR ⭐

Nikita Bobko and contributors 🫶

that's the whole page, bestie — every flag, every argument, every link, untouched, just with better vibes. slay 💅✨

AeroSpace — 2026-07-16 — you just read AEROSPACE-MO...CE-TO-MONITOR(1), mwah, go move some workspaces 🎀

📦 where this page comes from