Skip to content
TakoAPI
Back to skills

desktop-guardian

by s3rous

Coding Agents & IDEs
377Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

macOS GUI automation and desktop control for OpenClaw, powered by Hammerspoon.

Description

What This Skill Does

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.

When to Use It

  • 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

Example Workflow

INPUT

User asks: Close all Chrome tabs not related to my current project and tell me what was closed

AGENT
  1. 1

    Connects to Chrome via Chrome DevTools Protocol on port 9222

  2. 2

    Retrieves all open tabs with their URLs and titles

  3. 3

    Compares each tab against allowed domains defined in policy.yaml

  4. 4

    Closes non-matching tabs using CDP commands

  5. 5

    Logs each closed tab to the audit trail and returns a summary

OUTPUT

Closed 4 tabs (reddit.com, youtube.com, twitter.com, news.ycombinator.com); audit log updated

Requirements

  • macOS Accessibility permission granted to Hammerspoon in System Settings

Installation

clawhub install s3rous/desktop-guardian

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links