Where Is the AeroSpace Config File?
AeroSpace aerospace.toml in home config on macOS.
Last updated
AeroSpace reads a single aerospace.toml from your home config folder, with workspaces, layouts, keybinds and gaps in one versionable file. No GUI editor exists, so the TOML is the whole interface.
Lint the file after every workspace experiment since one bad bracket kills tiling silently. Dotfile the TOML and machines converge instantly.
Where AeroSpace stores this, by platform
~/.config/aerospace/aerospace.toml
Main config with modes, workspaces and exec rules. Respects XDG_CONFIG_HOME when set. Reload with aerospace reload-config after edits and check errors in logs.
Frequently asked questions
How do I reload AeroSpace config?
Edit aerospace.toml above then run aerospace reload-config. Syntax errors print to logs instead of applying.
Where are AeroSpace logs?
In macOS log streams and /tmp per session. Check them when keybinds stop responding after edits.
Notice an outdated path? Let us know.