desktop-guardian
por s3rous
Coding Agents & IDEsResumen
macOS GUI automation and desktop control for OpenClaw, powered by Hammerspoon.
Descripción
Qué hace esta skill
Desktop Guardian gives OpenClaw agents full access to the macOS GUI via Hammerspoon. It can query windows, close tabs, click dialog buttons, and send keypresses to any app. An always-on monitor watches for system dialogs, permission prompts, and unauthorized apps, auto-dismissing safe ones and alerting when human input is needed.
Unlike AppleScript or headless shell automation, it monitors desktop state continuously and intercepts macOS permission prompts before they stall an agent mid-task, with configurable safety guardrails that prevent clicking destructive buttons.
Cuándo usarla
- Auto-dismissing 'app downloaded from internet' popups during software installs
- Closing excess Chrome tabs when a browser window limit is exceeded
- Detecting and quitting apps not on the approved whitelist
- Alerting when a security prompt requires manual approval
- Clicking OK on system dialogs without switching focus from another task
Flujo de trabajo de ejemplo
User asks: Close all Chrome tabs not related to my current project and tell me what was closed
- 1
Connects to Chrome via Chrome DevTools Protocol on port 9222
- 2
Retrieves all open tabs with their URLs and titles
- 3
Compares each tab against allowed domains defined in policy.yaml
- 4
Closes non-matching tabs using CDP commands
- 5
Logs each closed tab to the audit trail and returns a summary
Closed 4 tabs (reddit.com, youtube.com, twitter.com, news.ycombinator.com); audit log updated
Requisitos
- macOS Accessibility permission granted to Hammerspoon in System Settings
Instalación
clawhub install s3rous/desktop-guardianEjecuta el comando de la CLI o pega el prompt en Claude Code, Cursor, Codex o el agente de programación que uses.