# Cua Driver

Drive a native macOS app via the cua-driver CLI (default) or MCP server, snapshot its...

- Repository: https://github.com/melandlabs/openloomi (1038 stars)
- Category: AI and agents
- License: Apache-2.0
- Last updated: 2026-09-24
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add melandlabs/openloomi --skill cua-driver -g -a claude-code -y`
Codex: `npx skills add melandlabs/openloomi --skill cua-driver -g -a codex -y`
Cursor: `npx skills add melandlabs/openloomi --skill cua-driver -g -a cursor -y`
Gemini CLI: `npx skills add melandlabs/openloomi --skill cua-driver -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add melandlabs/openloomi`

## Description

Drive a native macOS app via the cua-driver CLI (default) or MCP server, snapshot its AX tree, click/type/scroll by element_index, verify via re-snapshot. Use when the user asks you to operate, drive, automate, or perform a GUI task in a real macOS application on the host (e.g. "open a file in TextEdit", "navigate to /Applications in Finder", "click the Save button in Numbers").

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# cua-driver

Orchestrates macOS app automation via `cua-driver`. Whenever a user
asks to drive a native macOS app, follow the loop in this skill rather
than calling tools ad-hoc, the snapshot-before-action invariant is not
optional and silently breaks if you skip it.

## The no-foreground contract, read this first

**The user's frontmost app MUST NOT change.** This is the whole
reason cua-driver exists. Users pay for the right to keep typing in
their editor while an agent drives another app in the background.
Violate this rule and every other nice property the driver gives
you (no cursor warp, no Space switch, no window raise) stops
mattering, you just shipped the Accessibility Inspector with extra
steps.

Before running any shell command, ask: **"does this raise,
activate, foreground, or make-key any app?"** If yes, don't run it.
Every one of the commands below activates the target on macOS and
is therefore forbidden unless the user **explicitly** asked for
frontmost state:

The rest: https://github.com/melandlabs/openloomi/blob/HEAD/skills/cua-driver/SKILL.md