mac-remote-control

Execute shell commands and AppleScript actions on a remote Mac via Mercury.

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/TitoPrausee/nexus-toti --skill mac-remote-control
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mac-remote-control
Source: https://github.com/TitoPrausee/nexus-toti/tree/main/data/skills/devops/mac-remote-control
Command: npx skills add https://github.com/TitoPrausee/nexus-toti --skill mac-remote-control

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of managing a Mac remotely by giving you reliable control over apps, files, input devices, and system actions from an AI workflow.

Core Features & Use Cases

  • Remote shell execution: Run commands on the connected Mac for file management, package installs, git operations, and maintenance tasks.
  • App and browser automation: Launch, quit, resize, and control apps such as Safari and Notes, including tab and window operations.
  • Desktop interaction: Send mouse clicks, drags, keyboard shortcuts, clipboard content, and system commands for end-to-end desktop workflows.
  • Use case: Open Safari, inspect the active tabs, move a window, copy text to the clipboard, and verify system status without physically touching the machine.

Quick Start

Use the mac-remote-control skill to connect to the target Mac, open Safari, and report the current active tabs.

Frequently Asked Questions about mac-remote-control

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

FAQPage Schema
How do I control a Mac remotely using AppleScript and shell commands?

You can control a Mac remotely by executing shell commands and AppleScript actions through a connected Mercury peer. This allows you to manage apps, automate Safari navigation, and trigger desktop inputs without physically touching the machine.

Can I automate Safari tabs and window positioning on a remote macOS host?

Yes, you can automate Safari navigation and window positioning on a remote macOS host. The Skill supports launching, quitting, and resizing apps, along with managing browser tabs and moving windows via AppleScript.

What do I need to send mouse clicks and keyboard input to a remote Mac?

To send mouse clicks and keyboard input to a remote Mac, you need a reachable Mercury peer and shell access via mercury.py exec. The target macOS host must also have cliclick and osascript available for deterministic desktop automation.

Does remote Mac automation work for clipboard operations and file management?

Yes, remote Mac automation works for clipboard operations and file management. You can copy text to the clipboard, run shell commands for file operations, and inspect system status directly from your AI workflow.

What are the limitations of using Mercury for desktop interaction on macOS?

Limitations include requiring a reachable Mercury peer with shell access and the target macOS host having cliclick and osascript installed. It relies on deterministic desktop automation, which may face issues if GUI elements are not in expected states.

Is mac-remote-control the best way to run remote shell execution on a connected Mac?

For AI workflows, mac-remote-control provides reliable remote shell execution on a connected Mac. It integrates file management, package installs, and git operations with desktop interaction and app management through a single Mercury connection.