The full history is in CHANGELOG.md in the repo, which follows Keep a Changelog. The project uses Semantic Versioning, and before 1.0 a minor version can break the config or the control-plane API.
Recent releases
| Version | Date | Main changes |
|---|---|---|
| 0.2.5 | 2026-11-10 | A slow provider container is restarted automatically. Dispatch starts 2 processes for a job, not 25. New option providerInstance. status and doctor answer when the provider is slow |
| 0.2.4 | 2026-11-03 | init stops instead of overwriting an existing Worker from a new folder. New flag --adopt |
| 0.2.3 | 2026-11-03 | Default Amp provider name is cloudflare. init prints what to back up. New guide: Back up and restore |
| 0.2.2 | 2026-11-03 | init names the Amp token page and warns on a fallback provider name. Internal codes removed from shipped comments. Example config lists 4 more keys |
| 0.2.1 | 2026-11-02 | Fix: cf-orbs doctor reads the provider Dockerfile from the source when templates are not built |
| 0.2.0 | 2026-11-02 | init --no-deploy (Workers Builds, no Docker). init --name. Plan check and orb self-test in init. New doctor file checks. upgrade --no-deploy |
| 0.1.1 | 2026-11-02 | Fix: bin path in package.json |
| 0.1.0 | 2026-11-02 | First public release. Warm pause, prewarm, huge pages, fastTmpfsGb, projectSnapshotRefresh, snapshots prune, init --vcpu |
Upgrade notes
To upgrade from 0.1.x to 0.2.x, run npx cf-orbs@latest upgrade or npx cf-orbs@latest deploy. The config doesn’t change and paused orbs survive. The provider restarts once, and only if its image changed. See Upgrade.
Releases are on GitHub and the cf-orbs package is on npm.