Auth CLI (@foundation0/auth-cli)

What this CLI is for

The canonical CLI binary is auth.

• CLI reference: docs/reference/cli/index.md

Install

pnpm add -D @foundation0/auth-cli

Command groups

Grouped command families:

• capabilities: issue and delegate capabilities
• verify: validate tokens and bound operations
• receipts: verify signed receipts
• services: publish and resolve service descriptors
• revocations: publish and check revocations
• pricing: fetch pricing artifacts
• sidecar: call the verification sidecar APIs
• batches: build, verify, and export receipt batches
• release: validate and generate release artifacts
• data: run deletion and erasure workflows

Common workflows

auth --help
auth verify token --help
auth services resolve --help

JSON mode

Use --json for automation-safe output.

auth verify token --capability "$TOKEN" --service-pid eip155:1:0xabc --json

Automation paths should prefer auth and can combine --json, --quiet, or --non-interactive as needed.

Docs and examples

• CLI quickstart
• CLI reference
• Operator workflows guide
• Validated CLI publish example

Compatibility

Compatibility aliases remain advisory only. New installs and automation should use @foundation0/auth-cli and the auth binary, while legacy ADL naming is kept only where migration coverage still needs it.

Automation example

auth sidecar verify \
  --service-pid eip155:1:0xabc \
  --token-b64url "$TOKEN" \
  --base-url https://sidecar.example.com \
  --json