Skip to content

grace-cli

Operator CLI for Cyber Grace workflows — authenticate once, manage devices, and copy data across environments.

Built on top of grace-api-py, so every command delegates to the battle-tested Python client rather than reimplementing API logic.

  • Authentication

    Store credentials per environment in your OS keyring. No .env files, no copy-pasting tokens.

    Authentication guide

  • Device Management

    List, inspect, register, and update devices — with diff preview and confirmation before any mutation.

    Device guide

  • Data Transfer

    Flat entity copy or deep video transfer with child entities, device remapping, and optional GCS file sync.

    Data transfer guide

  • CLI Reference

    Full command reference auto-generated from source — always in sync with the latest release.

    CLI reference

Quick install

uv tool install grace-cli \
  --index https://us-central1-python.pkg.dev/PROJECT/python-packages/simple/

Quick taste

grace auth login --env prod          # store credentials in OS keyring
grace device list --output table     # paginated, filterable device listing
grace data copy \
  --source prod --target dev \
  --entity videos --limit 50 \
  --dry-run                          # preview what would be copied
grace data transfer \
  --source prod --target dev \
  --limit 20 --copy-files \
  --dry-run                          # deep transfer with GCS files

Get started