cua-driver

Community

Automate macOS GUI tasks without foregrounds.

Authordawsonblock
Version1.0.0
Installs0

System Documentation

What problem does it solve?

macOS GUI automation runs in the background using cua-driver to drive apps without forcing foreground activation, preserving user context while performing tasks.

Core Features & Use Cases

  • Hidden launch, AX-tree snapshotting, and element_index driven actions that keep the target app in the background.
  • Flexible capture modes (som/ax/vision) with per-pid routing, verification via after-state snapshots, and robust safety checks.
  • Typical workflows include automating Finder, Calculator, or browser apps without visual interruption, enabling testing and automation scenarios.

Quick Start

Launch the target app with launch_app, snapshot with get_window_state, and perform actions via element_index while keeping the frontmost context unchanged.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: cua-driver
Download link: https://github.com/dawsonblock/HERMY/archive/main.zip#cua-driver

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.