aerospace

Configure Aerospace.toml files for macOS window layouts and workspace assignments.

9|3|Updated Jun 29, 2012

Search Tags:#workspace #macos #tiling #aerospace #window-manager #i3-like

Ready to run

npx skills add https://github.com/whilp/dotfiles --skill aerospace-whilp

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: aerospace
Source: https://github.com/whilp/dotfiles/tree/main/.claude/skills/aerospace
Command: npx skills add https://github.com/whilp/dotfiles --skill aerospace-whilp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

AeroSpace is an i3-like tiling window manager for macOS. It organizes windows hierarchically in containers with layouts and orientations for efficient desktop workflows.

Core Features & Use Cases

Workspace organization: define internal/external monitors with specific layouts.
Gaps & layouts: configure inner/outer gaps and layouts like h_tiles and v_tiles.
Window navigation & management: keyboard bindings for focusing, moving, and resizing windows.

Quick Start

Edit ~/.config/aerospace/aerospace.toml to set up workspaces and gaps for your monitors.

Frequently Asked Questions about aerospace

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

FAQPage Schema

How do I set up tiling window management on macOS?▼

Tiling window management on macOS organizes windows into layouts that automatically resize and position to fill screen space efficiently. AeroSpace implements this with a TOML configuration file at ~/.config/aerospace/aerospace.toml, where you define workspaces, monitor assignments, layout types (h_tiles, v_tiles, h_accordion, v_accordion), and keyboard bindings to control window focus, movement, and resizing.

Can I use an i3-like window manager on macOS with multiple monitors?▼

Yes. AeroSpace brings i3-style hierarchical window management to macOS, supporting multi-monitor setups by assigning specific workspaces to internal and external displays. It organizes windows in nested containers with configurable layouts and gaps, letting you manage complex multi-monitor workflows with keyboard shortcuts for focus, move, and resize operations.

What window layout types does AeroSpace support?▼

AeroSpace supports four layout types: h_tiles (horizontal tiling), v_tiles (vertical tiling), h_accordion (horizontal accordion), and v_accordion (vertical accordion). You configure these per workspace in your TOML file to control how windows subdivide and fill available space on each monitor.

How do I configure workspaces and monitor assignments in AeroSpace?▼

Define workspaces and their monitor bindings in ~/.config/aerospace/aerospace.toml using TOML syntax. Assign each workspace a specific monitor (internal or external display), set layout types, configure inner and outer gaps between windows, and define key bindings for navigation and window management commands.

What CLI commands does AeroSpace provide for window management?▼

AeroSpace includes CLI commands for list (enumerate windows and workspaces), focus (select a window or workspace), move (relocate windows between containers), resize (adjust window dimensions), layout (switch layout types), and monitor/workspace management. These integrate with keyboard bindings to automate desktop workflows.

Does AeroSpace work with both built-in and external displays?▼

Yes. AeroSpace is designed for multi-monitor scenarios, letting you assign workspaces to internal (built-in) and external monitors with separate layout configurations, gaps, and window management rules for each display in your TOML configuration.