AEROSPACE-RUN-CALLBACK(1)

📦 version 0.21.3-Beta, in nixpkgs unstable

💅 AEROSPACE-RUN-CALLBACK(1) — the AeroSpace Manual era 🦋

okay so bestie, this is aerospace-run-callback from the AeroSpace manual, and honestly? it's giving "let me press the button myself" energy. it runs your AeroSpace config callbacks on demand. periodt ✨

🎀 NAME

aerospace-run-callback — run AeroSpace config callbacks on demand 🫶

✨ SYNOPSIS

aerospace run-callback [-h|--help] [--for-every-window|--window-id <window-id>] on-window-detected
aerospace run-callback [-h|--help] (on-focus-changed|on-focused-monitor-changed)

like, that's literally the whole shape of it. two forms, pick your fighter 🌸

💖 DESCRIPTION

Run AeroSpace config callbacks on demand 💅

so normally AeroSpace fires these callbacks all by itself when events happen. this command is your little rewind button 🔥 — you get to manually re-run the callbacks:

  • on-window-detected — the callbacks defined by the on-window-detected config option. by default they only run for the focused window, ngl. pass --for-every-window if you want the callbacks to hit every currently known window — truly iconic right after reload-config, so your new rules retroactively apply to windows that were already open 🪟✨ — or pass --window-id to target one specific window.
  • on-focus-changed — runs the commands listed under the on-focus-changed config key. simple. slay. 💜
  • on-focused-monitor-changed — runs the commands listed under the on-focused-monitor-changed config key. monitor main character energy 👑

and here's the cute part: the command forwards stdout and stderr of all commands run in the callback 😭💖 which opens up one more usecase — you can literally use this command to see the output of your callbacks. debugging but make it a vibe check 🔍

🌈 OPTIONS

  • -h, --help — print help. classic. we love a helpful queen 🎀
  • --for-every-window — run on-window-detected callbacks for every window. only valid with on-window-detected, and it's mutually exclusive with --window-id 🚫 — you can't have both, bestie, pick one.
  • --window-id <window-id> — act on the specified window instead of the focused window. this flag takes precedence over the AEROSPACE_WINDOW_ID and AEROSPACE_WORKSPACE environment variables 👑 (yes, it wins, no cap).

only valid with on-window-detected. mutually exclusive with --for-every-window. again: one or the other 🫶

🦋 ARGUMENTS

  • <callback> — one of: on-window-detected, on-focus-changed, on-focused-monitor-changed

literally just type one of those three. that's it. that's the argument 💅

💀 EXIT CODES

the command forwards the exit code of the callback. whatever the callback did, that's what you get back — no filter, fr fr 📤

🌟 RESOURCES

go read the guide, i'm begging 🧚

🙈 BUGS

found a bug? report it to https://github.com/nikitabobko/AeroSpace/discussions/categories/potential-bugs 🐛

the maintainers will move verified bugs to https://github.com/nikitabobko/AeroSpace/issues — so it's like a whole glow-up pipeline for your bug report ✨

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

🍓 AUTHOR

Nikita Bobko and contributors 🫶

and that's the whole page, bestie — AeroSpace manual, dated 2026-07-16, brought to you with love (and zero chill) 💅🎀🦋

📦 where this page comes from