From 7cb53f893eed10bdab444e71cdaa1be0a585b49c Mon Sep 17 00:00:00 2001 From: Simo Kinnunen Date: Sat, 24 Oct 2026 02:19:30 +0900 Subject: [PATCH 1/4] docs(cli): explain how other checkly installs hand off to the project's install [RED-757] Co-Authored-By: Claude Opus 5.5 --- cli/installation.mdx | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/cli/installation.mdx b/cli/installation.mdx index 1c3cad67..7cd703e0 100644 --- a/cli/installation.mdx +++ b/cli/installation.mdx @@ -97,6 +97,14 @@ before hand or just sign up for a new account straight from the terminal. npx checkly login ``` +## Global installs and `npx checkly@` + +Run the CLI through `npx checkly` from your project, so the CLI version is the one in your `package.json`. + +Commands that load your project (`test`, `deploy`, `trigger`, `destroy`, `validate`, `pw-test` and `import`) only work with the `checkly` package your project installs, because your checks register with that copy. Since CLI version 10.0.0, when you run one of these commands with any other installation, for example a global `npm i -g checkly`, `pnpm dlx checkly` or `npx checkly@` outside your project's `node_modules`, the CLI hands the command to your project's installation. If the two versions differ, the CLI says which version runs. To use another version, install that version in your project. + +Set `CHECKLY_NO_DELEGATION=1` to turn off the hand-off. Older global installs, and any install with the hand-off turned off, fail on projects that have their own `checkly` package with `Unable to create a construct ... outside a Checkly CLI project`. + ## Direct download If you cannot access the npm registry directly, you can also download the Checkly CLI via our CDN. From 235d79dee638aae1fc4b26c758220dfb0fe3a8fa Mon Sep 17 00:00:00 2001 From: Simo Kinnunen Date: Sat, 24 Oct 2026 12:48:26 +0900 Subject: [PATCH 2/4] docs(cli): the hand-off applies to every command [RED-757] Co-Authored-By: Claude Opus 5.5 --- cli/installation.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/cli/installation.mdx b/cli/installation.mdx index 7cd703e0..8fd139c4 100644 --- a/cli/installation.mdx +++ b/cli/installation.mdx @@ -101,7 +101,7 @@ npx checkly login Run the CLI through `npx checkly` from your project, so the CLI version is the one in your `package.json`. -Commands that load your project (`test`, `deploy`, `trigger`, `destroy`, `validate`, `pw-test` and `import`) only work with the `checkly` package your project installs, because your checks register with that copy. Since CLI version 10.0.0, when you run one of these commands with any other installation, for example a global `npm i -g checkly`, `pnpm dlx checkly` or `npx checkly@` outside your project's `node_modules`, the CLI hands the command to your project's installation. If the two versions differ, the CLI says which version runs. To use another version, install that version in your project. +Your checks only load with the `checkly` package your project installs, because they register with that copy. Since CLI version 10.0.0, when you run `checkly` from any other installation, for example a global `npm i -g checkly`, `pnpm dlx checkly` or `npx checkly@`, inside a project that has its own `checkly` package, the CLI hands the command to your project's installation, as `npx checkly` would. This applies to every command. If the two versions differ, the CLI says which version runs. To use another version, install that version in your project. Set `CHECKLY_NO_DELEGATION=1` to turn off the hand-off. Older global installs, and any install with the hand-off turned off, fail on projects that have their own `checkly` package with `Unable to create a construct ... outside a Checkly CLI project`. From e37a935e8c290be881eac402c87f89a060468f09 Mon Sep 17 00:00:00 2001 From: Simo Kinnunen Date: Sat, 24 Oct 2026 13:41:14 +0900 Subject: [PATCH 3/4] docs(cli): name package-manager equivalents of npx checkly [RED-757] Co-Authored-By: Claude Opus 5.5 --- cli/installation.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/cli/installation.mdx b/cli/installation.mdx index 8fd139c4..4b2b8651 100644 --- a/cli/installation.mdx +++ b/cli/installation.mdx @@ -99,9 +99,9 @@ npx checkly login ## Global installs and `npx checkly@` -Run the CLI through `npx checkly` from your project, so the CLI version is the one in your `package.json`. +Run the CLI through `npx checkly` from your project (or your package manager's equivalent, such as `pnpm exec checkly` or `yarn checkly`), so the CLI version is the one in your `package.json`. -Your checks only load with the `checkly` package your project installs, because they register with that copy. Since CLI version 10.0.0, when you run `checkly` from any other installation, for example a global `npm i -g checkly`, `pnpm dlx checkly` or `npx checkly@`, inside a project that has its own `checkly` package, the CLI hands the command to your project's installation, as `npx checkly` would. This applies to every command. If the two versions differ, the CLI says which version runs. To use another version, install that version in your project. +Your checks only load with the `checkly` package your project installs, because they register with that copy. Since CLI version 10.0.0, when you run `checkly` from any other installation, for example a global `npm i -g checkly`, `pnpm dlx checkly` or `npx checkly@`, inside a project that has its own `checkly` package, the CLI hands the command to your project's installation, as `npx checkly` or its equivalent would. This applies to every command. If the two versions differ, the CLI says which version runs. To use another version, install that version in your project. Set `CHECKLY_NO_DELEGATION=1` to turn off the hand-off. Older global installs, and any install with the hand-off turned off, fail on projects that have their own `checkly` package with `Unable to create a construct ... outside a Checkly CLI project`. From 21a0b0db351e19868e1fc7b2776fe5ceed89de8f Mon Sep 17 00:00:00 2001 From: Simo Kinnunen Date: Sat, 24 Oct 2026 16:22:27 +0900 Subject: [PATCH 4/4] docs(cli): the hand-off searches from the --config directory [RED-757] Co-Authored-By: Claude Opus 5.5 --- cli/installation.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/cli/installation.mdx b/cli/installation.mdx index 4b2b8651..147a99d7 100644 --- a/cli/installation.mdx +++ b/cli/installation.mdx @@ -101,7 +101,7 @@ npx checkly login Run the CLI through `npx checkly` from your project (or your package manager's equivalent, such as `pnpm exec checkly` or `yarn checkly`), so the CLI version is the one in your `package.json`. -Your checks only load with the `checkly` package your project installs, because they register with that copy. Since CLI version 10.0.0, when you run `checkly` from any other installation, for example a global `npm i -g checkly`, `pnpm dlx checkly` or `npx checkly@`, inside a project that has its own `checkly` package, the CLI hands the command to your project's installation, as `npx checkly` or its equivalent would. This applies to every command. If the two versions differ, the CLI says which version runs. To use another version, install that version in your project. +Your checks only load with the `checkly` package your project installs, because they register with that copy. Since CLI version 10.0.0, when you run `checkly` from any other installation, for example a global `npm i -g checkly`, `pnpm dlx checkly` or `npx checkly@`, inside a project that has its own `checkly` package, the CLI hands the command to your project's installation, as `npx checkly` or its equivalent would. This applies to every command. The CLI looks for your project's installation from the directory of the `--config` file if you pass one, and from the current directory otherwise. If the two versions differ, the CLI says which version runs. To use another version, install that version in your project. Set `CHECKLY_NO_DELEGATION=1` to turn off the hand-off. Older global installs, and any install with the hand-off turned off, fail on projects that have their own `checkly` package with `Unable to create a construct ... outside a Checkly CLI project`.