Skills and extensions
The agent skill pack, signed extensions and the perception parser.
The agent skill pack, signed extensions and the perception parser.
| 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. |
Every command also accepts the global options.
cua-driver skills#Install, update, inspect, or remove the optional agent skill pack.
The install script never touches agent skill directories automatically.
cua-driver skills [COMMAND]Without a subcommand, runs cua-driver skills status.
Examples
# Report skill-pack state
cua-driver skillscua-driver skills install#Fetch the versioned skill pack and link detected agents.
cua-driver skills install [OPTIONS]| Flag | Type | Default | Description |
|---|---|---|---|
--from | string | Fetch from the main branch instead of the tagged release. Only main is accepted; write it as --from=main. | |
--all-platforms | boolean | false | Keep platform-specific skill files for every platform. |
--force | boolean | false | Re-fetch the skill pack even when the local copy is current. |
Examples
# Install the skill pack and link detected agents
cua-driver skills install
# Install the latest skill pack from main
cua-driver skills install --from=maincua-driver skills update#Refresh the local skill pack and links.
Always re-fetches; takes the same options as install.
cua-driver skills update [OPTIONS]| Flag | Type | Default | Description |
|---|---|---|---|
--from | string | Fetch from the main branch instead of the tagged release. Only main is accepted; write it as --from=main. | |
--all-platforms | boolean | false | Keep platform-specific skill files for every platform. |
Examples
# Refresh the skill pack and links
cua-driver skills updatecua-driver skills uninstall#Remove agent skill links.
cua-driver skills uninstall [OPTIONS]| Flag | Type | Default | Description |
|---|---|---|---|
--all | boolean | false | Also delete the local skill-pack copy. |
Examples
# Remove the links and the local copy
cua-driver skills uninstall --allcua-driver skills status#Report local skill-pack and per-agent link state.
cua-driver skills statusExamples
# Report skill-pack and link state
cua-driver skills statuscua-driver skills path#Print the local skill-pack path.
cua-driver skills pathExamples
# Print the skill-pack path
cua-driver skills pathcua-driver extension#Inspect and manage signed, target-specific optional extensions.
Verified installs bind a pinned publisher identity and Ed25519 key validity/rotation state to exact catalog, archive, manifest, file, original-model, and converted-model hashes plus component licenses/notices and corresponding-source revisions. Inspect previews license, source, and provenance before mutation. Explicit developer-only unsigned installs remain visibly unverified. Install, update, and remove use platform-specific ownership and link/reparse-point checks on macOS, Linux, and Windows.
cua-driver extension [COMMAND]Without a subcommand, runs cua-driver extension list.
Examples
# List known extensions
cua-driver extension listcua-driver extension list#List registry-known extensions and local state.
cua-driver extension list [OPTIONS]| Flag | Type | Default | Description |
|---|---|---|---|
--json | boolean | false | Emit machine-readable output. |
Examples
# List extensions as JSON
cua-driver extension list --jsoncua-driver extension info#Compatibility alias for installed extension status.
cua-driver extension info [OPTIONS] <name>| Argument | Type | Default | Description |
|---|---|---|---|
<name> | string | required | Registry extension name. |
| Flag | Type | Default | Description |
|---|---|---|---|
--json | boolean | false | Emit machine-readable output. |
Examples
# Show an installed extension
cua-driver extension info cua-perceptioncua-driver extension inspect#Verify and preview license, source, provenance, and hashes without mutation.
cua-driver extension inspect [OPTIONS] <name>| Argument | Type | Default | Description |
|---|---|---|---|
<name> | string | required | Registry extension name. |
| Flag | Type | Default | Description |
|---|---|---|---|
--catalog | path | Signed local catalog. | |
--archive | path | Developer-only unsigned local archive. | |
--allow-unsigned-local | boolean | false | Explicitly select developer-only unverified mode. |
--json | boolean | false | Emit machine-readable output. |
Examples
# Preview license, source and provenance
cua-driver extension inspect cua-perception --catalog catalog.jsoncua-driver extension status#Verify installed integrity and optionally run the self-test hook.
cua-driver extension status [OPTIONS] [<name>]| Argument | Type | Default | Description |
|---|---|---|---|
<name> | string | optional | Optional registry extension name. |
| Flag | Type | Default | Description |
|---|---|---|---|
--self-test | boolean | false | Run the extension self-test hook. |
--json | boolean | false | Emit machine-readable output. |
Examples
# Verify an extension and run its self-test
cua-driver extension status cua-perception --self-testcua-driver extension install#Verify, stage, and durably activate an extension.
Supported on macOS, Linux, and Windows with platform ownership and link/reparse-point checks.
cua-driver extension install [OPTIONS] <name>| Argument | Type | Default | Description |
|---|---|---|---|
<name> | string | required | Registry extension name. |
| Flag | Type | Default | Description |
|---|---|---|---|
--catalog | path | Signed local catalog. | |
--archive | path | Developer-only unsigned local archive. | |
--allow-unsigned-local | boolean | false | Explicitly select developer-only unverified mode. |
Examples
# Install from a signed catalog
cua-driver extension install cua-perception --catalog catalog.jsoncua-driver extension update#Verify and atomically activate a newer extension version.
Supported on macOS, Linux, and Windows with platform ownership and link/reparse-point checks.
cua-driver extension update [OPTIONS] <name>| Argument | Type | Default | Description |
|---|---|---|---|
<name> | string | required | Registry extension name. |
| Flag | Type | Default | Description |
|---|---|---|---|
--catalog | path | Signed local catalog. | |
--archive | path | Developer-only unsigned local archive. | |
--allow-unsigned-local | boolean | false | Explicitly select developer-only unverified mode. |
Examples
# Activate a newer version
cua-driver extension update cua-perception --catalog catalog.jsoncua-driver extension remove#Remove only a fully validated, manager-owned extension tree.
Supported on macOS, Linux, and Windows with platform ownership and link/reparse-point checks.
cua-driver extension remove <name>| Argument | Type | Default | Description |
|---|---|---|---|
<name> | string | required | Registry extension name. |
Examples
# Remove an extension
cua-driver extension remove cua-perceptioncua-driver extension path#Compatibility command that prints the exact active version directory.
cua-driver extension path <name>| Argument | Type | Default | Description |
|---|---|---|---|
<name> | string | required | Registry extension name. |
Examples
# Print the active version directory
cua-driver extension path cua-perceptioncua-driver perception#Parse a local PNG with the installed optional perception extension.
This read-only local-input mode does not create a Driver capture. Its visual-regions JSON marks the result ineligible for Driver action authority.
cua-driver perception <COMMAND>Examples
# Parse a PNG into visual regions
cua-driver perception parse --image screen.png --capture capture.json --jsoncua-driver perception parse#Parse one local PNG into canonical visual regions.
Requires --json. The capture file supplies source metadata only.
cua-driver perception parse [OPTIONS]| Flag | Type | Default | Description |
|---|---|---|---|
--image | path | required | Local PNG path. |
--capture | path | required | Local capture source metadata JSON path. |
--json | boolean | false | Emit canonical visual-regions JSON with local-input provenance. |
Examples
# Parse a PNG into visual regions
cua-driver perception parse --image screen.png --capture capture.json --json| 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). |