cua-driver

Cross-platform computer-use automation driver.

cua-driver [OPTIONS] <COMMAND>

Run cua-driver <command> --help for the build you have.

Commands#

Serve, configure and update#

Serve MCP and call tools from the shell; run the daemon; grant permissions and diagnose; configure the driver, telemetry and cursor; update and pick a release channel. Reference.

Command	Description
`cua-driver mcp`	Run the stdio MCP server.
`cua-driver mcp-config`	Print client-specific connection guidance (MCP config where supported) and install the skill pack for that agent.
`cua-driver list-tools`	List every registered MCP tool with a one-line description.
`cua-driver describe`	Print a tool's full description and JSON input schema.
`cua-driver call`	Invoke an MCP tool through the running daemon.
`cua-driver manifest`	Emit a stable JSON description of the CLI surface.
`cua-driver dump-docs`	Output machine-readable CLI and MCP documentation JSON.
`cua-driver serve`	Run Cua Driver as a long-running daemon.
`cua-driver stop`	Ask the running daemon to exit gracefully.
`cua-driver status`	Report whether a Cua Driver daemon is running.
`cua-driver sessions`	List content-free lifecycle summaries for sessions owned by the daemon runtime.
`cua-driver sessions list`	List live sessions.
`cua-driver revoke`	Revoke one or all live authorization/session scopes.
`cua-driver autostart`	Manage platform-native daemon autostart.
`cua-driver autostart enable`	Register the autostart entry.
`cua-driver autostart disable`	Remove the autostart entry.
`cua-driver autostart status`	Print whether autostart is registered and running.
`cua-driver autostart kick`	Start the autostart entry now without re-logging.
`cua-driver permissions`	Inspect or raise macOS TCC permission grants (macOS only).
`cua-driver permissions status`	Report Accessibility and Screen Recording status through a running daemon (read-only, no prompt).
`cua-driver permissions grant`	Launch CuaDriver through LaunchServices so the permission prompts are attributed to the app.
`cua-driver doctor`	Run platform-aware diagnostic probes.
`cua-driver diagnose`	Print a pasteable install-layout and permission-attribution report.
`cua-driver config`	Read or mutate persistent driver configuration.
`cua-driver config show`	Print the full config.
`cua-driver config get`	Print one config key.
`cua-driver config set`	Set one config key.
`cua-driver config reset`	Reset config to defaults.
`cua-driver telemetry`	Inspect or change content-free product telemetry.
`cua-driver telemetry enable`	Persistently enable telemetry.
`cua-driver telemetry disable`	Persistently disable every telemetry request.
`cua-driver telemetry status`	Show the effective setting and redacted identity state.
`cua-driver telemetry reset-id`	Erase the installation ID and event markers.
`cua-driver telemetry inspect`	Build a fixed event payload without sending it.
`cua-driver cursor-theme`	Validate, compile, inspect, preview, install, or remove a local cursor theme.
`cua-driver cursor-theme validate`	Validate a bounded dotLottie source archive.
`cua-driver cursor-theme build`	Compile a validated dotLottie archive into a bounded .cua-theme artifact.
`cua-driver cursor-theme inspect`	Inspect metadata in a compiled .cua-theme artifact.
`cua-driver cursor-theme preview`	Render a compiled theme's representative still frames to a directory.
`cua-driver cursor-theme install`	Install a compiled theme into the current user's theme store.
`cua-driver cursor-theme list`	List the built-in and installed cursor themes.
`cua-driver cursor-theme uninstall`	Remove a custom theme from the current user's theme store.
`cua-driver cursor`	Configure a session's agent cursor from the command line.
`cua-driver cursor motion`	Set the cursor's motion style, timing and effects.
`cua-driver check-update`	Check whether a newer cua-driver release is available.
`cua-driver update`	Check for an update and optionally apply it.
`cua-driver channel`	Inspect or change the stable/nightly update channel.
`cua-driver channel status`	Show selected and current release channels.
`cua-driver channel set`	Save stable or nightly as the update channel.

Skills, recording and history#

The agent skill pack, signed extensions and the perception parser; trajectory recording; the Computer History preview. Reference.

Command	Description
`cua-driver skills`	Install, update, inspect, or remove the optional agent skill pack.
`cua-driver skills install`	Fetch the versioned skill pack and link detected agents.
`cua-driver skills update`	Refresh the local skill pack and links.
`cua-driver skills uninstall`	Remove agent skill links.
`cua-driver skills status`	Report local skill-pack and per-agent link state.
`cua-driver skills path`	Print the local skill-pack path.
`cua-driver extension`	Inspect and manage signed, target-specific optional extensions.
`cua-driver extension list`	List registry-known extensions and local state.
`cua-driver extension info`	Compatibility alias for installed extension status.
`cua-driver extension inspect`	Verify and preview license, source, provenance, and hashes without mutation.
`cua-driver extension status`	Verify installed integrity and optionally run the self-test hook.
`cua-driver extension install`	Verify, stage, and durably activate an extension.
`cua-driver extension update`	Verify and atomically activate a newer extension version.
`cua-driver extension remove`	Remove only a fully validated, manager-owned extension tree.
`cua-driver extension path`	Compatibility command that prints the exact active version directory.
`cua-driver perception`	Parse a local PNG with the installed optional perception extension.
`cua-driver perception parse`	Parse one local PNG into canonical visual regions.
`cua-driver recording`	Control trajectory recording on a running daemon.
`cua-driver recording start`	Start trajectory recording to a directory.
`cua-driver recording stop`	Stop trajectory recording.
`cua-driver recording status`	Print the current recording state.
`cua-driver recording render`	Render a recorded trajectory directory to an MP4.
`cua-driver history`	Encrypted, metadata-only Computer History early preview: lifecycle and local inspection.
`cua-driver history enable`	Turn on the Computer History preview (admits it on a local daemon if needed).
`cua-driver history disable`	Turn Computer History off; recorded chunks stay until deleted.
`cua-driver history pause`	Pause recording without turning the preview off.
`cua-driver history resume`	Resume recording after pause.
`cua-driver history status`	Print the Computer History state.
`cua-driver history flush`	Seal the current chunk to disk now.
`cua-driver history list`	List recent metadata-only events.
`cua-driver history show`	Print one event by its sequence number.
`cua-driver history delete`	Delete the encrypted chunks and their native credential-store key.

Global options#

--help prints help for any command; --version prints the version.

Exit codes#

Code	Meaning
`0`	Success.
`1`	Failure: the daemon is not running or is incompatible, a tool call returned an error, or the operation failed. `call` and direct tool invocations exit with the daemon's result code (1 on a tool error); `update --apply` passes through the installer's status.
`2`	Invalid input: tool arguments that are not valid JSON, an unknown `mcp-config` client, or an `update --apply` refused on a local development install.
`64`	Usage error: an unknown or missing subcommand or argument, or conflicting flags (for example `revoke` without exactly one of `--session` or `--all`, or an authorization flag passed to `mcp`).