{
  "slug": "wrangler-ai-search-commands-target-namespaces-e7949eeba2f1",
  "title": "wrangler ai-search commands target namespaces",
  "tools": [
    "wrangler"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-04-28T12:42:46.000Z",
  "announced_at": "2026-04-28T12:42:46.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When targeting a non-default AI Search namespace, pass `--namespace <NAMESPACE>` (or `-n`); omission uses `default`. Use `wrangler ai-search namespace` subcommands to manage namespaces directly.",
    "examples": [
      "npx wrangler ai-search list --namespace <NAMESPACE>",
      "npx wrangler ai-search create <NAME> --namespace <NAMESPACE> --type <TYPE> --source <SOURCE>",
      "npx wrangler ai-search namespace create <NAME> --description \"<DESCRIPTION>\""
    ],
    "gotchas": [
      "Version: 4.86.0",
      "<NAME> (required): Instance name for instance commands; namespace name for namespace commands.",
      "--namespace <NAMESPACE> / -n <NAMESPACE>: Selects the instance namespace; defaults to `default`.",
      "--type <TYPE>: Sets the AI Search instance source type.",
      "--source <SOURCE>: Sets the data source identifier, such as an R2 bucket name or web URL.",
      "--description <DESCRIPTION>: Sets an optional namespace description (maximum 256 characters).",
      "Prerequisite: Install Wrangler to use its CLI commands; the docs do not specify a minimum version for these commands.",
      "Namespace picker is offered only when `--namespace` is not supplied in an interactive session.",
      "Docs conflict: The official Cloudflare changelog dated June 10, 2026 describes namespace-level Wrangler commands as newly supported, later than the card's Wrangler 4.86.0 release note. The current command reference documents those commands but does not resolve the version discrepancy."
    ]
  },
  "why_it_matters": "Manage an AI Search instance in a specific namespace or manage namespaces directly.",
  "sources": [
    "https://github.com/cloudflare/workers-sdk/releases/tag/wrangler%404.86.0",
    "https://developers.cloudflare.com/ai-search/wrangler-commands/",
    "https://developers.cloudflare.com/ai-search/get-started/wrangler/"
  ],
  "rank": 0.98032,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v1+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "backfill-20261007",
    "verdict_id": "backfill-20261007:backfill-20261007-67b43bce00509ed1-0:gate",
    "evidence_hash": "500a51f3c99d02f4a6f11735e555904d1268e452de8be4f6121c48480eaa16ff"
  },
  "review": {
    "draft_hash": "81167c112fe9a07e7e069b749c333fc227e8c29481c561b687f655064c189548",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "backfill-20261007:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.98 >= 0.9; 2 needed) and Jev gave 0.81 (>= 0.6 needed)."
  }
}