Repository navigation
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 githuband--reporter jsonprint a line as each check finishes, so a slow run no longer looks stuck.- A
SlackAppAlertChannelon an account without the Checkly Slack app, and the retiredme-south-1location, are now validation errors. - Files that only
import typereaches are no longer bundled with a check. - Error messages explain MQTT connection failures and a
checkly rca runrefused 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@latestThis 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 inlocationsof checks, monitors and groups, inchecks.locations, or incli.runLocation, and the project stops compiling. - In JavaScript,
checkly validate,deploy,testandpw-testreportLocation "me-south-1" (Bahrain) is retired and can no longer run checks. Choose another location.and stop before anything reaches Checkly. --location me-south-1ontest,pw-testandtriggerfails with the same message and exit code 2.checkly importleavesme-south-1out 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-testandtriggerprintedUnable 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 runon an account with Rocky AI turned off printed onlyForbidden. It now saysRocky 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 { … } fromandexport 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 } fromis still followed. TracerouteMonitorlimits 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
IcmpMonitorthat sets onlydegradedPacketLossThresholdabove 20 is now rejected at validation; setmaxPacketLossThresholdas 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
- @carinaluise made their first contribution in #1595
- @Zeeohn and @pcbeingused333 contributed through #1597 and #1601
Full Changelog: 10.1.0...10.2.0