Skip to content

10.2.0

Latest

Choose a tag to compare

@sorccu sorccu released this 17 Nov 08:04
2b32bb6

Checkly CLI version 10.2.0 shows progress with the github and json reporters, stops a deploy before it creates alerts that cannot be delivered or checks that cannot run, and fixes how type-only imports are bundled.

  • --reporter github and --reporter json print a line as each check finishes, so a slow run no longer looks stuck.
  • A SlackAppAlertChannel on an account without the Checkly Slack app, and the retired me-south-1 location, are now validation errors.
  • Files that only import type reaches are no longer bundled with a check.
  • Error messages explain MQTT connection failures and a checkly rca run refused because Rocky AI is disabled.
  • The CLI reports crashes caused by bugs in its own code to Checkly. You can turn this off.
npm install --save-dev checkly@latest

This release has no breaking changes, but read Changes that can stop a deploy: a project that deployed with 10.1.0 can fail validation with 10.2.0.

Changes that can stop a deploy

A SlackAppAlertChannel needs the Checkly Slack app

A Slack App alert channel delivers nothing when the account has no Checkly Slack app connected, and that includes a channel deployed before the app was disconnected. checkly validate, test, pw-test and deploy now fail for a SlackAppAlertChannel with Slack destinations on such an account:

SlackAppAlertChannel 'ops-slack' needs the Checkly Slack app, which is not connected to this account, so its alerts cannot be delivered.

Hint: Connect the Checkly Slack app at https://app.checklyhq.com/accounts/<id>/settings/account/integrations, or remove the channel.

Connect the app, or remove the channel. Projects created with create-checkly from the advanced templates no longer include a Slack App channel; it is commented out with a note that it needs the app.

me-south-1 is retired

Checkly cancels every run in me-south-1 (Bahrain), so the CLI no longer accepts it:

  • In TypeScript, 'me-south-1' is no longer a valid location in locations of checks, monitors and groups, in checks.locations, or in cli.runLocation, and the project stops compiling.
  • In JavaScript, checkly validate, deploy, test and pw-test report Location "me-south-1" (Bahrain) is retired and can no longer run checks. Choose another location. and stop before anything reaches Checkly.
  • --location me-south-1 on test, pw-test and trigger fails with the same message and exit code 2.
  • checkly import leaves me-south-1 out of the code it generates.

Remove me-south-1 from your locations, or replace it with another location. No check loses coverage that worked.

New features

Progress with the github and json reporters

With --reporter github or --reporter json alone, a run printed Running N checks in <location>. and then nothing until it ended. These reporters now print a line on stderr as each check finishes, with a counter, and a line for each attempt that will be retried:

↺ folder/api.check.ts > Homepage API (2s)
✔ folder/api.check.ts > Homepage API (840ms) (1 retry) [12/115]

stdout, the GitHub markdown summary and the JSON report are unchanged. When list, dot or ci runs in the same command, they print the progress instead, so no check is listed twice. --reporter list,json and github,json no longer print the Running N checks line twice.

Crash reports

The CLI now sends a report to Checkly when it crashes because of a bug in its own code. The CLI removes Checkly API keys, tokens and passwords in URLs from the report, and replaces your project and home folders. Turn it off with CHECKLY_NO_ERROR_REPORTING=1 or DO_NOT_TRACK=1. See Error reporting.

Clearer errors

  • When the CLI cannot connect to Checkly to receive check results, checkly test, pw-test and trigger printed Unable to run checks: with nothing after it. They now say that the connection failed and why:

    Unable to run checks: Could not connect to Checkly to receive check results. Please check that the internet connection is working.
    
    Details: connect ECONNREFUSED ::1:1; connect ECONNREFUSED 127.0.0.1:1
    
  • checkly rca run on an account with Rocky AI turned off printed only Forbidden. It now says Rocky AI is disabled for this account. and links to the Rocky AI settings, where an account owner can turn it on. With --output json, the error carries "code": "ERR_ROCKY_AI_DISABLED".

Fixes

  • Bundling a check no longer follows import type, export type { … } from and export type * from, because those imports never run. A check that imports types from application code no longer fails to deploy on files it never uses, such as Vue components or CSS. import { type X } from is still followed.
  • TracerouteMonitor limits default to 500 ms degraded and 1000 ms failed, as Checkly now applies, and validation rejects the same limits that Checkly rejects. Deployed monitors that left the limits unset already use these values.
  • Checks and monitors now send their default degraded and maximum limits explicitly. The values are the ones Checkly already applied, so deployed checks do not change. An IcmpMonitor that sets only degradedPacketLossThreshold above 20 is now rejected at validation; set maxPacketLossThreshold as well.
  • The GitHub reporter escapes | and line breaks in check names and file names, so they no longer break the summary table.

All pull requests

Show the 19 pull requests in this release
  • fix(cli): say when rca run fails because Rocky AI is disabled [RED-1380] [ship] by @sorccu in #1593
  • docs(cli): offer the agent skill install in the AI-first setup path [ship] by @stefanjudis in #1598
  • feat(cli): expose the construct codegen as checkly/codegen [RED-1525] [ship] by @sorccu in #1602
  • docs: mention Slack channel IDs as SlackAppAlertChannel destinations [ship] by @sorccu in #1599
  • feat(cli): refuse a SlackAppAlertChannel without the Checkly Slack app [RED-1289] [ship] by @sorccu in #1585
  • feat(cli): report crashes in the CLI's own code to Checkly [show] by @aluedeke in #1590
  • chore(deps): weekly CLI dependency update (2026-11-16) [RED-1458] [ship] by @sorccu in #1603
  • feat(cli): remove retired location me-south-1 from the constructs [FUN-1440] by @MegaMaddin in #1596
  • fix(cli): do not bundle files that only type-only imports reach [TREE-1211] [ship] by @pmallol in #1600
  • ci: run ship/show/ask auto-approval on pull_request [RED-1539] [ship] by @sorccu in #1605
  • ci: bump pinned GitHub Actions to their latest releases [ship] by @sorccu in #1604
  • fix(cli): default traceroute thresholds to 500 and 1000 ms [RED-974] [ask] by @carinaluise in #1595
  • fix(cli): escape pipes and line breaks in GitHub reporter table cells [ship] by @sorccu in #1606 (from #1601 by @pcbeingused333)
  • feat(cli): print each check as it finishes with the github reporter [ship] by @sorccu in #1607 (from #1597 by @Zeeohn)
  • feat(cli): print each check as it finishes with the json reporter [RED-1541] [ship] by @sorccu in #1609
  • feat(cli): send default degraded and max limits explicitly [RED-1540] [ship] by @sorccu in #1608
  • fix(cli): explain MQTT connection failures instead of printing an empty error [ship] by @timohuovinen in #1417
  • refactor(cli): drop the unused check limits from the shape-change paths [RED-1540] [ship] by @sorccu in #1610
  • build: move dev tooling to pnpm 12 [RED-1543] [ship] by @sorccu in #1611

New Contributors

Full Changelog: 10.1.0...10.2.0