Reference

CLI

adc manages your account and calls tools from anywhere. adc-node configures the device it runs on. Both ship with the connector installer.

Install the CLI only

On a machine that should call tools but not be a device, install without pairing:

macOS / Linux

curl -fsSL https://adc.zioon.tech/install.sh | sh -s -- --cli-only
adc --version

Add --json to any command for machine-readable output. Exit code 1 means the service returned an error (JSON on stderr); 2 means a usage or local error. Run adc --help or adc-node --help for every option.

Sign in and connect

adc login manages your account. adc connect creates the credential an agent uses for tools.

adc

adc login --url https://adc.zioon.tech
adc status
adc connect ACCESS [--name NAME] [--expires DAYS]
adc connection list
adc logout

Devices

adc

adc device add [--name NAME] [--platform unix|windows|wsl]
adc device list
adc device show DEVICE
adc device update DEVICE [--folders all|none|LIST] [--read-only LIST] [--execution on|off]
adc device wait DEVICE [--timeout SECONDS]
adc device remove DEVICE --yes

Agent access

adc

adc access create --name NAME --devices LIST [--folders all|none|LIST]
                  [--capabilities read|write|run|templates]
                  [--approval never|writes|execute|always]
adc access list
adc access show ACCESS
adc access update ACCESS [same options as create]
adc access revoke ACCESS --yes

Tools and tasks

Calls that change something need --idempotency-key. --wait waits up to 30000 ms for a result.

adc

adc tool list
adc tool show TOOL
adc invoke TOOL --args JSON [--node DEVICE] [--wait [MS]] [--idempotency-key KEY]
adc invocation status INVOCATION
adc task wait JOB [--wait MS]
adc task status|result|cancel JOB

Approvals and activity

adc

adc approval list
adc approval approve|deny APPROVAL
adc audit list
adc audit show INVOCATION

Teams and sharing

adc

adc team list | create --name NAME
adc team invite TEAM --email EMAIL [--role member|admin]
adc share create DEVICE --email EMAIL --scope SCOPE.json [--days 30]
adc invitation accept INVITATION --yes

On the device: adc-node

adc-node

adc-node status | logs | restart
adc-node access none|selected|home|full
adc-node roots add FOLDER [--label NAME] [--read-only]
adc-node roots list | remove ROOT_ID
adc-node templates add ID --root ROOT_ID --command COMMAND
adc-node mcp add ID --stdio COMMAND | --http URL
adc-node sharing on|off
adc-node unpair --confirm NODE_ID
adc-node uninstall

DEVICE, ACCESS and FOLDER accept an exact ID or an unambiguous name or path.