playbooks

home / skills / trentshaines / dotfiles / trent-aerospace

trent-aerospace skill

/dot_claude/skills/trent-aerospace

This skill helps you configure AeroSpace tiling, workspaces, and keybindings with clear examples and safety checks.

npx playbooks add skill trentshaines/dotfiles --skill trent-aerospace

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
1.4 KB
---
name: trent-aerospace
description: Help with AeroSpace window manager configuration, keybindings, and workspace management. Use when the user asks about AeroSpace, window management, workspaces, or tiling configurations.
---

# AeroSpace Window Manager Skill

## Configuration Location

The main AeroSpace configuration file is located at:

- **Primary config**: `/Users/trent/.aerospace.toml`
- **Chezmoi source**: `/Users/trent/.local/share/chezmoi/dot_aerospace.toml`

## Official Documentation

Always reference the official AeroSpace documentation when helping with configuration:

- **Main Guide**: https://nikitabobko.github.io/AeroSpace/guide
- **Commands**: https://nikitabobko.github.io/AeroSpace/commands
- **Configuration**: https://nikitabobko.github.io/AeroSpace/guide#configuring

## Key Concepts

AeroSpace is a tiling window manager for macOS that uses:

- TOML configuration format
- Workspace-based organization
- Vim-style keybindings
- Tree-based window layouts

## When Helping Users

1. Always read the current config at `/Users/trent/.aerospace.toml` first
2. Reference the official documentation for correct syntax and options
3. Explain changes clearly with examples
4. Preserve existing user customizations
5. Test configurations are valid TOML format

## Common Tasks

- Adding/modifying keybindings
- Configuring workspaces
- Setting up window rules
- Adjusting layout behavior
- Managing gaps and padding

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

FAQ

Where is my AeroSpace config located?

Primary config: /Users/trent/.aerospace.toml. Chezmoi source (if used): /Users/trent/.local/share/chezmoi/dot_aerospace.toml.

How do I test changes safely?

Make small incremental edits, run a TOML validator, and reload AeroSpace in a test session. Keep a backup of the original file to revert quickly.