cloudflare-kv:setup

/cloudflare-kv:setup - Interactive KV Namespace Setup

This command guides through the complete setup process for Cloudflare Workers KV namespaces.

What This Command Does

1. Creates KV Namespaces

   • Production namespace
   • Preview namespace (for testing)
   • Generates unique IDs for both

2. Configures wrangler.jsonc

   • Adds KV namespace bindings
   • Sets up preview environment
   • Creates config if needed

3. Generates TypeScript Types

   • Env interface with KV bindings
   • Type-safe Worker code examples

4. Tests Connection

   • Validates configuration
   • Performs basic CRUD operations
   • Verifies namespace accessibility

How to Use

Interactive Mode (Recommended)

Run the command and follow prompts:

/cloudflare-kv:setup

The command will:

1. Ask for namespace name (e.g., "MY_KV" or "USER_DATA")
2. Create production and preview namespaces
3. Generate wrangler.jsonc configuration
4. Provide TypeScript setup examples
5. Offer to run connection tests

With Namespace Name

Provide namespace name upfront:

/cloudflare-kv:setup MY_NAMESPACE

Implementation

Execute the setup script from the cloudflare-kv skill:

${CLAUDE_PLUGIN_ROOT}/scripts/setup-kv-namespace.sh [namespace-name]

The script will:

• Check wrangler CLI installation
• Verify authentication status
• Create namespaces via wrangler API
• Extract namespace IDs
• Generate configuration snippets
• Optionally create/update wrangler.jsonc

Prerequisites

Before running this command, ensure:

1. Wrangler CLI Installed

   npm install -g wrangler
   

2. Authenticated with Cloudflare

   wrangler login
   

3. Active Cloudflare Account

   • Workers plan enabled
   • API access configured

Example Output

Cloudflare Workers KV - Namespace Setup Wizard
================================================

Creating KV namespaces for: MY_KV_NAMESPACE

Step 1: Creating production namespace...
✓ Production namespace created
   ID: a1b2c3d4e5f6789012345678901234ab

Step 2: Creating preview namespace...
✓ Preview namespace created
   ID: b2c3d4e5f6789012345678901234abc1

✓ Namespaces created successfully!

Step 3: Generating wrangler.jsonc configuration...

Add this to your wrangler.jsonc:

  "kv_namespaces": [
    {
      "binding": "MY_KV_NAMESPACE",
      "id": "a1b2c3d4e5f6789012345678901234ab",
      "preview_id": "b2c3d4e5f6789012345678901234abc1"
    }
  ]

Step 4: TypeScript type definition example...

Add this to your Worker code for TypeScript support:

type Env = {
  MY_KV_NAMESPACE: KVNamespace;
};

✓ Setup complete!

Next steps:
1. Ensure wrangler.jsonc has the KV namespace configuration
2. Use env.MY_KV_NAMESPACE in your Worker code
3. Test with: wrangler dev