AEROSPACE-DEBUG-WINDOWS(1)

📦 version 0.21.3-Beta, in nixpkgs unstable

💅 AEROSPACE-DEBUG-WINDOWS 💅

okay bestie, so this one lives in the AeroSpace Manual (yes, that's the manual name, we're being official about it ✨), and it's basically the ✨ receipts-collector ✨ for when AeroSpace does something feral with your windows and you need to snitch to the devs. 🫶

✨ NAME ✨

aerospace-debug-windows — an interactive command that records Accessibility API debug info so you can build bug reports 🐛💖

✨ SYNOPSIS ✨

aerospace debug-windows [-h|--help] [--window-id <window-id>]

🌸 DESCRIPTION 🌸

It's an interactive command, bestie. It records Accessibility API debug information so you can create bug reports. That's literally the whole job. 🔥

Take the output of this command and use it to report bugs about incorrect window handling — like, say, some windows get floated when they absolutely should not be floated 😭 (rude of them honestly).

The intended usage goes like this, follow along:

  1. Run the command to start the debug session recording 🎀
  2. Focus the problematic window, or make the window appear 👑
  3. Run the command one more time to stop the debug session recording and print the results ⭐
⚠️ heads up: debug-windows is not stable API. Please don't rely on the command existing, and don't rely on the output format either — it can change on you, no cap. The one and only intended use case is reporting bugs about incorrect windows handling. That's it, that's the vibe check. 💀

💅 OPTIONS 💅

  • -h, --help — prints help, the classic 🫶
  • --window-id <window-id> — prints debug information of the specified window right away. Using this flag disables interactive mode entirely — so it's giving one-and-done main character energy instead of the run-it-twice ritual. ✨

🌈 RESOURCES 🌈

🦋 BUGS 🦋

Found something cursed? Report bugs to https://github.com/nikitabobko/AeroSpace/discussions/categories/potential-bugs 🙈

The maintainers will then move verified bugs over to https://github.com/nikitabobko/AeroSpace/issues — so the real ones get their moment. 💜

🎀 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 the AeroSpace license and its dependencies in the 'legal' directory of the distributed zip archive. 📁

🌟 AUTHOR 🌟

Nikita Bobko and contributors 👑

and that's the whole page, bestie — this beauty came from AeroSpace, dated 2026-07-16, manual page AEROSPACE-DEBUG-WINDOWS(1). iykyk 💅💖

📦 where this page comes from