aerospace

Configure and operate the AeroSpace tiling window manager on macOS.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/mpsuesser/workspace --skill aerospace-mpsuesser
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aerospace
Source: https://github.com/mpsuesser/workspace/tree/main/dotconfig/pi/agent/skills/__techs__/aerospace
Command: npx skills add https://github.com/mpsuesser/workspace --skill aerospace-mpsuesser

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you quickly understand and use AeroSpace configuration and command capabilities so you can set up and operate a macOS tiling workflow without hunting through scattered docs.

Core Features & Use Cases

  • Command discovery: Find what each AeroSpace CLI command does (e.g., focus, move, resize, workspace navigation, and querying state).
  • Operational guidance: Use the linked guide and command reference to configure and reason about tiling layouts, normalization behavior, and workspace emulation.
  • Use case: You want reliable keyboard-driven window management on macOS—switch workspaces, move/resize windows, toggle layouts, and run query commands to inspect monitors, windows, and modes.

Quick Start

Use the aerospace skill when you are configuring keyboard bindings and want to know the exact AeroSpace command syntax to move focus, split/join layouts, or change workspaces.

Frequently Asked Questions about aerospace

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

FAQPage Schema
How do I configure AeroSpace tiling window manager on macOS?

To configure AeroSpace on macOS, use structured command and guide references to set up keyboard bindings, workspace navigation, window manipulation, and layout switching. The skill links to authoritative documentation for deterministic command usage in single or multi-monitor setups.

What is AeroSpace and how does it handle workspace management?

AeroSpace is an i3-like tiling window manager for macOS that enables keyboard-driven workspace management. It handles window focus, container manipulation, layout switching, and querying state for monitors, windows, and modes.

Can I use AeroSpace CLI commands to move and resize windows?

Yes, AeroSpace CLI commands support moving focus, resizing windows, splitting and joining layouts, and changing workspaces. The skill indexes command references to help you find exact syntax for window and container manipulation.

Does AeroSpace support multi-monitor tiling layouts on macOS?

AeroSpace supports configuration-driven workflows for both single and multi-monitor setups on macOS. You can query monitor state, navigate workspaces across displays, and manage tiling layouts using the provided command references.

How do I find the exact AeroSpace command syntax for keyboard bindings?

Use the aerospace skill when configuring keyboard bindings to discover exact command syntax for focus, move, resize, workspace navigation, and layout toggling. It links to authoritative command documentation for deterministic usage.

What are the limitations of using AeroSpace for macOS window management?

AeroSpace focuses on i3-like tiling behavior, normalization, and workspace emulation. It requires understanding CLI command syntax and configuration-driven workflows, and references authoritative docs to address edge cases in layout switching and window focus.