Skip to content

Instantly share code, notes, and snippets.

@cristianoliveira
Last active May 14, 2025 12:02
Show Gist options
  • Save cristianoliveira/ce61c401eecbc15204d971dbf9159171 to your computer and use it in GitHub Desktop.
Save cristianoliveira/ce61c401eecbc15204d971dbf9159171 to your computer and use it in GitHub Desktop.
aerospace config productivity tip
# Place a copy of this config to ~/.aerospace.toml
# After that, you can edit ~/.aerospace.toml to your liking
# You can use it to add commands that run after login to macOS user session.
# 'start-at-login' needs to be 'true' for 'after-login-command' to work
# Available commands: https://nikitabobko.github.io/AeroSpace/commands
after-login-command = []
# You can use it to add commands that run after AeroSpace startup.
# 'after-startup-command' is run after 'after-login-command'
# Available commands : https://nikitabobko.github.io/AeroSpace/commands
after-startup-command = []
# Start AeroSpace at login
start-at-login = false
# Normalizations. See: https://nikitabobko.github.io/AeroSpace/guide#normalization
enable-normalization-flatten-containers = true
enable-normalization-opposite-orientation-for-nested-containers = true
# See: https://nikitabobko.github.io/AeroSpace/guide#layouts
# The 'accordion-padding' specifies the size of accordion padding
# You can set 0 to disable the padding feature
accordion-padding = 30
# Possible values: tiles|accordion
default-root-container-layout = 'tiles'
# Possible values: horizontal|vertical|auto
# 'auto' means: wide monitor (anything wider than high) gets horizontal orientation,
# tall monitor (anything higher than wide) gets vertical orientation
default-root-container-orientation = 'auto'
# Mouse follows focus when focused monitor changes
# Drop it from your config, if you don't like this behavior
# See https://nikitabobko.github.io/AeroSpace/guide#on-focus-changed-callbacks
# See https://nikitabobko.github.io/AeroSpace/commands#move-mouse
# Fallback value (if you omit the key): on-focused-monitor-changed = []
on-focused-monitor-changed = ['move-mouse monitor-lazy-center']
# You can effectively turn off macOS "Hide application" (cmd-h) feature by toggling this flag
# Useful if you don't use this macOS feature, but accidentally hit cmd-h or cmd-alt-h key
# Also see: https://nikitabobko.github.io/AeroSpace/goodies#disable-hide-app
automatically-unhide-macos-hidden-apps = false
# Possible values: (qwerty|dvorak)
# See https://nikitabobko.github.io/AeroSpace/guide#key-mapping
[key-mapping]
preset = 'qwerty'
# Gaps between windows (inner-*) and between monitor edges (outer-*).
# Possible values:
# - Constant: gaps.outer.top = 8
# - Per monitor: gaps.outer.top = [{ monitor.main = 16 }, { monitor."some-pattern" = 32 }, 24]
# In this example, 24 is a default value when there is no match.
# Monitor pattern is the same as for 'workspace-to-monitor-force-assignment'.
# See: https://nikitabobko.github.io/AeroSpace/guide#assign-workspaces-to-monitors
[gaps]
inner.horizontal = 10
inner.vertical = 10
outer.left = 10
outer.bottom = 10
outer.top = 10
outer.right = 10
# 'main' binding mode declaration
# See: https://nikitabobko.github.io/AeroSpace/guide#binding-modes
# 'main' binding mode must be always presented
# Fallback value (if you omit the key): mode.main.binding = {}
[mode.main.binding]
# All possible keys:
# - Letters. a, b, c, ..., z
# - Numbers. 0, 1, 2, ..., 9
# - Keypad numbers. keypad0, keypad1, keypad2, ..., keypad9
# - F-keys. f1, f2, ..., f20
# - Special keys. minus, equal, period, comma, slash, backslash, quote, semicolon, backtick,
# leftSquareBracket, rightSquareBracket, space, enter, esc, backspace, tab
# - Keypad special. keypadClear, keypadDecimalMark, keypadDivide, keypadEnter, keypadEqual,
# keypadMinus, keypadMultiply, keypadPlus
# - Arrows. left, down, up, right
# All possible modifiers: cmd, alt, ctrl, shift
# All possible commands: https://nikitabobko.github.io/AeroSpace/commands
# See: https://nikitabobko.github.io/AeroSpace/commands#exec-and-forget
# You can uncomment the following lines to open up terminal with alt + enter shortcut (like in i3)
# alt-enter = '''exec-and-forget osascript -e '
# tell application "Terminal"
# do script
# activate
# end tell'
# '''
# See: https://nikitabobko.github.io/AeroSpace/commands#layout
ctrl-alt-v = 'layout tiles horizontal vertical'
ctrl-alt-h = 'layout accordion horizontal vertical'
# See: https://nikitabobko.github.io/AeroSpace/commands#focus
alt-h = 'focus left'
alt-j = 'focus down'
alt-k = 'focus up'
alt-l = 'focus right'
# See: https://nikitabobko.github.io/AeroSpace/commands#move
alt-shift-h = 'move left'
alt-shift-j = 'move down'
alt-shift-k = 'move up'
alt-shift-l = 'move right'
# See: https://nikitabobko.github.io/AeroSpace/commands#resize
alt-shift-minus = 'resize smart -50'
alt-shift-equal = 'resize smart +50'
# See: https://nikitabobko.github.io/AeroSpace/commands#workspace
alt-b = 'workspace 𝙱̲rowsing'
alt-c = 'workspace 𝙲̲ommunication'
alt-d = 'workspace 𝙳̲evelopment'
alt-e = 'workspace 𝙴̲xtra'
alt-f = 'workspace 𝙵̲ile_Management'
alt-g = 'workspace 𝙶̲aming'
alt-t = 'workspace Learn_Linux_𝚃̲V'
alt-m = 'workspace 𝙼̲usic'
alt-o = 'workspace 𝙾̲ther'
alt-p = 'workspace 𝙿̲lanning'
alt-1 = 'workspace Project_𝟷̲'
alt-2 = 'workspace Project_𝟸̲'
alt-r = 'workspace 𝚁̲esearch'
alt-s = 'workspace 𝚂̲ystem_Administration'
alt-w = 'workspace 𝚆̲riting'
alt-v = 'workspace 𝚅̲M'
# See: https://nikitabobko.github.io/AeroSpace/commands#move-node-to-workspace
alt-shift-b = 'move-node-to-workspace 𝙱̲rowsing'
alt-shift-c = 'move-node-to-workspace 𝙲̲ommunication'
alt-shift-d = 'move-node-to-workspace 𝙳̲evelopment'
alt-shift-e = 'move-node-to-workspace 𝙴̲xtra'
alt-shift-f = 'move-node-to-workspace 𝙵̲ile_Management'
alt-shift-g = 'move-node-to-workspace 𝙶̲aming'
alt-shift-t = 'move-node-to-workspace Learn_Linux_𝚃̲V'
alt-shift-m = 'move-node-to-workspace 𝙼̲usic'
alt-shift-o = 'move-node-to-workspace 𝙾̲ther'
alt-shift-p = 'move-node-to-workspace 𝙿̲lanning'
alt-shift-1 = 'move-node-to-workspace Project_𝟷̲'
alt-shift-2 = 'move-node-to-workspace Project_𝟸̲'
alt-shift-r = 'move-node-to-workspace 𝚁̲esearch'
alt-shift-s = 'move-node-to-workspace 𝚂̲ystem_Administration'
alt-shift-w = 'move-node-to-workspace 𝚆̲riting'
alt-shift-v = 'move-node-to-workspace 𝚅̲M'
# See: https://nikitabobko.github.io/AeroSpace/commands#workspace-back-and-forth
alt-tab = 'workspace-back-and-forth'
# See: https://nikitabobko.github.io/AeroSpace/commands#move-workspace-to-monitor
alt-shift-tab = 'move-workspace-to-monitor --wrap-around next'
# See: https://nikitabobko.github.io/AeroSpace/commands#mode
alt-shift-semicolon = 'mode service'
# 'service' binding mode declaration.
# See: https://nikitabobko.github.io/AeroSpace/guide#binding-modes
[mode.service.binding]
esc = ['reload-config', 'mode main']
r = ['flatten-workspace-tree', 'mode main'] # reset layout
f = ['layout floating tiling', 'mode main'] # Toggle between floating and tiling layout
backspace = ['close-all-windows-but-current', 'mode main']
# sticky is not yet supported https://github.com/nikitabobko/AeroSpace/issues/2
#s = ['layout sticky tiling', 'mode main']
alt-shift-h = ['join-with left', 'mode main']
alt-shift-j = ['join-with down', 'mode main']
alt-shift-k = ['join-with up', 'mode main']
alt-shift-l = ['join-with right', 'mode main']
down = 'volume down'
up = 'volume up'
shift-down = ['volume set 0', 'mode main']
# Automatically move apps to specific workspaces
# Alacritty
[[on-window-detected]]
if.app-id = 'org.alacritty'
if.during-aerospace-startup = true
run = ['layout tiling']
# Bitwarden
[[on-window-detected]]
if.app-id = 'com.bitwarden.desktop'
if.during-aerospace-startup = true
run = ['layout tiling', 'move-node-to-workspace 𝙳̲evelopment']
# Calendar
[[on-window-detected]]
if.app-id = 'com.apple.Safari.WebApp.18CF2CE8-C8D1-4B99-A91C-F72EDCB7F6BB'
if.during-aerospace-startup = true
run = ['layout tiling', 'move-node-to-workspace 𝙿̲lanning']
# Commander One
[[on-window-detected]]
if.app-id = 'com.eltima.cmd1'
if.during-aerospace-startup = true
run = ['layout tiling', 'move-node-to-workspace 𝙵̲ile_Management']
# Gmail
[[on-window-detected]]
if.app-id = 'com.apple.Safari.WebApp.0FD84E62-21AE-48BB-B110-84D1EA857890'
if.during-aerospace-startup = true
run = ['layout tiling', 'move-node-to-workspace 𝙲̲ommunication']
# Discord
[[on-window-detected]]
if.app-id = 'com.hnc.Discord'
if.during-aerospace-startup = true
run = ['layout tiling', 'move-node-to-workspace 𝙲̲ommunication']
# Double Commander
[[on-window-detected]]
if.app-id = 'com.company.doublecmd'
if.during-aerospace-startup = true
run = ['layout tiling', 'move-node-to-workspace 𝙵̲ile_Management']
# Finder
[[on-window-detected]]
if.app-id = 'com.apple.finder'
if.during-aerospace-startup = true
run = ['layout tiling', 'move-node-to-workspace 𝙵̲ile_Management']
# iMessage
[[on-window-detected]]
if.app-id = 'com.apple.MobileSMS'
if.during-aerospace-startup = true
run = ['layout tiling', 'move-node-to-workspace 𝙲̲ommunication']
# Lire
[[on-window-detected]]
if.app-id = 'maccatalyst.com.lireapp.macOS'
if.during-aerospace-startup = true
run = ['layout tiling', 'move-node-to-workspace 𝚁̲esearch']
# Parallels
[[on-window-detected]]
if.app-id = 'com.parallels.winapp.2bc76b43e3f7774e5317ba1f4672a4b6.6d4353df58e741afa2e41d48d015c422.fs'
if.during-aerospace-startup = true
run = ['layout tiling', 'move-node-to-workspace 𝚅̲M']
# Pushover
[[on-window-detected]]
if.app-id = 'net.superblock.Pushover'
if.during-aerospace-startup = true
run = ['layout tiling', 'move-node-to-workspace 𝚂̲ystem_Administration']
# Signal
[[on-window-detected]]
if.app-id = 'org.whispersystems.signal-desktop'
if.during-aerospace-startup = true
run = ['layout tiling', 'move-node-to-workspace 𝙲̲ommunication']
# Steam
[[on-window-detected]]
if.app-id = 'com.valvesoftware.steam'
if.during-aerospace-startup = true
run = ['layout tiling', 'move-node-to-workspace 𝙶̲aming']
# Termius
[[on-window-detected]]
if.app-id = 'com.termius-dmg.mac'
if.during-aerospace-startup = true
run = ['layout tiling', 'move-node-to-workspace 𝙳̲evelopment']
# TextEdit
[[on-window-detected]]
if.app-id = 'com.apple.TextEdit'
if.during-aerospace-startup = true
run = ['layout tiling', 'move-node-to-workspace 𝙿̲lanning']
# Todoist
[[on-window-detected]]
if.app-id = 'com.todoist.mac.Todoist'
if.during-aerospace-startup = true
run = ['layout tiling', 'move-node-to-workspace 𝙿̲lanning']
# Thunderbird
[[on-window-detected]]
if.app-id = 'org.mozilla.thunderbird'
if.during-aerospace-startup = true
run = ['layout tiling', 'move-node-to-workspace 𝙲̲ommunication']
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment