cloudflare-images:check

Check Cloudflare Images Configuration

Run a complete health check of your Cloudflare Images setup including API connectivity, authentication, transformations, variants, and quota.

What This Command Does

When you run /check-images, Claude will:

1. Verify environment variables are set correctly
2. Test API connectivity
3. Validate authentication (account ID + API token)
4. Check if transformations are enabled for zone
5. List all configured variants
6. Show storage quota and usage
7. Display recent images
8. Verify CDN caching status

Usage

/check-images

No arguments required - the command will automatically discover configuration from environment variables.

Implementation

Run the following checks in sequence:

1. Verify Environment Variables

echo "📋 Checking environment variables..."

if [ -z "$CF_ACCOUNT_ID" ]; then
  echo "❌ CF_ACCOUNT_ID not set"
  echo "   Set in .env: CF_ACCOUNT_ID=your_account_id"
  exit 1
else
  echo "✅ CF_ACCOUNT_ID: ${CF_ACCOUNT_ID:0:8}..."
fi

if [ -z "$CF_API_TOKEN" ]; then
  echo "❌ CF_API_TOKEN not set"
  echo "   Set in .env: CF_API_TOKEN=your_api_token"
  exit 1
else
  echo "✅ CF_API_TOKEN: ${CF_API_TOKEN:0:10}..."
fi

if [ -z "$CF_ACCOUNT_HASH" ]; then
  echo "⚠️  CF_ACCOUNT_HASH not set (optional for delivery URLs)"
else
  echo "✅ CF_ACCOUNT_HASH: ${CF_ACCOUNT_HASH}"
fi

echo ""

2. Test API Connectivity

echo "🔌 Testing API connectivity..."

API_RESPONSE=$(curl -s -o /dev/null -w "%{http_code}" \
  "https://api.cloudflare.com/client/v4/accounts/${CF_ACCOUNT_ID}/images/v1" \
  -H "Authorization: Bearer ${CF_API_TOKEN}")

if [ "$API_RESPONSE" = "200" ]; then
  echo "✅ API connectivity: OK"
else
  echo "❌ API connectivity failed (HTTP $API_RESPONSE)"
  echo "   Verify CF_ACCOUNT_ID and CF_API_TOKEN are correct"
  exit 1
fi

echo ""

3. Validate Authentication

echo "🔑 Validating authentication..."

AUTH_RESULT=$(curl -s \
  "https://api.cloudflare.com/client/v4/accounts/${CF_ACCOUNT_ID}/images/v1" \
  -H "Authorization: Bearer ${CF_API_TOKEN}")

AUTH_SUCCESS=$(echo "$AUTH_RESULT" | jq -r '.success')

if [ "$AUTH_SUCCESS" = "true" ]; then
  echo "✅ Authentication: Valid"

  # Check permissions
  IMAGES_COUNT=$(echo "$AUTH_RESULT" | jq -r '.result.images | length')
  echo "   Images accessible: $IMAGES_COUNT"
else
  echo "❌ Authentication failed"
  ERRORS=$(echo "$AUTH_RESULT" | jq -r '.errors[].message')
  echo "   Error: $ERRORS"
  exit 1
fi

echo ""