CLI reference

golain orgs list [--page=N] [--limit=N]

golain projects list
golain projects create --name=myproject [--region=us-east-1] [--hosting-platform=aws]

golain fleets list [--page=N] [--limit=N]
golain fleets create --name=myfleet [--description="..."]
golain fleets delete <name-or-id> [--yes]

golain devices list --fleet=<name-or-id> [--connected=true|false] [--page=N] [--limit=N]
golain devices get <name-or-id> --fleet=<name-or-id>
golain devices create --name=sensor-01 --fleet=<name-or-id> [--type=mqtt]
golain devices delete <name-or-id> --fleet=<name-or-id> [--yes]
golain devices mqtt-details <name-or-id> --fleet=<name-or-id>
golain devices issue-cert <name-or-id> --fleet=<name-or-id> [--algorithm=rsa|ecdsa] [--output-dir=PATH]

# Device tags
golain devices tags list <device> --fleet=<name-or-id>
golain devices tags add  <device> --fleet=<name-or-id> --tags=prod,region-eu
golain devices tags remove <device> --fleet=<name-or-id> --tags=prod

golain tags list [--page=N] [--limit=N]
golain tags create --name=prod
golain tags delete <name-or-id> [--yes]

golain ota releases list [--page=N] [--limit=N]
golain ota releases create --name=v1.2.0 [--device-types=esp32,stm32]
golain ota releases delete <name-or-id> [--yes]

golain ota deployments list --release=<name-or-id> [--page=N] [--limit=N]
golain ota deployments create --name=deploy-01 --release=<name-or-id> \
  [--target-tags=prod,eu] [--target-fleets=fleet-a] [--target-devices=dev-01] \
  [--max-retries=3] [--retry-interval=60] [--scheduled-at=2025-06-01T00:00:00Z]

golain ota deployments trigger <name-or-id> --release=<name-or-id> [--yes]
golain ota deployments cancel  <name-or-id> --release=<name-or-id> [--yes]
golain ota deployments delete  <name-or-id> --release=<name-or-id> [--yes]

golain integrations accounts list [--page=N] [--limit=N]
golain integrations bindings list [--page=N] [--limit=N]

golain users list [--email=user@example.com] [--permission=owner|admin|member|viewer] [--page=N] [--limit=N]

golain events list                            # audit (default)
golain events list --source=mqtt
golain events list --source=tsdb
golain events list --source=audit --page=2 --limit=100

golain events watch
golain events watch --device=<uuid>
golain events watch --replay-since=2025-06-01T00:00:00Z

golain omega scaffold \
  --device=<name-or-id> \
  --fleet=<name-or-id> \
  [--org --project --arch --db-path --sample-db --verify-tables --out --channel --transport]

golain context set --org=my-org --project=my-project
golain    # TUI → Edge Sync

# List registry schema reviews (v2 primary path)
curl -s -H "Authorization: Bearer $TOKEN" -H "ORG-ID: $ORG_ID" \
  "$API/core/api/v1/projects/$PROJECT_ID/edge/registry-reviews?status=queued"

# Claim + approve (production: supply full column_actions from registry schema)
curl -s -X POST -H "Authorization: Bearer $TOKEN" -H "ORG-ID: $ORG_ID" \
  -H "Idempotency-Key: $(uuidgen)" \
  "$API/core/api/v1/projects/$PROJECT_ID/edge/registry-reviews/$REVIEW_ID/claim"

golain version [--check]
golain upgrade [--force] [--allow-downgrade]
golain channel get
golain channel set --name=stable|latest|dev
golain doctor
golain report [--open]

golain completions bash|zsh|fish
golain login [--profile=NAME]
golain logout [--profile=NAME]
golain whoami
golain profiles
golain context set --org=X [--project=Y]
golain context get
golain context unset [--org] [--project]
golain env get
golain env set --name=production|staging|local

# JSON lines for jq processing
golain --output=jsonl devices list --fleet=sensors

# Create and capture ID
ID=$(golain --output=json devices create --name=test-01 --fleet=sensors | jq -r .id)

# Non-interactive destructive ops
golain --yes ota deployments trigger my-deployment --release=v1.2.0

# Scaffold Omega for CI (requires stored credentials)
golain omega scaffold --device=$ID --fleet=sensors --verify-tables --transport=tls --sample-db