macOS Permissions

The macOS-only `cua-driver permissions` command for inspecting and requesting Accessibility and Screen Recording TCC grants.

cua-driver permissions is a macOS-only command. It is not part of the auto-generated CLI reference because it has no Windows or Linux counterpart, so it is documented here.

cua-driver permissions (macOS)#

Inspect or request the macOS TCC grants the driver needs (Accessibility and Screen Recording). Embedded-mode hosts do not use cua-driver permissions grant; the host app requests these grants itself, as described in Embedding.

cua-driver permissions status   # report grant status; read-only, no prompt
cua-driver permissions grant    # launch CuaDriver via LaunchServices so the prompt attributes to the app

Flags:

The JSON status also includes screen_recording_capturable, a live capture probe attributed to the CuaDriver daemon. macOS Tahoe can present separate consent dialogs when CuaDriver controls System Events or requests direct screen and audio capture without the system picker. The Automation grant is outside the permissions status payload.

For the complete prompt sequence in a Lume guest, see Run Cua Driver in a macOS Lume VM. Source-built test seeds also need a stable certificate identity; follow Run Cua Driver macOS tests in a Lume VM.