Skills macpilot-window-manager

Name: macpilot-window-manager
Author: openclaw

Manage macOS windows with MacPilot. List, move, resize, snap, minimize, fullscreen, and arrange application windows. Supports multi-display and Spaces.

install

source · Clone the upstream repo

git clone https://github.com/openclaw/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/adhikjoshi/macpilot/skills/macpilot-window-manager" ~/.claude/skills/openclaw-skills-macpilot-window-manager && rm -rf "$T"

OpenClaw · Install into ~/.openclaw/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/adhikjoshi/macpilot/skills/macpilot-window-manager" ~/.openclaw/skills/openclaw-skills-macpilot-window-manager && rm -rf "$T"

manifest: skills/adhikjoshi/macpilot/skills/macpilot-window-manager/SKILL.md

MacPilot Window Manager

Use MacPilot to control application windows on macOS - list, move, resize, snap to positions, minimize, fullscreen, and manage across Spaces and displays.

When to Use

Use this skill when:

You need to arrange or organize application windows
You need to move/resize windows to specific positions
You need to snap windows to screen halves or corners
You need to list what windows are open
You need to focus or bring a specific window to front
You need to manage windows across multiple Spaces/desktops
You need to save and restore window layouts

Window Commands

List Windows

macpilot window list --json                        # All visible windows
macpilot window list --app "Safari" --json         # Windows for specific app
macpilot window list --all-spaces --json           # Include all Spaces

Focus Window

macpilot window focus "Safari" --json                          # Focus app's main window
macpilot window focus "Safari" --title "GitHub" --json         # Focus by title substring

New Window

macpilot window new "Safari" --json                # Open new window in app

Move Window

macpilot window move "Safari" 100 50 --json        # Move to x=100, y=50

Resize Window

macpilot window resize "Safari" 1200 800 --json    # Set width=1200, height=800

Close Window

macpilot window close --app "Safari" --json        # Close frontmost window

Minimize / Fullscreen

macpilot window minimize "Safari" --json           # Minimize to Dock
macpilot window fullscreen "Safari" --json         # Toggle fullscreen

Snap to Position

macpilot window snap "Safari" left --json          # Left half of screen
macpilot window snap "Safari" right --json         # Right half of screen
macpilot window snap "Safari" top-left --json      # Top-left quarter
macpilot window snap "Safari" top-right --json     # Top-right quarter
macpilot window snap "Safari" bottom-left --json   # Bottom-left quarter
macpilot window snap "Safari" bottom-right --json  # Bottom-right quarter
macpilot window snap "Safari" center --json        # Center of screen
macpilot window snap "Safari" maximize --json      # Fill entire screen

Save / Restore Layout

macpilot window restore --save --json              # Save all window positions
macpilot window restore --json                     # Restore saved positions
macpilot window restore --save --app "Safari"      # Save specific app only

Spaces / Desktops

macpilot space list --json                         # List all Spaces
macpilot space switch left --json                  # Switch to left Space
macpilot space switch right --json                 # Switch to right Space
macpilot space switch 2 --json                     # Switch to Space 2
macpilot space bring --app "Slack" --json          # Bring app to current Space

Workflow Patterns

Side-by-Side Layout

macpilot window snap "Safari" left
macpilot window snap "VS Code" right

Quarter Layout (4 Apps)

macpilot window snap "Safari" top-left
macpilot window snap "Terminal" top-right
macpilot window snap "Finder" bottom-left
macpilot window snap "Notes" bottom-right

Presentation Setup

# Maximize the presentation app
macpilot window snap "Keynote" maximize
# Or go fullscreen
macpilot window fullscreen "Keynote"

Dev Environment Layout

# Editor on left 60%, terminal on right 40%
macpilot window move "VS Code" 0 25
macpilot window resize "VS Code" 1152 775
macpilot window move "Terminal" 1152 25
macpilot window resize "Terminal" 768 775

Collect All Windows

# Bring scattered windows back to current Space
macpilot space bring --app "Safari"
macpilot space bring --app "Terminal"
macpilot space bring --app "Finder"

Save and Restore Workspace

# Before a meeting - save your layout
macpilot window restore --save

# After the meeting - restore it
macpilot window restore

Tips

Use
```
window list --json
```
to see current positions/sizes before rearranging
The
```
snap
```
command uses the display where the window currently resides
```
window focus
```
is preferred over
```
app focus
```
when multiple windows exist
Use
```
display-info --json
```
to get screen dimensions for precise positioning
Coordinates use top-left origin (0,0 is top-left of primary display)
On multi-monitor setups, secondary displays may have negative x coordinates (left of primary) or x > primary width (right of primary)