June 17th, 2025
We’ve just released a new major version of the CLI (v6.0.0) with a number of exciting improvements. Here’s what’s new:
We’ve introduced a new construct called CheckGroupV2 (replacing the now-deprecated CheckGroup) that makes working with groups more flexible and intuitive.
In Checkly, groups help you organize checks together and apply shared configuration — like where checks run, how often they run, or how alerts are sent. Previously, certain group level settings (runParallel
, locations
, alertEscalationPolicy
, and retryStrategy
) were always enforced. Every check in a group automatically inherited the group’s values for these settings, with no way to opt out.
With CheckGroupV2, these settings are now optional. Groups can now act more like folders, with zero config shared.
👉 Read the change log on groups to learn more.
We’ve improved how the CLI processes Constructs behind the scenes. This comes with better error reporting (see multiple issues at once), faster CLI performance and more meaningful filtering (only bundles the checks you need).
⚠️ This change is backward-compatible, but there are a few edge cases to watch out for:
If you’ve created custom Constructs (e.g. by extending ours), you may need to update your implementation.
If your code accesses low-level or internal fields directly from constructs, those fields might now be moved to the bundled output.
If your code depends on construct errors being thrown right away (e.g. during new ApiCheck()), that’s changed — errors now show up later during processing.
Most users won’t be impacted, but custom tooling or advanced integrations may need updating. If you have any questions or would like to learn more, don’t hesitate to reach out to support.
The CLI now deduplicates shared files across checks. If multiple checks reference the same files, those files will only be uploaded once, reducing overall upload size. This change makes deployments more efficient and also allows far more checks to be deployed within the same project.
Update to the latest version with: npm install checkly@latest
.
Check out the CLI documentation or swing by the CLI repository for more details.
Questions or feedback? Join our Slack community or reach out to support. We’re here to help!