OpenAICloudflare Developer PlatformApr 1, 2026, 12:00 PM

Workflows, Workers - All Wrangler commands for Workflows now support local development

A condensed section focused on the key takeaways first.

Original Post

Quick Digest

Summary

A condensed section focused on the key takeaways first.

openaienmodel: gpt-5-mini-2025-08-07

Wrangler: workflows commands now support --local for local development

Key Points

  • wrangler workflows supports --local
  • Manage workflow lifecycle locally
  • --port to target specific dev session

Summary

All wrangler workflows commands now accept a --local flag to target a Workflow running in a local wrangler dev session instead of the production API. This enables full local lifecycle management — triggering workflows, listing and controlling instances, and sending events — without deploying to Cloudflare. Commands also accept --port to target a specific dev session (default: 8787).

Key Points

  • Add --local to any wrangler workflows command to operate against a local wrangler dev session.
  • Supported actions include: list, trigger, instances list, instances pause|resume|restart|terminate, and instances send-event.
  • Use --port <port> to target a non-default dev session (default: 8787).
  • Example usages: npx wrangler workflows trigger my-workflow --local or npx wrangler workflows instances pause my-workflow <INSTANCE_ID> --local.
  • Ensure a wrangler dev session is running and accessible before using --local.

Practical notes

  • This is ideal for iterative development and debugging without impacting production.
  • When sending events locally, include --type <event-type> with instances send-event.
  • Refer to the Workflows local development docs for additional details and edge cases.

Full Translation

Translations

A translation section that keeps the flow of the original article.

openaijamodel: gpt-5-mini-2025-08-07

Workflows、Workers — Workflows 用のすべての Wrangler コマンドがローカル開発に対応しました

概要

すべての wrangler workflows コマンドが --local フラグを受け付けるようになり、プロダクション API の代わりにローカルの wrangler dev セッションで実行中の Workflow を対象にできるようになりました。これにより、ワークフローのトリガー、インスタンス一覧表示、一時停止、再開、再起動、終了、イベント送信など、ワークフローのライフサイクルをローカルで完全に管理できます。

主な操作例

以下はローカル開発で使用できる主要なコマンド例です:

npx wrangler workflows list --local
npx wrangler workflows trigger my-workflow --local
npx wrangler workflows instances list my-workflow --local
npx wrangler workflows instances pause my-workflow <INSTANCE_ID> --local
npx wrangler workflows instances send-event my-workflow <INSTANCE_ID> --type my-event --local

ポート指定

すべてのコマンドは --port も受け付け、特定の wrangler dev セッションを指定できます(デフォルトは 8787)。

詳しくは Workflows local development を参照してください。