macos-privacy-permissions

Diagnose and configure macOS privacy permissions for agent file access and automation.

5|Updated Jun 3, 2026
One-click install
npx skills add https://github.com/rafael-fae/agent-ops-worflow --skill macos-privacy-permissions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: macos-privacy-permissions
Source: https://github.com/rafael-fae/agent-ops-worflow/tree/main/skills/operacao/macos-privacy-permissions
Command: npx skills add https://github.com/rafael-fae/agent-ops-worflow --skill macos-privacy-permissions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you diagnose and configure the macOS privacy permissions that commonly block agent workflows, such as file access errors, automation failures, and restricted system control.

Core Features & Use Cases

  • Permission Diagnostics: Checks access to protected folders, the TCC database, process visibility, and AppleScript automation.
  • Required macOS Settings: Guides setup for Full Disk Access, Accessibility, Automation, and Files and Folders permissions.
  • Post-Setup Verification: Provides a validation routine to confirm the agent can operate across Desktop, Downloads, Documents, and other protected locations.
  • Use Case: Use this Skill when a Hermes agent or terminal tool fails with permission denied errors on macOS and needs a reliable checklist to restore access.

Quick Start

Ask the assistant to diagnose your macOS privacy permissions for your agent tools and tell you exactly which settings to enable in System Settings.

Frequently Asked Questions about macos-privacy-permissions

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

FAQPage Schema
How do I fix macOS permission denied errors blocking agent file access?

Fix macOS permission denied errors by diagnosing TCC database restrictions and enabling Full Disk Access for your terminal workflows. This Skill audits protected folder permissions and guides you through System Settings to restore access.

What macOS privacy settings do I need to enable for terminal automation?

Terminal automation requires enabling Accessibility, Automation, and Full Disk Access in macOS privacy settings. This Skill checks your AppleScript permissions and provides a validation routine to confirm your tools can control the system.

How do I grant a Hermes agent access to protected folders on macOS?

Grant a Hermes agent access to protected folders by configuring Files and Folders permissions for Desktop, Downloads, and Documents. This Skill diagnoses TCC failures and verifies post-setup access across these protected locations.

Why does my macOS automation tool fail with TCC-related errors?

macOS automation tools fail with TCC-related errors when they lack the required privacy permissions for system control and file access. This Skill troubleshoots TCC database issues and identifies exactly which settings to enable.

Can I verify macOS privacy permissions are correctly configured for my agent setup?

You can verify macOS privacy permissions by running a post-setup validation routine that checks access to protected locations. This Skill confirms your agent can operate across Desktop, Downloads, and Documents without permission blocks.