MacPilot : Control macOS using CLI

Control macOS via CLI using MacPilot for automating UI actions, managing windows, handling file dialogs, capturing screenshots, and system tasks.

MacPilot Skills

Agent skills for MacPilot — a CLI tool for macOS automation via Accessibility APIs.

These skills teach AI coding agents (Claude Code, Cursor, Codex, etc.) how to use MacPilot to automate macOS tasks: clicking buttons, typing text, managing windows, handling file dialogs, taking screenshots, and more.

Install

npx skills add adhikjoshi/macpilot-skills

This uses the skills CLI to install skills into your agent of choice.

Available Skills

Skill	Description
macpilot-automation	Core macOS automation — mouse, keyboard, apps, menus, clipboard (with history & search), notifications, shell, system controls
macpilot-ui-inspector	Inspect and interact with UI elements via accessibility APIs — find, click, read, and modify controls
macpilot-dialog-handler	Handle native file dialogs (Open, Save, Print) — navigate folders, select files, dismiss alerts, wait-for & click-primary
macpilot-screenshot-ocr	Capture screenshots, OCR click (find & click text on screen), screen recording with pause/resume
macpilot-window-manager	Manage windows — list, move, resize, snap, fullscreen, Spaces, save/restore layouts

Prerequisites

1. MacPilot installed — Build from source or download from releases
2. Accessibility permission — Grant MacPilot.app access in System Settings > Privacy & Security > Accessibility
3. Screen Recording permission (for screenshot/OCR skills) — Grant in System Settings > Privacy & Security > Screen Recording

Quick Start

# Install MacPilot skills into Claude Code
npx skills add adhikjoshi/macpilot-skills

# Now ask Claude Code to automate macOS:
# "Open Safari and navigate to example.com"
# "Take a screenshot of the Finder window"
# "Snap VS Code to the left half and Terminal to the right"
# "Save this file to my Desktop"

Manual Install

If you prefer not to use npx skills, copy any SKILL.md file to your agent's skills directory:

# Claude Code (project scope)
mkdir -p .claude/skills/macpilot-automation
cp skills/macpilot-automation/SKILL.md .claude/skills/macpilot-automation/

# Claude Code (global scope)
mkdir -p ~/.claude/skills/macpilot-automation
cp skills/macpilot-automation/SKILL.md ~/.claude/skills/macpilot-automation/

License

MIT