From 8c61dfdcb56377063a0c5d45972f25f156638bf0 Mon Sep 17 00:00:00 2001 From: Paul Bouchon Date: Sat, 11 Jul 2026 22:04:55 -0400 Subject: [PATCH] doc: note --env-file is not applied to --run Environment variables loaded with `--env-file` are not applied to the command executed by `--run`. Document this limitation under `--run`. Fixes: https://github.com/nodejs/node/issues/62988 Signed-off-by: Paul Bouchon --- doc/api/cli.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/doc/api/cli.md b/doc/api/cli.md index 8c241e7202bdb8..51a33f505e1027 100644 --- a/doc/api/cli.md +++ b/doc/api/cli.md @@ -2706,6 +2706,9 @@ The following environment variables are set when running a script with `--run`: * `NODE_RUN_PACKAGE_JSON_PATH`: The path to the `package.json` that is being processed. +Environment variables loaded from a file with [`--env-file`][] are not applied +to the command executed by `--run`. + ### `--secure-heap-min=n`