remote-mac

Manage remote Macs over SSH with commands, screenshots, app control, and file transfers.

7|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/ythx-101/remote-mac --skill remote-mac
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: remote-mac
Source: https://github.com/ythx-101/remote-mac/tree/main
Command: npx skills add https://github.com/ythx-101/remote-mac --skill remote-mac

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ssh, scp, curl, python3, and includes scripts (resource) components.

What problem does it solve?

Remote Mac management from Linux/VPS via SSH to run commands, capture screenshots, control applications, and transfer files.

Core Features & Use Cases

  • Run remote commands and scripts
  • Take screenshots and verify GUI state
  • Open, activate, quit, or kill apps; transfer files
  • Check connectivity and bridge status (OpenClaw integration optional)

Quick Start

Configure ~/.remote-mac.conf or environment variables, then run a sample command such as bash scripts/mac_exec.sh --run "sw_vers" to verify remote access.

Frequently Asked Questions about remote-mac

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

FAQPage Schema
How do I remotely manage a Mac from a Linux VPS via SSH?

Remote Mac management over SSH from Linux is handled through automated scripts that execute commands, capture screenshots, and transfer files. The workflow uses a configuration file for credentials and supports SSH multiplexing for efficient connections.

Can I take screenshots and control applications on a remote Mac using SSH?

Yes, taking screenshots and controlling applications on a remote Mac via SSH is supported. You can capture screen state, open or quit apps, and kill processes, all executed through the SSH script workflow from your Linux terminal.

What do I need to configure before running remote SSH commands on a Mac?

Before executing remote SSH commands, configure your credentials in ~/.remote-mac.conf or as environment variables. Ensure ssh, scp, curl, and python3 dependencies are installed on your local Linux system to enable the automation workflow.

How do I transfer files to a remote Mac from a Linux terminal?

You transfer files to a remote Mac using scp integrated into the SSH automation scripts. Once your connection configuration is established, the workflow securely copies files between your Linux environment and the remote macOS host.

Does SSH multiplexing work when running remote Mac automation scripts?

SSH multiplexing is supported within the remote Mac automation scripts to maintain persistent connections. This works alongside configurable timeouts and StrictHostKeyChecking safety options to streamline command execution and file transfers.

What are the limitations of using SSH for remote macOS management?

SSH-based remote macOS management requires network connectivity and proper credential setup. It handles commands, screenshots, and file transfers effectively, but complex GUI interactions may be limited compared to direct desktop remote control.