aerospace

Configures AeroSpace tiling window manager rules to float apps or assign workspaces via chezmoi.

1|Updated Aug 6, 2025
One-click install
npx skills add https://github.com/azaidrahman/zaid-sani-dotfiles --skill aerospace-azaidrahman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aerospace
Source: https://github.com/azaidrahman/zaid-sani-dotfiles/tree/main/dot_claude/skills/aerospace
Command: npx skills add https://github.com/azaidrahman/zaid-sani-dotfiles --skill aerospace-azaidrahman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Editing AeroSpace window rules is error-prone: there is no "ignore" list, edits to the deployed config get overwritten by chezmoi, and rules only fire on newly detected windows. This Skill guides correct edits to aerospace.toml so apps float, keep their own size, or land on the right workspace. ## Core Features & Use Cases - Float an app: Add an [[on-window-detected]] rule with run = 'layout floating' so an app keeps its own size instead of being tiled. - Assign workspaces: Combine floating with move-node-to-workspace N in a single rule, using exact bundle IDs from aerospace list-apps. - Safe deploy chain: Edit the chezmoi source, then run a scoped chezmoi apply plus aerospace reload-config to avoid triggering unrelated run_onchange scripts. - Use Case: You want Sioyek to stop being resized by AeroSpace — look up its bundle id, add a floating rule to the chezmoi source, apply just that file, reload the config, and relaunch the app. ## Quick Start Make Sioyek float in AeroSpace instead of being tiled, and deploy the change through chezmoi.

Frequently Asked Questions about aerospace

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

FAQPage Schema
How do I make an app float in AeroSpace?

Add an [[on-window-detected]] block in aerospace.toml with the app's bundle id and run = 'layout floating'. There is no separate ignore list — floating via this rule is how an app keeps its own size instead of being tiled.

How do I find an app's bundle id for AeroSpace rules?

Run aerospace list-apps while the app is running to get a table of pid, bundle id, and name, or use aerospace list-apps --json for app-bundle-id fields. Copy the app-bundle-id into if.app-id for an exact, stable match.

Why did my AeroSpace config change get overwritten?

Editing ~/.config/aerospace/aerospace.toml directly is overwritten by the next chezmoi apply. Edit the chezmoi source at ~/.local/share/chezmoi/dot_config/aerospace/aerospace.toml, then run chezmoi apply scoped to that file.

Why doesn't my AeroSpace floating rule affect already-open windows?

on-window-detected rules only fire on newly detected windows, so existing windows stay tiled after a reload. Relaunch the app, or focus the window and run aerospace layout floating to apply it immediately.

How do I move an app to a specific AeroSpace workspace?

Make the rule's run value a list combining floating and workspace assignment, e.g. run = ['layout floating', 'move-node-to-workspace 4']. Put the float action first, then reload the config and relaunch the app.