aerospace_skill

Overview

This skill helps configure and troubleshoot the AeroSpace tiling window manager for macOS, focusing on keybindings, workspace setup, and layout behavior. It guides edits to the TOML configuration, validates syntax, and provides clear examples to preserve user customizations. Use it to optimize window rules, gaps, and Vim-style bindings for productive workflows.

How this skill works

The skill inspects the user's AeroSpace configuration and recommends changes, then explains how to apply them safely. It checks TOML syntax, maps desired behaviors to AeroSpace options, and references official documentation for exact commands and fields. When appropriate, it offers sample snippets and step-by-step instructions to test changes without breaking the current setup.

When to use it

• Add or modify Vim-style keybindings
• Create or adjust workspaces and layout rules
• Set up window placement and application-specific rules
• Tune gaps, padding, or tree layout behavior
• Validate and test TOML configuration changes

Best practices

• Read the live config at /Users/trent/.aerospace.toml before making edits
• Backup the existing config (or use the Chezmoi source) before changes
• Reference official AeroSpace docs for exact syntax and new options
• Preserve unrelated customizations; edit minimally and incrementally
• Validate TOML syntax after edits and restart AeroSpace to test

Example use cases

• Add a new keybinding to move windows between workspaces while preserving existing keys
• Define a workspace layout for coding: terminal + editor + browser panes in a tree layout
• Create a rule to float a specific app and tile all others by default
• Adjust horizontal and vertical gaps for better multi-monitor spacing
• Migrate a setting from the chezmoi source (/Users/trent/.local/share/chezmoi/dot_aerospace.toml) into the live config