AEROSPACE-CONFIG(1)

📦 version 0.21.3-Beta, in nixpkgs unstable

💅 AEROSPACE-CONFIG(1) — the AeroSpace manual, bestie edition 🎀

okay so this is a page from the AeroSpace Manual (yes, that manual 💖), and it's all about querying ur AeroSpace config options. strap in 🦋

✨ NAME ✨

aerospace-config — query AeroSpace config options 🔍

🌸 SYNOPSIS 🌸

aerospace config [-h|--help] --get <name> [--json] [--keys]
aerospace config [-h|--help] --major-keys
aerospace config [-h|--help] --all-keys
aerospace config [-h|--help] --config-path

🎀 DESCRIPTION 🎀

query AeroSpace config options. that's the whole vibe ✨

fr fr, for now only mode.* config options are supported — like, that's the current roster, no cap.

under the hood, the config is represented as a recursive data structure of maps, arrays, strings, and integers. it's giving nesting dolls but make it config 🪆

printing without --json or --keys is supported only for scalar types (strings and integers) and array of scalar types. so if u try to print other complicated objects, u literally need --json or --keys — no shortcuts bestie 😭

🫶 OPTIONS 🫶

  • -h, --help — print help 💬
  • --get <name> — get the value for a given key. u can inspect available keys with --major-keys or --all-keys 👀
  • --major-keys — print major keys 🔑
  • --all-keys — print all available keys recursively — every single one, all the way down 🌀
  • --json — print result in JSON format 📦
  • --keys — print keys of the complicated object (map or array) 🗝️
  • --config-path — print absolute path to the loaded config 📁

🦋 EXAMPLES 🦋

okay these are iconic, watch 👑

  1. list all binding modes:
$ aerospace config --get mode --keys
main
service
  1. list all key bindings for 'main' binding mode:
$ aerospace config --get mode.main.binding --keys
alt-1
alt-2
...
  1. list all key bindings for 'main' binding mode in JSON format:
$ aerospace config --get mode.main.binding --json
{
  "alt-w" : "workspace W",
  "alt-y" : "workspace Y",
  "alt-n" : "workspace N",
  "alt-shift-e" : "move-node-to-workspace E",
  "alt-shift-m" : "move-node-to-workspace M",
  "alt-shift-t" : "move-node-to-workspace T",
...

🌈 RESOURCES 🌈

💀 BUGS 💀

found a bug? bestie, report it here:

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

the maintainers will move verified bugs over to:

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

so like, don't worry abt putting it in the exact right spot, they got u 🫶

👑 LICENSE 👑

copyright © 2023 Nikita Bobko

free use of this software is granted under the terms of the MIT License ✨

u 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!! this beauty came out with AeroSpace, dated 2026-07-16 — go forth and query ur config, u absolute icon 🧚‍♀️🍓💅

📦 where this page comes from