Checkly CLI Changelog

Release notes for the Checkly command-line interface. For installation and usage, see the CLI documentation.

Check your current version:

checkly --version

Update to the latest version:

npm install checkly@latest

Fixed

• Fix Playwright Test crash when importing date-fns. Disable tree-shaking for ESM bundling

Runtime support: 2025.04

Added

• Support for runtime 2025.04

Fixed

• Ensure we exclude __checks__ build directory from the file watcher

Fixed

• Allow nested projects in monorepos by using a stable Playwright Test cache folder. The cache folder will be placed in checkly.config.ts’s directory

Changed

• Extract and handle Playwright Test annotations in runtime 2025.04, allowing @playwright/test test runs with .skip and .only annotations

Fixed

• Fix passing env vars into testSessions

Fixed

• Update axios to fix the “Cannot set headers after they are sent to the client” errors

Fixed

• Build correct external list for esbuild. Exclude all dependencies, include devDependencies

Fixed

• Fix external bundling options so Node dependencies can be excluded correctly

Fixed

• Add missing location details to global result when using test sessions (in the CLI)

Added

• Add AlertEscalationPolicy, allowing the configuration of multi-channel alerts

Fixed

• Fix the usage of the checklyPropsPath option for check resources

Added

• Update the CLI with the improved Pagerduty v2 integration

Fixed

• Increase server shutdown timer to avoid sudden connection closes while reporting results back

Added

• Add runParallel, which replaces runInParallel

Deprecated

• runInParallel is deprecated and will be removed in a future version. Please use runParallel instead

Added

• Support testMatch for Monitoring as Code projects

Added

• Support for the api-only project type in the test command

Added

• Add syncOnDeploy option to opt out of syncing Terraform resources

Fixed

• Export testSessionId from Checkly

Added

• Add test session support to group results from a single test run

Added

• Add support for Multistep check test-only mode

Fixed

• Fix missing named export from CLI constructs (defineConfig)

Breaking Changes

• The --list flag has been repurposed from listing all checks to listing all resources
• Private location slugs now require the prefix private- to match the API behavior
• The --record flag now has no effect on Browser or Multistep checks
• The constructs are now built using TypeScript v5

Added

• Heartbeat monitoring support
• New Playwright Test runner (@playwright/test)
• Standardized config file with defineConfig
• Support for browser checks created from @playwright/test files
• Support for .only & .skip annotations in check files

Changed

• Support Node 22 when using runtime 2025.04
• The init command is now deprecated in favor of scaffolding

Added

• Support for external check IDs

Runtime support: 2024.02

Breaking Changes

• Node.js 16 is no longer supported

Added

• Support for runtime 2024.02

Added

• Support for connectTimeout in API check defaults

Added

• Add --tags filter to checkly test command

Added

• Add support for cookies prop on API checks

Added

• Add support for headers in Multistep checks

Added

• Support for pathName and followRedirects on API checks

Added

• Add support for new alerting reminders
• Add support for snapshot testing

Runtime support: 2023.09

Added

• Support for runtime 2023.09

Added

• Support for retryStrategy on checks
• Support for checkRunId in browser checks

Runtime support: 2023.02

Breaking Changes

• The checkly test command now runs location-based scheduling by default
• Default runtime changed to 2023.02

Added

• Support for runtime 2023.02
• Support for missing response and request properties on API checks

Before upgrading major versions:

1. Review breaking changes in release notes
2. Test in a non-production environment
3. Update configuration files as needed
4. Run checkly test to verify compatibility

• All releases: View complete history on GitHub releases
• Major updates: See summarized releases in the product changelog

• Join the developer community for discussions
• Contact support for assistance

Checkly Changelog Private Locations Agent Changelog

Last updated on July 21, 2025. You can contribute to this documentation by editing this page on Github