aerospace

Configure AeroSpace window manager settings in TOML config files.

2|Updated Sep 9, 2024
One-click install
npx skills add https://github.com/trentshaines/dotfiles --skill aerospace
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aerospace
Source: https://github.com/trentshaines/dotfiles/tree/main/dot_claude/skills/aerospace
Command: npx skills add https://github.com/trentshaines/dotfiles --skill aerospace

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually arranging windows on macOS can be inefficient and distracting. This Skill helps you configure and manage the AeroSpace tiling window manager, allowing you to optimize your screen real estate and workflow with automated window layouts.

Core Features & Use Cases

  • Keybinding Management: Easily add or modify keyboard shortcuts for window and workspace control.
  • Workspace Configuration: Define and switch between custom workspaces for different tasks.
  • Use Case: You want to set up a new keybinding to move a window to the next workspace. Ask Claude to add alt - shift - right to move the focused window to the next workspace in your ~/.aerospace.toml file.

Quick Start

I want to add a new keybinding to my AeroSpace config. When I press alt - enter, I want it to launch Alacritty.

Frequently Asked Questions about aerospace

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up window tiling on macOS with AeroSpace?

Window tiling on macOS with AeroSpace automates window layout management by reading your ~/.aerospace.toml configuration file and applying tree-based layout rules, workspaces, and keybindings to organize windows without manual dragging. Start by editing your config to define workspaces, keybindings, and window rules.

Can I add custom keybindings to control windows in AeroSpace?

Yes, AeroSpace supports custom keybindings for window and workspace control. Edit your ~/.aerospace.toml file to add keybindings like `alt - shift - right` to move focused windows between workspaces, launch applications, or trigger layout changes.

What's the best way to configure multiple workspaces in AeroSpace?

Define multiple workspaces in your ~/.aerospace.toml by specifying workspace names and their associated window rules, gaps, and padding settings. AeroSpace reads this TOML configuration to organize windows across workspaces and enable quick switching via keybindings.

Does AeroSpace work with my current macOS setup and terminal?

AeroSpace is a macOS-native window manager compatible with any terminal or shell environment. It manages system-level window tiling through configuration stored in ~/.aerospace.toml, independent of which terminal or applications you run.

Why aren't my AeroSpace keybindings working after configuration?

Keybinding failures typically stem from TOML syntax errors or conflicting system keybindings. Validate your ~/.aerospace.toml syntax, check that keybinding syntax matches AeroSpace documentation, and verify no macOS system shortcuts override your bindings.

How do I adjust window gaps and padding in AeroSpace?

Modify the gaps and padding values in your ~/.aerospace.toml file under workspace or global settings. AeroSpace applies these spacing rules to all tiled windows, giving you fine-grained control over screen real estate and layout density.