setup

You are verifying that the Cloudflare plugin environment is correctly set up.

Run the following checks:

1. Check cf CLI installation:

   • Run which cf or check if cf command exists
   • If not found, inform the user: "The cf CLI is not installed or not in your PATH. Please install it from github.com/ThrownLemon/cloudflare-cli"
   • If found, display the version by running cf --version

2. Check credentials configuration (without printing secrets):

   • Confirm ~/.cloudflare/.env exists: [ -f ~/.cloudflare/.env ] && echo present || echo missing
   • Confirm the required variable names are present without revealing values:

     for k in CLOUDFLARE_API_TOKEN CF_API_KEY CF_API_EMAIL CF_ACCOUNT_ID; do
       grep -q "^${k}=" ~/.cloudflare/.env 2>/dev/null && echo "$k: set in .env" || echo "$k: not in .env"
     done
     

   • Optionally check whether the variables are in the process environment ([ -n "$CLOUDFLARE_API_TOKEN" ] etc.) — again without echoing their values.
   • Never cat the .env file or print its values. Only report whether each key name exists.
   • Recommended credential path — scoped API Token: Set CLOUDFLARE_API_TOKEN to a token created at dash.cloudflare.com → My Profile → API Tokens. Scoped tokens grant only the permissions they need and can be revoked without rotating your global account. The legacy CF_API_KEY + CF_API_EMAIL pair (Global API Key) gives full account access — avoid it for new setups. CF_ACCOUNT_ID is only required by commands that target account-level resources; it is optional for zone-scoped operations.
   • If neither source has the required variables, instruct the user: "Cloudflare credentials not found. Add CLOUDFLARE_API_TOKEN=<your-scoped-token> to ~/.cloudflare/.env. If your cf CLI version requires the legacy keys, also add CF_API_KEY and CF_API_EMAIL, but prefer the token path."

3. Test API connectivity:

   • Run cf zones list --json to verify credentials work
   • If successful, display: "✓ API connectivity verified"
   • If failed, display the error and suggest checking credentials

4. Generate a status summary:

   Cloudflare Plugin Setup Status:
   
   cf CLI: [installed/not installed]
   Version: [version if available]
   Credentials: [configured/missing]
   API Connectivity: [working/failed]
   
   Zones accessible: [count of zones]
   

If any checks fail, provide clear instructions on how to fix the issue.