Wrangler CLI Cheatsheet

Learning Focus

A quick reference guide for the most common wrangler commands used in daily development and operations.

General & Configuration

Command	Action
wrangler login	Authenticate with your Cloudflare account
wrangler logout	Remove stored authentication credentials
wrangler whoami	Check current authenticated user and account list
wrangler init <name>	Initialize a new Worker project
wrangler config	(Deprecated) Used in older versions

Workers Development

Command	Action
wrangler dev	Start local development server (with edge connectivity)
wrangler deploy	Deploy your Worker to Cloudflare's edge
wrangler tail <worker>	Stream logs from a deployed Worker in real-time
wrangler secret put <key>	Set a secure environment variable (secret)
wrangler rollback <version>	Roll back to a specific deployment version

Cloudflare Pages

Command	Action
wrangler pages project create	Create a new Pages project
wrangler pages dev <folder>	Develop your static site locally
wrangler pages deploy <folder>	Deploy a local directory to Pages
wrangler pages deployment list	List recent Pages deployments

Storage & Databases

Workers KV (Key-Value)

• wrangler kv namespace create <name>: Create a new namespace
• wrangler kv key put <key> <value>: Write a value to KV
• wrangler kv key get <key>: Read a value from KV
• wrangler kv key delete <key>: Delete a key from KV

D1 (SQL Database)

• wrangler d1 create <name>: Create a new D1 database
• wrangler d1 execute <name> --command "SQL": Run a query
• wrangler d1 migrations create <name> <tag>: Create a new migration file
• wrangler d1 migrations apply <name>: Apply migrations to the DB

R2 (Object Storage)

• wrangler r2 bucket create <name>: Create a new R2 bucket
• wrangler r2 bucket list: List all buckets
• wrangler r2 object put <bucket>/<key> --file <path>: Upload a file
• wrangler r2 object get <bucket>/<key> --file <path>: Download a file

AI & Vectorize

Workers AI

• wrangler ai models list: List available AI models
• wrangler ai run <model>: Test a model from the CLI

Vectorize

• wrangler vectorize create <name>: Create a vector index
• wrangler vectorize query <name> --vector <values>: Query an index

Quick Snippets

Check Worker deployment info

wrangler deploy --dry-run

Run local dev without remote connectivity

wrangler dev --local

Overwrite a secret value

echo "new-secret" | wrangler secret put MY_SECRET

List all D1 databases with ID

wrangler d1 list

Key Takeaways

• wrangler dev and wrangler deploy are your primary development lifecycle tools.
• Use wrangler tail for real-time debugging of live production Workers.
• Storage commands (KV, D1, R2) use create to set up and execute/put/get for data ops.
• Secrets must be set via wrangler secret put and are NOT stored in your config file.