{
  "slug": "wrangler-workflows-commands-target-local-dev-with-local-9411baa6a9bb",
  "title": "wrangler workflows commands target local dev with --local",
  "tools": [
    "wrangler"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-03-31T11:12:44.000Z",
  "announced_at": "2026-03-31T11:12:44.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When developing locally, pass `--local` to a `wrangler workflows` command to target a Workflow in a running `wrangler dev` session. Add `--port <port>` when the session uses a custom port; the default is `8787`.",
    "examples": [
      "wrangler workflows list --local",
      "wrangler workflows trigger <NAME> '{\"key\":\"value\"}' --local",
      "wrangler workflows instances pause <NAME> <ID> --local --port 9000"
    ],
    "gotchas": [
      "Version: 4.79.0",
      "--local: Interact with a Workflow in a local `wrangler dev` session; the docs say this requires Wrangler 4.79.0 or greater.",
      "--port <port>: Port of the local dev session; defaults to `8787`.",
      "<NAME> (required): Workflow name.",
      "[PARAMS]: JSON string passed as parameters to the Workflow instance.",
      "<ID> (required): Workflow instance ID to pause.",
      "Prerequisite: The `--local` flag requires Wrangler 4.79.0 or greater.",
      "Prerequisite: A running `wrangler dev` session is required for local targeting.",
      "The local target is a running `wrangler dev` session.",
      "Commands continue to target remote production by default.",
      "The default dev server port is 8787."
    ]
  },
  "why_it_matters": "During local development, inspect or operate a Workflow against a running Wrangler dev session.",
  "before": "Without `--local`, Workflows commands target production.",
  "sources": [
    "https://github.com/cloudflare/workers-sdk/releases/tag/wrangler%404.79.0",
    "https://developers.cloudflare.com/workers/wrangler/commands/workflows/"
  ],
  "rank": 0.97028,
  "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-10efc07f44b4f277-1:gate",
    "evidence_hash": "ae0b2fb6a8930bf683fbc99b547f3caa2d8af980d8add3e166593187b545b87f"
  },
  "review": {
    "draft_hash": "8bdb5b70108c03635a16fb87aeeecba4b9613245ce1e1d04663efb0604288895",
    "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.97 >= 0.9; 2 needed) and Jev gave 0.77 (>= 0.6 needed)."
  }
}