Platform efficiency
Official Kody guide
Kody meters unique Dynamic Worker days so Cloudflare isolate cost is visible by surface. This page states that cost model once. Playbook README and AGENTS.md files do not repeat it.
Unique worker days
Cloudflare bills unique Dynamic Worker isolates (a worker id) per UTC
day. Kody records that unit as the unique_worker_days / dynamic_worker_day
meter.
- The first use of a given worker id on a UTC day counts once for that user.
- Repeating the same worker id on the same UTC day does not add another day.
- Worker identity follows the module graph for that run: the same saved graph reuses one isolate; a different graph is a different isolate.
Each plan includes a monthly unique-worker-day allotment. Public-ladder overage
uses the published unique-worker-day rate on
Pricing. Account usage (/account/usage and
usageGet) reports the meter with what counts.
Surfaces
The same meter is tagged with the surface that minted the isolate:
| Surface | Typical mint |
|---|---|
execute | Ad hoc MCP / capability execute |
job | Playbook-owned scheduled or jobRunNow work |
playbook_export | A saved-playbook export invocation |
workflow | A Cloudflare Workflow run |
subscription | A playbook subscription handler |
app_fetch / app_realtime | A playbook app HTTP or websocket isolate |
retriever / webhook | Search retrievers and inbound webhooks |
Saved playbooks, jobs, and other durable surfaces reuse a stable isolate when
the saved module graph stays the same. Ad hoc execute identity follows the
module graph of that execute run.
Choosing a surface
Search first, then pick the smallest durable home that matches the work:
- A built-in capability or an existing saved-playbook export, called from
executeor another playbook. - A saved playbook when the behavior will be reused, scheduled, tested, or evolved — see Playbook lifecycle and Playbook authoring.
- A workflow for durable multi-step or deferred work.
execute is the exploration and composition surface. Durable named behavior
lives in a playbook so later runs share that playbook's module graph.
Related
- Execute and workflows
- Plans and pricing
- Contributor metering schema: Usage metering