{
  "slug": "wrangler-json-configures-flagship-feature-flag-bindings-146f3a876f62",
  "title": "wrangler.json configures Flagship feature flag bindings",
  "tools": [
    "wrangler"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-04-13T12:02:11.000Z",
  "announced_at": "2026-04-13T12:02:11.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When a Worker needs Flagship evaluations, add a `flagship` binding with its app ID to `wrangler.json`; set `remote` to `true` for live-service evaluation during local development. [Flagship configuration](https://developers.cloudflare.com/flagship/configuration/)",
    "examples": [
      "{\"flagship\":[{\"binding\":\"FLAGS\",\"app_id\":\"<APP_ID>\"}]}",
      "{\"flagship\":[{\"binding\":\"FLAGS\",\"app_id\":\"<APP_ID>\",\"remote\":true}]}"
    ],
    "gotchas": [
      "Version: 4.82.0",
      "binding (required): Name of the Worker environment variable used to access Flagship, such as `env.FLAGS`.",
      "app_id (required): ID of the Flagship app to bind.",
      "remote: Set to `true` for live-service evaluation during local development, per the Wrangler 4.82.0 release note.",
      "Prerequisite: Use the app ID from a Flagship app.",
      "Local development returns default values for all flag evaluations unless the binding uses `\"remote\": true`.",
      "Docs conflict: Newer Flagship configuration docs (updated June 24, 2026) say local Workers use the live Flagship app configured by `app_id` and that there is no local flag store; they do not describe `remote` for Flagship. The Wrangler 4.82.0 release note says local evaluations return defaults unless `remote: true`. Do not infer current `remote` behavior from the newer docs."
    ]
  },
  "why_it_matters": "Configure a Worker to evaluate Cloudflare Flagship feature flags during local development or against the live service.",
  "sources": [
    "https://github.com/cloudflare/workers-sdk/releases/tag/wrangler%404.82.0",
    "https://developers.cloudflare.com/flagship/configuration/"
  ],
  "rank": 0.94026,
  "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-51360db1b6352081-1:gate",
    "evidence_hash": "4c9444e438c4d559e643943b586453d175d35d29e199db2db81045b023883c32"
  },
  "review": {
    "draft_hash": "846545fc8faedd08397ab38a76d0e5292f2a29c6974b738f62cb0cb7e94cef1e",
    "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.94 >= 0.9; 2 needed) and Jev gave 0.68 (>= 0.6 needed)."
  }
}