Developers · CLI

Audit offline.
Operate locally.

aaesctl is the AAES operator CLI, with an offline path for auditors. aaescp is a separate, local control-plane CLI. AAES runs on your infrastructure.

How to get the CLIs

Request an evaluation. We send a package with aaesctl andaaescp, plus release-verification public keys and setup instructions. Those binaries are not public downloads. Any supplied test credentials or keypairs are identified as synthetic and must not be used for production; deployment signing keys are generated under your control (aaesctl keygen). A deployment bundle includes the same operator tools. Remaining setup notes ship with the package.

Start with the audit export

Verification, proof, and inspection work without a running service. These commands use a local export from your evaluation install, not a live daemon. The public sample pack on the verification page ships standalone verifier binaries instead, so aaesctlis not needed for that demonstration.

Verify

Verify the export against its public key, using trust material you hold or authenticate separately. A key supplied only alongside an export does not establish provenance by itself. Verification checks the exported sealed bytes, signatures, and chain links; it does not prove the truth of recorded claims, completeness of capture, policy correctness, enforcement effectiveness, or regulatory compliance.

aaesctl verify --export <export.jsonl> --pubkey <key.pub>

This checks record integrity. To require independent attestation, supply separately obtained witness keys or timestamp trust roots and add --require-independent. Neither an external witness nor a timestamp authority is connected in the default deployment.

aaesctl verify --export <export.jsonl> --pubkey <key.pub> \
  --witness-trust <trusted-witnesses.json> --require-independent

The witness-trust file maps trusted witness IDs to their public keys obtained separately from the export. With --require-independent, verification additionally requires supported witness or timestamp evidence validated against that separately obtained trust material. The evidence concerns the signed head within the witness or timestamp service's scope; it does not independently verify the underlying actions.

Prove

Produce the verifier's proof material for sequence 42 in this export. The output concerns the record's cryptographic relationship to the exported structure; it is not proof that the recorded action occurred, succeeded, or complied with law. Verify the resulting proof against the appropriate authenticated trust material using the release's documented procedure.

aaesctl prove --export <export.jsonl> --seq 42

Inspect

Inspect the export offline.

aaesctl inspect --export <export.jsonl>

Replace <export.jsonl> and <key.pub>with the files from your evaluation install.

Operator command groups

Use aaesctl for operator workflows. The table is a command index, not a set of complete invocations. A pipe separates available subcommands.

aaesctl command surface
GroupCommands
Capabilities, resources, and bundlesaaesctl capability add | list
aaesctl resource add | list
aaesctl bundle sign | verify | show
Identityaaesctl identity import | review | show
Grantsaaesctl grant request | approve | review | list | revoke
Freezeaaesctl freeze engage | lift | status
Secretsaaesctl secret put | list | keygen
Provisioning and surfacesaaesctl provision plan | apply | revoke | inspect | list | show
aaesctl surface add | list | show | plan | apply | revoke | inspect | budget
Retentionaaesctl retention plan | apply
Simulationaaesctl simulate
Lifecycleaaesctl lifecycle onboard | offboard
Coverage and reportingaaesctl coverage
aaesctl report
Demosaaesctl demo
aaesctl demo-platform
Packs, imports, and inventoryaaesctl pack list | show | install
aaesctl import openapi | kong | mcp
aaesctl inventory aws | azure | gcp | okta | entra
Utilities and storageaaesctl keygen
aaesctl version
aaesctl store migrate

Coverage is an AAES-defined accounting measure over the configured and captured population described by the report. It is not a measure of all enterprise agent activity, proof that bypasses are absent, or an assessment of control effectiveness or compliance. Reports state their population, the denominator each percentage is computed over, the exclusions, and the observation or enforcement rules.

Inventory and adapter checks in an evaluation use local or synthetic vendor-format sources. A live vendor tenant is a design partnership.

aaescp: a local planner

aaescp never calls a cluster or the network. Its tenant commands and planning operate locally with a registry file. An aaescp plan is a local planning result.

Inspect the local tenant registry

aaescp tenant list --registry <registry.json>

The tenant command group supports add, list,show, activate, suspend, andoffboard, with --registry <registry.json>.

Plan for a tenant

aaescp plan --registry <registry.json> --tenant acme

Here, --tenant acme selects a tenant for local planning. This is distinct from daemon API authentication, where the caller's bearer credential resolves the tenant.

Multi-call binary

Both CLIs are also available through aaes. Put the CLI name before its command.

aaes aaesctl inspect --export <export.jsonl>
aaes aaescp plan --registry <registry.json> --tenant acme

Integrating an agent?

Use the daemon API,MCP facade, orSDKs for agent integration. Remaining integration notes ship with the evaluation package.

Request an evaluation, return to the developer overview, or contact hello@aaes.ai.