trent-aerospace_skill

Overview

This skill helps configure the AeroSpace tiling window manager for macOS, focusing on keybindings, workspace management, and layout tuning. It guides edits to the user's primary config at /Users/trent/.aerospace.toml while preserving customizations and validating TOML syntax. It provides concise, practical examples and references to the official AeroSpace documentation when needed.

How this skill works

First, the skill inspects the current configuration file at /Users/trent/.aerospace.toml (and the chezmoi source at /Users/trent/.local/share/chezmoi/dot_aerospace.toml if present). It recommends changes using TOML snippets, explains the effect of each change, and points to official docs (guide, commands, configuration) for syntax and options. Before suggesting final edits it validates that snippets are valid TOML and explains how to reload AeroSpace to apply changes.

When to use it

• Add or modify Vim-style keybindings for window navigation and manipulation
• Create, rename, or tune workspace behavior and default layouts
• Adjust tree-based layouts, gaps, padding, and resize policies
• Define window rules (floating, opacity, workspace assignment)
• Validate and test TOML configuration changes before reloading

Best practices

• Always back up /Users/trent/.aerospace.toml before making edits
• Read and reference the official AeroSpace configuration docs for exact keys
• Make incremental changes and validate TOML syntax after each edit
• Preserve existing custom entries; add new keybindings instead of replacing
• Test reloads in a safe session and document any custom keybindings

Example use cases

• Add a new keybinding to swap focused window with the tree sibling using a Vim-style mapping
• Create a workspace that always opens a browser and a terminal side-by-side with a defined tree layout
• Set a rule to float a specific utility app and assign it to a dedicated workspace
• Reduce gaps and padding globally for a denser tiling layout across all workspaces
• Validate and fix TOML parse errors reported after a manual edit