mac-control

Control macOS devices remotely via SSH, AppleScript, and Playwright.

Updated Feb 4, 2026
One-click install
npx skills add https://github.com/leprachuan/pot-o-skills --skill mac-control-leprachuan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mac-control
Source: https://github.com/leprachuan/pot-o-skills/tree/main/mac-control
Command: npx skills add https://github.com/leprachuan/pot-o-skills --skill mac-control-leprachuan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a unified interface to manage and automate tasks across multiple macOS devices, overcoming the challenges of remote access and diverse operational needs.

Core Features & Use Cases

  • Remote Command Execution: Run shell commands on registered Macs via SSH.
  • Browser Automation: Control web browsers on your Mac using Playwright for navigation, interaction, and screenshots.
  • Screen Capture: Capture the macOS desktop for monitoring or documentation.
  • Apple Notes Access: Retrieve and search notes stored on your Mac.
  • Use Case: You need to check the disk space on your work laptop, then take a screenshot of a specific webpage open in its browser, and finally retrieve a note about a project.

Quick Start

Run the command 'df -h' on your Mac.

Frequently Asked Questions about mac-control

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

FAQPage Schema
How do I run shell commands on a Mac remotely via SSH?

Remote shell command execution on macOS is achieved by establishing an SSH connection to the target machine and sending commands. This Skill automates that process, executing shell scripts and retrieving outputs across registered Mac devices.

Can I use Playwright for browser automation on a remote macOS device?

Yes, Playwright enables browser automation on remote macOS devices by controlling web navigation, interaction, and capturing webpage screenshots. It requires Playwright installed on the target Mac to execute these automated browser interactions successfully.

What's the best way to capture screenshots and access Apple Notes remotely on macOS?

Capturing screenshots and accessing Apple Notes remotely requires a unified interface using SSH, AppleScript, and screen recording permissions. This approach retrieves stored notes and captures the desktop for monitoring or documentation.

Do I need special permissions to enable screen capture on a remote Mac?

Yes, enabling remote screen capture on a Mac requires granting Screen Recording permissions to the controlling application. You must also configure SSH access and install Playwright for full desktop and browser automation capabilities.

Why does my macOS remote control automation fail to execute AppleScript commands?

macOS remote control automation fails to execute AppleScript commands when SSH access is not properly configured or Screen Recording permissions are missing. Successful task execution requires these dependencies to be explicitly enabled on the target Mac.