AEROSPACE-SUBSCRIBE(1)

📦 version 0.21.3-Beta, in nixpkgs unstable

💅 AEROSPACE-SUBSCRIBE(1) 💅

okay so this is the aerospace-subscribe page, straight out of the AeroSpace Manual — yes that AeroSpace, the tiling window manager bestie 💖

✨ NAME ✨

aerospace-subscribe — subscribe to AeroSpace events and get notifications slid right into your socket, like a little group chat but for your windows 🫶

✨ SYNOPSIS ✨

aerospace subscribe [-h|--help] [--all] [--no-send-initial] [<event>...]

✨ DESCRIPTION ✨

Subscribe to AeroSpace events and receive notifications via socket. That's the whole vibe 👑

This command connects to the AeroSpace server and receives real-time event notifications as JSON lines. The connection stays open until you terminate it (like, <kbd>Ctrl</kbd>+<kbd>C</kbd>, the classic escape hatch 😭). It literally just sits there, streaming, serving, being the main character.

On connect, the current state gets sent immediately — no waiting, no "let me think about it" energy. That means focus-changed with the current window/workspace, mode-changed with the current mode, etc. Instant slay on arrival ✨

✨ OPTIONS ✨

  • -h, --help — print help. the "what does this even do" button 🎀
  • --all — subscribe to all event types. yes, all of them. greedy queen behavior, we love her 💅
  • --no-send-initial — do not send the initial state on connect. you want the stream without the little welcome gift, iconic honestly

✨ ARGUMENTS ✨

here's the menu of events you can subscribe to, pick your faves 🍓

  • focus-changed — fired when window focus changes. includes windowId, workspace.
  • focused-monitor-changed — fired when the focused monitor changes. includes workspace, monitorId.
  • focused-workspace-changed — fired when the focused workspace changes. includes workspace, prevWorkspace.
  • mode-changed — fired when the binding mode changes. includes mode.
  • window-detected — fired when a new window is detected. includes windowId, workspace, appBundleId, appName. new window just dropped 🔥
  • binding-triggered — fired when a keyboard binding is triggered. includes binding, mode.

✨ OUTPUT FORMAT ✨

Events come out as JSON lines — one JSON object per line, no cap 🧚

{"_event":"focused-monitor-changed","monitorId":1,"workspace":"M"}
{"_event":"focused-workspace-changed","prevWorkspace":"M","workspace":"M"}
{"_event":"mode-changed","mode":"main"}
{"_event":"focus-changed","windowId":28218,"workspace":"M"}

✨ RESOURCES ✨

go read the guide bestie, it's giving ✨knowledge✨

✨ 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 broken, tell them — but in the discussions first, that's the whole flow 🙈

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

(legal directory core 🎀 always check the legal directory)

✨ AUTHOR ✨

Nikita Bobko and contributors — shoutout to the whole squad 👑

AeroSpace · 2026-07-16 · AEROSPACE-SUBSCRIBE(1)

and that's the page!! go subscribe to some events, stream that JSON, be the main character of your own window manager 💜🦋

📦 where this page comes from