@karmaniverous/get-dotenv 4.3.2 → 4.4.1

package/README.md

@@ -10,7 +10,7 @@ Load environment variables with a cascade of environment-aware dotenv files. You
 - Private files (e.g. `.env.local`, `env.dev.local`, `env.test.local`) are protected by `.gitignore`.
 - Global files (e.g. `.env`, `env.local`) apply to all environments.
 - Env files (e.g. `.env.dev`, `.env.dev.local`, `.env.test`, `.env.test.local`) apply to a specific environment.
-- Dynamic files (`.env.js`) export logic that dynamically & progressively generates new variables or overrides current ones.
+- [Dynamic files](#dynamic-processing) (`.env.js`) export logic that dynamically & progressively generates new variables or overrides current ones.
 
 ✅ Dynamically specify which variables to load by type.
 
@@ -20,11 +20,13 @@ Load environment variables with a cascade of environment-aware dotenv files. You
 
 ✅ Customize your dotenv file directories & naming patterns.
 
-✅ Perform all of the above either programmatically or from the command line, where you can also execute additional shell commands within the resulting context... including nested `getdotenv` commands that inherit the parent command's settings & context!
+✅ Perform all of the above either programmatically or [from the command line](#command-line-interface), where you can also execute additional commands within the resulting context... including nested `getdotenv` commands that inherit the parent command's settings & context!
+
+✅ [Execute batched CLI commands](#batch-command) across multiple working directories, with each command inheriting the `getdotenv` context.
 
 ✅ Set defaults for all options in a `getdotenv.config.json` file in your project root directory.
 
-✅ Generate an extensible `getdotenv`-based CLI for use in your own projects.
+✅ [Generate an extensible `getdotenv`-based CLI](https://github.com/karmaniverous/get-dotenv-child) for use in your own projects.
 
 `getdotenv` relies on the excellent [`dotenv`](https://www.npmjs.com/package/dotenv) parser and somewhat improves on [`dotenv-expand`](https://www.npmjs.com/package/dotenv-expand) for recursive variable expansion.
 
@@ -111,8 +113,10 @@ You can also use `getdotenv` from the command line:
 # Options:
 #   -e, --env <string>                  target environment (dotenv-expanded)
 #   -v, --vars <string>                 extra variables expressed as delimited key-value pairs (dotenv-expanded): KEY1=VAL1 KEY2=VAL2
-#   -c, --command <string>              shell command string, conflicts with cmd subcommand (dotenv-expanded)
+#   -c, --command <string>              command string executed according to the --shell option, conflicts with cmd subcommand (dotenv-expanded)
 #   -o, --output-path <string>          consolidated output file  (dotenv-expanded)
+#   -s, --shell [string]                command execution shell, no argument for default OS shell or provide shell string (default OS shell)
+#   -S, --shell-off                     command execution shell OFF
 #   -p, --load-process                  load variables to process.env ON (default)
 #   -P, --load-process-off              load variables to process.env OFF
 #   -a, --exclude-all                   exclude all dotenv variables from loading ON
@@ -146,10 +150,16 @@ You can also use `getdotenv` from the command line:
 #
 # Commands:
 #   batch [options]                     Batch shell commands across multiple working directories.
-#   cmd                                 execute shell command, conflicts with --command option (default command)
+#   cmd                                 batch execute command string according to the --shell option, conflicts with --command option (default command)
 #   help [command]                      display help for command
 ```
 
+By default, commands (`-c` or `--command` or the `cmd` subcommand either in the base CLI or in the `batch` subcommand) execute in the default OS shell with the `dotenv` context applied. The `-S` or `--shell-off` options will turn this off, and Execa will [execute your command as Javascript](https://github.com/sindresorhus/execa/blob/main/docs/bash.md).
+
+Alternatively, you can use the `-s` or `--shell` option to specify a different shell [following the Execa spec](https://github.com/sindresorhus/execa/blob/main/docs/shell.md). This is useful if you're running a command that requires a specific shell, like `bash` or `zsh`.
+
+Finally, you can set the [`shell`](https://github.com/karmaniverous/get-dotenv-child?tab=readme-ov-file#options) default globally in your `getdotenv.config.json` file.
+
 See [this example repo](https://github.com/karmaniverous/get-dotenv-child) for a deep dive on using the `getDotenv` CLI and how to extend it for your own projects.
 
 ### Batch Command

package/dist/getdotenv.cli.mjs

@@ -5055,11 +5055,11 @@ function resolveCommandAttempt(parsed, withoutPathExt) {
     return resolved;
 }
 
-function resolveCommand$1(parsed) {
+function resolveCommand$2(parsed) {
     return resolveCommandAttempt(parsed) || resolveCommandAttempt(parsed, true);
 }
 
-var resolveCommand_1 = resolveCommand$1;
+var resolveCommand_1 = resolveCommand$2;
 
 var _escape = {};
 
@@ -5151,7 +5151,7 @@ function readShebang$1(command) {
 var readShebang_1 = readShebang$1;
 
 const path$o = require$$0$2;
-const resolveCommand = resolveCommand_1;
+const resolveCommand$1 = resolveCommand_1;
 const escape = _escape;
 const readShebang = readShebang_1;
 
@@ -5160,7 +5160,7 @@ const isExecutableRegExp = /\.(?:com|exe)$/i;
 const isCmdShimRegExp = /node_modules[\\/].bin[\\/][^\\/]+\.cmd$/i;
 
 function detectShebang(parsed) {
-    parsed.file = resolveCommand(parsed);
+    parsed.file = resolveCommand$1(parsed);
 
     const shebang = parsed.file && readShebang(parsed.file);
 
@@ -5168,7 +5168,7 @@ function detectShebang(parsed) {
         parsed.args.unshift(parsed.file);
         parsed.command = shebang;
 
-        return resolveCommand(parsed);
+        return resolveCommand$1(parsed);
     }
 
     return parsed.file;
@@ -31149,9 +31149,13 @@ const baseGetDotenvCliOptions = {
     paths: './',
     pathsDelimiter: ' ',
     privateToken: 'local',
-    shellScripts: {
-        'git-status': 'git branch --show-current && git status -s -u',
+    scripts: {
+        'git-status': {
+            cmd: 'git branch --show-current && git status -s -u',
+            shell: true,
+        },
     },
+    shell: true,
     vars: '',
     varsAssignor: '=',
     varsDelimiter: ' ',
@@ -31166,7 +31170,7 @@ const getDotenvOptionsFilename = 'getdotenv.config.json';
  * @returns `getDotenv` options.
  */
 const getDotenvCliOptions2Options = ({ paths, pathsDelimiter, pathsDelimiterPattern, vars, varsAssignor, varsAssignorPattern, varsDelimiter, varsDelimiterPattern, ...rest }) => ({
-    ..._.omit(rest, ['debug', 'shellScripts']),
+    ..._.omit(rest, ['debug', 'scripts']),
     paths: paths?.split(pathsDelimiterPattern
         ? RegExp(pathsDelimiterPattern)
         : pathsDelimiter ?? ' ') ?? [],
@@ -31738,6 +31742,13 @@ const getDotenv = async (options = {}) => {
     return dotenv;
 };
 
+const resolveCommand = (scripts, command) => (scripts && _.isObject(scripts[command])
+    ? scripts[command].cmd
+    : scripts?.[command] ?? command);
+const resolveShell = (scripts, command, shell) => scripts && _.isObject(scripts[command])
+    ? scripts[command].shell
+    : shell;
+
 /*
  * merge2
  * https://github.com/teambition/merge2
@@ -39479,7 +39490,7 @@ const globPaths = async ({ globs, logger, pkgCwd, rootPath, }) => {
     }
     return { absRootPath, paths };
 };
-const execShellCommandBatch = async ({ command, globs, ignoreErrors, list, logger, pkgCwd, rootPath, }) => {
+const execShellCommandBatch = async ({ command, getDotenvCliOptions, globs, ignoreErrors, list, logger, pkgCwd, rootPath, shell, }) => {
     if (!command) {
         logger.error(`No command provided.`);
         process.exit(0);
@@ -39491,8 +39502,8 @@ const execShellCommandBatch = async ({ command, globs, ignoreErrors, list, logge
         rootPath,
     });
     const headerTitle = list
-        ? 'Listing shell command working directories...'
-        : 'Executing shell command batch...';
+        ? 'Listing working directories...'
+        : 'Executing command batch...';
     logger.info('');
     const headerRootPath = `ROOT:  ${absRootPath}`;
     const headerGlobs = `GLOBS: ${globs}`;
@@ -39514,12 +39525,17 @@ const execShellCommandBatch = async ({ command, globs, ignoreErrors, list, logge
         logger.info('*'.repeat(pathLabel.length));
         logger.info(pathLabel);
         logger.info(headerCommand);
-        // Execute shell command.
+        // Execute command.
         try {
             await execaCommand(command, {
                 cwd: path,
+                env: {
+                    getDotenvCliOptions: getDotenvCliOptions
+                        ? JSON.stringify(getDotenvCliOptions)
+                        : undefined,
+                },
                 stdio: 'inherit',
-                shell: true,
+                shell,
             });
         }
         catch (error) {
@@ -39533,7 +39549,7 @@ const execShellCommandBatch = async ({ command, globs, ignoreErrors, list, logge
 
 const cmdCommand$1 = new Command()
     .name('cmd')
-    .description('execute shell command, conflicts with --command option (default command)')
+    .description('execute command, conflicts with --command option (default subcommand)')
     .enablePositionalOptions()
     .passThroughOptions()
     .action(async (options, thisCommand) => {
@@ -39541,60 +39557,64 @@ const cmdCommand$1 = new Command()
         throw new Error(`unable to resolve parent command`);
     if (!thisCommand.parent.parent)
         throw new Error(`unable to resolve root command`);
-    const { getDotenvCliOptions: { logger = console, shellScripts }, } = thisCommand.parent.parent;
+    const { getDotenvCliOptions: { logger = console, ...getDotenvCliOptions }, } = thisCommand.parent.parent;
     const { ignoreErrors, globs, list, pkgCwd, rootPath } = thisCommand.parent.opts();
-    // Execute shell command.
+    // Execute command.
     {
         const command = thisCommand.args.join(' ');
         await execShellCommandBatch({
-            command: shellScripts?.[command] ?? command,
+            command: resolveCommand(getDotenvCliOptions.scripts, command),
+            getDotenvCliOptions,
             globs,
             ignoreErrors,
             list,
             logger,
             pkgCwd,
             rootPath,
+            shell: resolveShell(getDotenvCliOptions.scripts, command, getDotenvCliOptions.shell),
         });
     }
 });
 
 const batchCommand = new Command()
     .name('batch')
-    .description('Batch shell commands across multiple working directories.')
+    .description('Batch command execution across multiple working directories.')
     .enablePositionalOptions()
     .passThroughOptions()
     .option('-p, --pkg-cwd', 'use nearest package directory as current working directory')
     .option('-r, --root-path <string>', 'path to batch root directory from current working directory', './')
     .option('-g, --globs <string>', 'space-delimited globs from root path', '*')
-    .option('-c, --command <string>', 'shell command string, conflicts with cmd subcommand (dotenv-expanded)', dotenvExpandFromProcessEnv)
+    .option('-c, --command <string>', 'command executed according to the base --shell option, conflicts with cmd subcommand (dotenv-expanded)', dotenvExpandFromProcessEnv)
     .option('-l, --list', 'list working directories without executing command')
     .option('-e, --ignore-errors', 'ignore errors and continue with next path')
     .hook('preSubcommand', async (thisCommand) => {
     if (!thisCommand.parent)
         throw new Error(`unable to resolve root command`);
-    const { getDotenvCliOptions: { logger = console, shellScripts }, } = thisCommand.parent;
+    const { getDotenvCliOptions: { logger = console, ...getDotenvCliOptions }, } = thisCommand.parent;
     const { command, ignoreErrors, globs, list, pkgCwd, rootPath } = thisCommand.opts();
     if (command && thisCommand.args.length) {
         logger.error(`--command option conflicts with cmd subcommand.`);
         process.exit(0);
     }
-    // Execute shell command.
+    // Execute command.
     if (command)
         await execShellCommandBatch({
-            command: shellScripts?.[command] ?? command,
+            command: resolveCommand(getDotenvCliOptions.scripts, command),
+            getDotenvCliOptions,
             globs,
             ignoreErrors,
             list,
             logger,
             pkgCwd,
             rootPath,
+            shell: resolveShell(getDotenvCliOptions.scripts, command, getDotenvCliOptions.shell),
         });
 })
     .addCommand(cmdCommand$1, { isDefault: true });
 
 const cmdCommand = new Command()
     .name('cmd')
-    .description('batch execute shell command, conflicts with --command option (default command)')
+    .description('batch execute command string according to the --shell option, conflicts with --command option (default subcommand)')
     .configureHelp({ showGlobalOptions: true })
     .enablePositionalOptions()
     .passThroughOptions()
@@ -39603,13 +39623,14 @@ const cmdCommand = new Command()
         return;
     if (!thisCommand.parent)
         throw new Error('parent command not found');
-    const { getDotenvCliOptions: { debug, logger = console, shellScripts }, } = thisCommand.parent;
+    const { getDotenvCliOptions: { logger = console, ...getDotenvCliOptions }, } = thisCommand.parent;
     const command = thisCommand.args.join(' ');
-    const shellCommand = shellScripts?.[command] ?? command;
-    if (debug)
-        logger.log('\n*** shell command ***\n', `'${shellCommand}'`);
-    await execaCommand(shellCommand, {
-        shell: true,
+    const cmd = resolveCommand(getDotenvCliOptions.scripts, command);
+    if (getDotenvCliOptions.debug)
+        logger.log('\n*** command ***\n', `'${cmd}'`);
+    await execaCommand(cmd, {
+        env: { getDotenvCliOptions: JSON.stringify(getDotenvCliOptions) },
+        shell: resolveShell(getDotenvCliOptions.scripts, command, getDotenvCliOptions.shell),
         stdio: 'inherit',
     });
 });
@@ -39658,7 +39679,7 @@ const resolveExclusionAll = (exclude, excludeOff, defaultValue, excludeAll, excl
  * Generate a Commander CLI Command for get-dotenv.
  */
 const generateGetDotenvCli = async (customOptions) => {
-    const { alias, debug, defaultEnv, description, dotenvToken, dynamicPath, env, excludeDynamic, excludeEnv, excludeGlobal, excludePrivate, excludePublic, loadProcess, log, logger, outputPath, paths, pathsDelimiter, pathsDelimiterPattern, postHook, preHook, privateToken, shellScripts, varsAssignor, varsAssignorPattern, varsDelimiter, varsDelimiterPattern, } = await resolveGetDotenvCliGenerateOptions(customOptions);
+    const { alias, debug, defaultEnv, description, dotenvToken, dynamicPath, env, excludeDynamic, excludeEnv, excludeGlobal, excludePrivate, excludePublic, loadProcess, log, logger, outputPath, paths, pathsDelimiter, pathsDelimiterPattern, postHook, preHook, privateToken, scripts, shell, varsAssignor, varsAssignorPattern, varsDelimiter, varsDelimiterPattern, } = await resolveGetDotenvCliGenerateOptions(customOptions);
     const excludeAll = !!excludeDynamic &&
         ((!!excludeEnv && !!excludeGlobal) ||
             (!!excludePrivate && !!excludePublic));
@@ -39674,8 +39695,10 @@ const generateGetDotenvCli = async (customOptions) => {
     ]
         .map((v) => v.join(varsAssignor))
         .join(varsDelimiter)}`, dotenvExpandFromProcessEnv)
-        .option('-c, --command <string>', 'shell command string, conflicts with cmd subcommand (dotenv-expanded)', dotenvExpandFromProcessEnv)
+        .option('-c, --command <string>', 'command executed according to the --shell option, conflicts with cmd subcommand (dotenv-expanded)', dotenvExpandFromProcessEnv)
         .option('-o, --output-path <string>', 'consolidated output file  (dotenv-expanded)', dotenvExpandFromProcessEnv, outputPath)
+        .addOption(new Option('-s, --shell [string]', `command execution shell, no argument for default OS shell or provide shell string${shell ? ` (default ${_.isBoolean(shell) ? 'OS shell' : shell})` : ''}`).conflicts('shellOff'))
+        .addOption(new Option('-S, --shell-off', `command execution shell OFF${!shell ? ' (default)' : ''}`).conflicts('shell'))
         .addOption(new Option('-p, --load-process', `load variables to process.env ON${loadProcess ? ' (default)' : ''}`).conflicts('loadProcessOff'))
         .addOption(new Option('-P, --load-process-off', `load variables to process.env OFF${!loadProcess ? ' (default)' : ''}`).conflicts('loadProcess'))
         .addOption(new Option('-a, --exclude-all', `exclude all dotenv variables from loading ON${excludeAll ? ' (default)' : ''}`).conflicts('excludeAllOff'))
@@ -39705,8 +39728,8 @@ const generateGetDotenvCli = async (customOptions) => {
         .option('--vars-delimiter-pattern <string>', 'vars delimiter regex pattern', varsDelimiterPattern)
         .option('--vars-assignor <string>', 'vars assignment operator string', varsAssignor)
         .option('--vars-assignor-pattern <string>', 'vars assignment operator regex pattern', varsAssignorPattern)
-        .addOption(new Option('--shell-scripts <string>')
-        .default(JSON.stringify(shellScripts))
+        .addOption(new Option('--scripts <string>')
+        .default(JSON.stringify(scripts))
         .hideHelp())
         .addCommand(batchCommand)
         .addCommand(cmdCommand, { isDefault: true })
@@ -39718,10 +39741,10 @@ const generateGetDotenvCli = async (customOptions) => {
         // Get raw CLI options from commander.
         const rawCliOptions = thisCommand.opts();
         // Extract current GetDotenvCliOptions from raw CLI options.
-        const { command, debugOff, excludeAll, excludeAllOff, excludeDynamicOff, excludeEnvOff, excludeGlobalOff, excludePrivateOff, excludePublicOff, loadProcessOff, logOff, shellScripts, ...rawCliOptionsRest } = rawCliOptions;
+        const { command, debugOff, excludeAll, excludeAllOff, excludeDynamicOff, excludeEnvOff, excludeGlobalOff, excludePrivateOff, excludePublicOff, loadProcessOff, logOff, scripts, shellOff, ...rawCliOptionsRest } = rawCliOptions;
         const currentGetDotenvCliOptions = rawCliOptionsRest;
-        if (shellScripts)
-            currentGetDotenvCliOptions.shellScripts = JSON.parse(shellScripts);
+        if (scripts)
+            currentGetDotenvCliOptions.scripts = JSON.parse(scripts);
         // Merge current & parent GetDotenvCliOptions.
         const mergedGetDotenvCliOptions = _.defaultsDeep(currentGetDotenvCliOptions, parentGetDotenvCliOptions ?? {});
         // Resolve flags.
@@ -39733,12 +39756,17 @@ const generateGetDotenvCli = async (customOptions) => {
         mergedGetDotenvCliOptions.excludePublic = resolveExclusionAll(mergedGetDotenvCliOptions.excludePublic, excludePublicOff, excludePublic, excludeAll, excludeAllOff);
         mergedGetDotenvCliOptions.log = resolveExclusion(mergedGetDotenvCliOptions.log, logOff, log);
         mergedGetDotenvCliOptions.loadProcess = resolveExclusion(mergedGetDotenvCliOptions.loadProcess, loadProcessOff, loadProcess);
+        mergedGetDotenvCliOptions.shell = shellOff
+            ? false
+            : !_.isUndefined(mergedGetDotenvCliOptions.shell)
+                ? mergedGetDotenvCliOptions.shell
+                : !_.isUndefined(shell)
+                    ? shell
+                    : false;
         if (mergedGetDotenvCliOptions.debug && parentGetDotenvCliOptions)
             logger.debug('\n*** parent command GetDotenvCliOptions ***\n', parentGetDotenvCliOptions);
         if (mergedGetDotenvCliOptions.debug)
             logger.debug('\n*** current command raw options ***\n', rawCliOptions);
-        if (mergedGetDotenvCliOptions.debug)
-            logger.debug('\n*** current command GetDotenvCliOptions ***\n', currentGetDotenvCliOptions);
         if (mergedGetDotenvCliOptions.debug)
             logger.debug('\n*** merged GetDotenvCliOptions ***\n', {
                 mergedGetDotenvCliOptions,
@@ -39758,21 +39786,21 @@ const generateGetDotenvCli = async (customOptions) => {
         // Execute post-hook.
         if (postHook)
             await postHook(dotenv);
-        // Execute shell command.
+        // Execute command.
         if (command && thisCommand.args.length) {
             logger.error(`--command option conflicts with cmd subcommand.`);
             process.exit(0);
         }
         if (command) {
-            const shellCommand = mergedGetDotenvCliOptions.shellScripts?.[command] ?? command;
+            const cmd = resolveCommand(mergedGetDotenvCliOptions.scripts, command);
             if (mergedGetDotenvCliOptions.debug)
-                logger.debug('\n*** shell command ***\n', shellCommand);
-            await execaCommand(shellCommand, {
+                logger.debug('\n*** command ***\n', cmd);
+            await execaCommand(cmd, {
                 env: {
                     ...process.env,
                     getDotenvCliOptions: JSON.stringify(_.omit(mergedGetDotenvCliOptions, ['logger'])),
                 },
-                shell: true,
+                shell: resolveShell(mergedGetDotenvCliOptions.scripts, command, mergedGetDotenvCliOptions.shell),
                 stdio: 'inherit',
             });
         }

package/dist/index.cjs

@@ -5056,11 +5056,11 @@ function resolveCommandAttempt(parsed, withoutPathExt) {
     return resolved;
 }
 
-function resolveCommand$1(parsed) {
+function resolveCommand$2(parsed) {
     return resolveCommandAttempt(parsed) || resolveCommandAttempt(parsed, true);
 }
 
-var resolveCommand_1 = resolveCommand$1;
+var resolveCommand_1 = resolveCommand$2;
 
 var _escape = {};
 
@@ -5152,7 +5152,7 @@ function readShebang$1(command) {
 var readShebang_1 = readShebang$1;
 
 const path$o = require$$0$2;
-const resolveCommand = resolveCommand_1;
+const resolveCommand$1 = resolveCommand_1;
 const escape = _escape;
 const readShebang = readShebang_1;
 
@@ -5161,7 +5161,7 @@ const isExecutableRegExp = /\.(?:com|exe)$/i;
 const isCmdShimRegExp = /node_modules[\\/].bin[\\/][^\\/]+\.cmd$/i;
 
 function detectShebang(parsed) {
-    parsed.file = resolveCommand(parsed);
+    parsed.file = resolveCommand$1(parsed);
 
     const shebang = parsed.file && readShebang(parsed.file);
 
@@ -5169,7 +5169,7 @@ function detectShebang(parsed) {
         parsed.args.unshift(parsed.file);
         parsed.command = shebang;
 
-        return resolveCommand(parsed);
+        return resolveCommand$1(parsed);
     }
 
     return parsed.file;
@@ -31150,9 +31150,13 @@ const baseGetDotenvCliOptions = {
     paths: './',
     pathsDelimiter: ' ',
     privateToken: 'local',
-    shellScripts: {
-        'git-status': 'git branch --show-current && git status -s -u',
+    scripts: {
+        'git-status': {
+            cmd: 'git branch --show-current && git status -s -u',
+            shell: true,
+        },
     },
+    shell: true,
     vars: '',
     varsAssignor: '=',
     varsDelimiter: ' ',
@@ -31167,7 +31171,7 @@ const getDotenvOptionsFilename = 'getdotenv.config.json';
  * @returns `getDotenv` options.
  */
 const getDotenvCliOptions2Options = ({ paths, pathsDelimiter, pathsDelimiterPattern, vars, varsAssignor, varsAssignorPattern, varsDelimiter, varsDelimiterPattern, ...rest }) => ({
-    ..._.omit(rest, ['debug', 'shellScripts']),
+    ..._.omit(rest, ['debug', 'scripts']),
     paths: paths?.split(pathsDelimiterPattern
         ? RegExp(pathsDelimiterPattern)
         : pathsDelimiter ?? ' ') ?? [],
@@ -31739,6 +31743,13 @@ const getDotenv = async (options = {}) => {
     return dotenv;
 };
 
+const resolveCommand = (scripts, command) => (scripts && _.isObject(scripts[command])
+    ? scripts[command].cmd
+    : scripts?.[command] ?? command);
+const resolveShell = (scripts, command, shell) => scripts && _.isObject(scripts[command])
+    ? scripts[command].shell
+    : shell;
+
 /*
  * merge2
  * https://github.com/teambition/merge2
@@ -39480,7 +39491,7 @@ const globPaths = async ({ globs, logger, pkgCwd, rootPath, }) => {
     }
     return { absRootPath, paths };
 };
-const execShellCommandBatch = async ({ command, globs, ignoreErrors, list, logger, pkgCwd, rootPath, }) => {
+const execShellCommandBatch = async ({ command, getDotenvCliOptions, globs, ignoreErrors, list, logger, pkgCwd, rootPath, shell, }) => {
     if (!command) {
         logger.error(`No command provided.`);
         process.exit(0);
@@ -39492,8 +39503,8 @@ const execShellCommandBatch = async ({ command, globs, ignoreErrors, list, logge
         rootPath,
     });
     const headerTitle = list
-        ? 'Listing shell command working directories...'
-        : 'Executing shell command batch...';
+        ? 'Listing working directories...'
+        : 'Executing command batch...';
     logger.info('');
     const headerRootPath = `ROOT:  ${absRootPath}`;
     const headerGlobs = `GLOBS: ${globs}`;
@@ -39515,12 +39526,17 @@ const execShellCommandBatch = async ({ command, globs, ignoreErrors, list, logge
         logger.info('*'.repeat(pathLabel.length));
         logger.info(pathLabel);
         logger.info(headerCommand);
-        // Execute shell command.
+        // Execute command.
         try {
             await execaCommand(command, {
                 cwd: path,
+                env: {
+                    getDotenvCliOptions: getDotenvCliOptions
+                        ? JSON.stringify(getDotenvCliOptions)
+                        : undefined,
+                },
                 stdio: 'inherit',
-                shell: true,
+                shell,
             });
         }
         catch (error) {
@@ -39534,7 +39550,7 @@ const execShellCommandBatch = async ({ command, globs, ignoreErrors, list, logge
 
 const cmdCommand$1 = new Command()
     .name('cmd')
-    .description('execute shell command, conflicts with --command option (default command)')
+    .description('execute command, conflicts with --command option (default subcommand)')
     .enablePositionalOptions()
     .passThroughOptions()
     .action(async (options, thisCommand) => {
@@ -39542,60 +39558,64 @@ const cmdCommand$1 = new Command()
         throw new Error(`unable to resolve parent command`);
     if (!thisCommand.parent.parent)
         throw new Error(`unable to resolve root command`);
-    const { getDotenvCliOptions: { logger = console, shellScripts }, } = thisCommand.parent.parent;
+    const { getDotenvCliOptions: { logger = console, ...getDotenvCliOptions }, } = thisCommand.parent.parent;
     const { ignoreErrors, globs, list, pkgCwd, rootPath } = thisCommand.parent.opts();
-    // Execute shell command.
+    // Execute command.
     {
         const command = thisCommand.args.join(' ');
         await execShellCommandBatch({
-            command: shellScripts?.[command] ?? command,
+            command: resolveCommand(getDotenvCliOptions.scripts, command),
+            getDotenvCliOptions,
             globs,
             ignoreErrors,
             list,
             logger,
             pkgCwd,
             rootPath,
+            shell: resolveShell(getDotenvCliOptions.scripts, command, getDotenvCliOptions.shell),
         });
     }
 });
 
 const batchCommand = new Command()
     .name('batch')
-    .description('Batch shell commands across multiple working directories.')
+    .description('Batch command execution across multiple working directories.')
     .enablePositionalOptions()
     .passThroughOptions()
     .option('-p, --pkg-cwd', 'use nearest package directory as current working directory')
     .option('-r, --root-path <string>', 'path to batch root directory from current working directory', './')
     .option('-g, --globs <string>', 'space-delimited globs from root path', '*')
-    .option('-c, --command <string>', 'shell command string, conflicts with cmd subcommand (dotenv-expanded)', dotenvExpandFromProcessEnv)
+    .option('-c, --command <string>', 'command executed according to the base --shell option, conflicts with cmd subcommand (dotenv-expanded)', dotenvExpandFromProcessEnv)
     .option('-l, --list', 'list working directories without executing command')
     .option('-e, --ignore-errors', 'ignore errors and continue with next path')
     .hook('preSubcommand', async (thisCommand) => {
     if (!thisCommand.parent)
         throw new Error(`unable to resolve root command`);
-    const { getDotenvCliOptions: { logger = console, shellScripts }, } = thisCommand.parent;
+    const { getDotenvCliOptions: { logger = console, ...getDotenvCliOptions }, } = thisCommand.parent;
     const { command, ignoreErrors, globs, list, pkgCwd, rootPath } = thisCommand.opts();
     if (command && thisCommand.args.length) {
         logger.error(`--command option conflicts with cmd subcommand.`);
         process.exit(0);
     }
-    // Execute shell command.
+    // Execute command.
     if (command)
         await execShellCommandBatch({
-            command: shellScripts?.[command] ?? command,
+            command: resolveCommand(getDotenvCliOptions.scripts, command),
+            getDotenvCliOptions,
             globs,
             ignoreErrors,
             list,
             logger,
             pkgCwd,
             rootPath,
+            shell: resolveShell(getDotenvCliOptions.scripts, command, getDotenvCliOptions.shell),
         });
 })
     .addCommand(cmdCommand$1, { isDefault: true });
 
 const cmdCommand = new Command()
     .name('cmd')
-    .description('batch execute shell command, conflicts with --command option (default command)')
+    .description('batch execute command string according to the --shell option, conflicts with --command option (default subcommand)')
     .configureHelp({ showGlobalOptions: true })
     .enablePositionalOptions()
     .passThroughOptions()
@@ -39604,13 +39624,14 @@ const cmdCommand = new Command()
         return;
     if (!thisCommand.parent)
         throw new Error('parent command not found');
-    const { getDotenvCliOptions: { debug, logger = console, shellScripts }, } = thisCommand.parent;
+    const { getDotenvCliOptions: { logger = console, ...getDotenvCliOptions }, } = thisCommand.parent;
     const command = thisCommand.args.join(' ');
-    const shellCommand = shellScripts?.[command] ?? command;
-    if (debug)
-        logger.log('\n*** shell command ***\n', `'${shellCommand}'`);
-    await execaCommand(shellCommand, {
-        shell: true,
+    const cmd = resolveCommand(getDotenvCliOptions.scripts, command);
+    if (getDotenvCliOptions.debug)
+        logger.log('\n*** command ***\n', `'${cmd}'`);
+    await execaCommand(cmd, {
+        env: { getDotenvCliOptions: JSON.stringify(getDotenvCliOptions) },
+        shell: resolveShell(getDotenvCliOptions.scripts, command, getDotenvCliOptions.shell),
         stdio: 'inherit',
     });
 });
@@ -39659,7 +39680,7 @@ const resolveExclusionAll = (exclude, excludeOff, defaultValue, excludeAll, excl
  * Generate a Commander CLI Command for get-dotenv.
  */
 const generateGetDotenvCli = async (customOptions) => {
-    const { alias, debug, defaultEnv, description, dotenvToken, dynamicPath, env, excludeDynamic, excludeEnv, excludeGlobal, excludePrivate, excludePublic, loadProcess, log, logger, outputPath, paths, pathsDelimiter, pathsDelimiterPattern, postHook, preHook, privateToken, shellScripts, varsAssignor, varsAssignorPattern, varsDelimiter, varsDelimiterPattern, } = await resolveGetDotenvCliGenerateOptions(customOptions);
+    const { alias, debug, defaultEnv, description, dotenvToken, dynamicPath, env, excludeDynamic, excludeEnv, excludeGlobal, excludePrivate, excludePublic, loadProcess, log, logger, outputPath, paths, pathsDelimiter, pathsDelimiterPattern, postHook, preHook, privateToken, scripts, shell, varsAssignor, varsAssignorPattern, varsDelimiter, varsDelimiterPattern, } = await resolveGetDotenvCliGenerateOptions(customOptions);
     const excludeAll = !!excludeDynamic &&
         ((!!excludeEnv && !!excludeGlobal) ||
             (!!excludePrivate && !!excludePublic));
@@ -39675,8 +39696,10 @@ const generateGetDotenvCli = async (customOptions) => {
     ]
         .map((v) => v.join(varsAssignor))
         .join(varsDelimiter)}`, dotenvExpandFromProcessEnv)
-        .option('-c, --command <string>', 'shell command string, conflicts with cmd subcommand (dotenv-expanded)', dotenvExpandFromProcessEnv)
+        .option('-c, --command <string>', 'command executed according to the --shell option, conflicts with cmd subcommand (dotenv-expanded)', dotenvExpandFromProcessEnv)
         .option('-o, --output-path <string>', 'consolidated output file  (dotenv-expanded)', dotenvExpandFromProcessEnv, outputPath)
+        .addOption(new Option('-s, --shell [string]', `command execution shell, no argument for default OS shell or provide shell string${shell ? ` (default ${_.isBoolean(shell) ? 'OS shell' : shell})` : ''}`).conflicts('shellOff'))
+        .addOption(new Option('-S, --shell-off', `command execution shell OFF${!shell ? ' (default)' : ''}`).conflicts('shell'))
         .addOption(new Option('-p, --load-process', `load variables to process.env ON${loadProcess ? ' (default)' : ''}`).conflicts('loadProcessOff'))
         .addOption(new Option('-P, --load-process-off', `load variables to process.env OFF${!loadProcess ? ' (default)' : ''}`).conflicts('loadProcess'))
         .addOption(new Option('-a, --exclude-all', `exclude all dotenv variables from loading ON${excludeAll ? ' (default)' : ''}`).conflicts('excludeAllOff'))
@@ -39706,8 +39729,8 @@ const generateGetDotenvCli = async (customOptions) => {
         .option('--vars-delimiter-pattern <string>', 'vars delimiter regex pattern', varsDelimiterPattern)
         .option('--vars-assignor <string>', 'vars assignment operator string', varsAssignor)
         .option('--vars-assignor-pattern <string>', 'vars assignment operator regex pattern', varsAssignorPattern)
-        .addOption(new Option('--shell-scripts <string>')
-        .default(JSON.stringify(shellScripts))
+        .addOption(new Option('--scripts <string>')
+        .default(JSON.stringify(scripts))
         .hideHelp())
         .addCommand(batchCommand)
         .addCommand(cmdCommand, { isDefault: true })
@@ -39719,10 +39742,10 @@ const generateGetDotenvCli = async (customOptions) => {
         // Get raw CLI options from commander.
         const rawCliOptions = thisCommand.opts();
         // Extract current GetDotenvCliOptions from raw CLI options.
-        const { command, debugOff, excludeAll, excludeAllOff, excludeDynamicOff, excludeEnvOff, excludeGlobalOff, excludePrivateOff, excludePublicOff, loadProcessOff, logOff, shellScripts, ...rawCliOptionsRest } = rawCliOptions;
+        const { command, debugOff, excludeAll, excludeAllOff, excludeDynamicOff, excludeEnvOff, excludeGlobalOff, excludePrivateOff, excludePublicOff, loadProcessOff, logOff, scripts, shellOff, ...rawCliOptionsRest } = rawCliOptions;
         const currentGetDotenvCliOptions = rawCliOptionsRest;
-        if (shellScripts)
-            currentGetDotenvCliOptions.shellScripts = JSON.parse(shellScripts);
+        if (scripts)
+            currentGetDotenvCliOptions.scripts = JSON.parse(scripts);
         // Merge current & parent GetDotenvCliOptions.
         const mergedGetDotenvCliOptions = _.defaultsDeep(currentGetDotenvCliOptions, parentGetDotenvCliOptions ?? {});
         // Resolve flags.
@@ -39734,12 +39757,17 @@ const generateGetDotenvCli = async (customOptions) => {
         mergedGetDotenvCliOptions.excludePublic = resolveExclusionAll(mergedGetDotenvCliOptions.excludePublic, excludePublicOff, excludePublic, excludeAll, excludeAllOff);
         mergedGetDotenvCliOptions.log = resolveExclusion(mergedGetDotenvCliOptions.log, logOff, log);
         mergedGetDotenvCliOptions.loadProcess = resolveExclusion(mergedGetDotenvCliOptions.loadProcess, loadProcessOff, loadProcess);
+        mergedGetDotenvCliOptions.shell = shellOff
+            ? false
+            : !_.isUndefined(mergedGetDotenvCliOptions.shell)
+                ? mergedGetDotenvCliOptions.shell
+                : !_.isUndefined(shell)
+                    ? shell
+                    : false;
         if (mergedGetDotenvCliOptions.debug && parentGetDotenvCliOptions)
             logger.debug('\n*** parent command GetDotenvCliOptions ***\n', parentGetDotenvCliOptions);
         if (mergedGetDotenvCliOptions.debug)
             logger.debug('\n*** current command raw options ***\n', rawCliOptions);
-        if (mergedGetDotenvCliOptions.debug)
-            logger.debug('\n*** current command GetDotenvCliOptions ***\n', currentGetDotenvCliOptions);
         if (mergedGetDotenvCliOptions.debug)
             logger.debug('\n*** merged GetDotenvCliOptions ***\n', {
                 mergedGetDotenvCliOptions,
@@ -39759,21 +39787,21 @@ const generateGetDotenvCli = async (customOptions) => {
         // Execute post-hook.
         if (postHook)
             await postHook(dotenv);
-        // Execute shell command.
+        // Execute command.
         if (command && thisCommand.args.length) {
             logger.error(`--command option conflicts with cmd subcommand.`);
             process.exit(0);
         }
         if (command) {
-            const shellCommand = mergedGetDotenvCliOptions.shellScripts?.[command] ?? command;
+            const cmd = resolveCommand(mergedGetDotenvCliOptions.scripts, command);
             if (mergedGetDotenvCliOptions.debug)
-                logger.debug('\n*** shell command ***\n', shellCommand);
-            await execaCommand(shellCommand, {
+                logger.debug('\n*** command ***\n', cmd);
+            await execaCommand(cmd, {
                 env: {
                     ...process.env,
                     getDotenvCliOptions: JSON.stringify(_.omit(mergedGetDotenvCliOptions, ['logger'])),
                 },
-                shell: true,
+                shell: resolveShell(mergedGetDotenvCliOptions.scripts, command, mergedGetDotenvCliOptions.shell),
                 stdio: 'inherit',
             });
         }

package/dist/index.d.cts

@@ -1,5 +1,9 @@
 import { Command } from '@commander-js/extra-typings';
 
+type Scripts = Record<string, string | {
+    cmd: string;
+    shell?: string | boolean;
+}>;
 /**
  * Options passed programmatically to `getDotenvCli`.
  */
@@ -23,9 +27,17 @@ interface GetDotenvCliOptions extends Omit<GetDotenvOptions, 'paths' | 'vars'> {
      */
     pathsDelimiterPattern?: string;
     /**
-     * Shell scripts that can be executed from the CLI, either individually or via the batch subcommand.
+     * Scripts that can be executed from the CLI, either individually or via the batch subcommand.
      */
-    shellScripts?: Record<string, string>;
+    scripts?: Scripts;
+    /**
+     * Determines how commands and scripts are executed. If `false` or
+     * `undefined`, commands are executed as plain Javascript using the default
+     * execa parser. If `true`, commands are executed using the default OS shell
+     * parser. Otherwise the user may provide a specific shell string (e.g.
+     * `/bin/bash`)
+     */
+    shell?: string | boolean;
     /**
      * A delimited string of key-value pairs declaratively specifying variables &
      * values to be loaded in addition to any dotenv files.

package/dist/index.d.mts

@@ -1,5 +1,9 @@
 import { Command } from '@commander-js/extra-typings';
 
+type Scripts = Record<string, string | {
+    cmd: string;
+    shell?: string | boolean;
+}>;
 /**
  * Options passed programmatically to `getDotenvCli`.
  */
@@ -23,9 +27,17 @@ interface GetDotenvCliOptions extends Omit<GetDotenvOptions, 'paths' | 'vars'> {
      */
     pathsDelimiterPattern?: string;
     /**
-     * Shell scripts that can be executed from the CLI, either individually or via the batch subcommand.
+     * Scripts that can be executed from the CLI, either individually or via the batch subcommand.
      */
-    shellScripts?: Record<string, string>;
+    scripts?: Scripts;
+    /**
+     * Determines how commands and scripts are executed. If `false` or
+     * `undefined`, commands are executed as plain Javascript using the default
+     * execa parser. If `true`, commands are executed using the default OS shell
+     * parser. Otherwise the user may provide a specific shell string (e.g.
+     * `/bin/bash`)
+     */
+    shell?: string | boolean;
     /**
      * A delimited string of key-value pairs declaratively specifying variables &
      * values to be loaded in addition to any dotenv files.

package/dist/index.d.ts

@@ -1,5 +1,9 @@
 import { Command } from '@commander-js/extra-typings';
 
+type Scripts = Record<string, string | {
+    cmd: string;
+    shell?: string | boolean;
+}>;
 /**
  * Options passed programmatically to `getDotenvCli`.
  */
@@ -23,9 +27,17 @@ interface GetDotenvCliOptions extends Omit<GetDotenvOptions, 'paths' | 'vars'> {
      */
     pathsDelimiterPattern?: string;
     /**
-     * Shell scripts that can be executed from the CLI, either individually or via the batch subcommand.
+     * Scripts that can be executed from the CLI, either individually or via the batch subcommand.
      */
-    shellScripts?: Record<string, string>;
+    scripts?: Scripts;
+    /**
+     * Determines how commands and scripts are executed. If `false` or
+     * `undefined`, commands are executed as plain Javascript using the default
+     * execa parser. If `true`, commands are executed using the default OS shell
+     * parser. Otherwise the user may provide a specific shell string (e.g.
+     * `/bin/bash`)
+     */
+    shell?: string | boolean;
     /**
      * A delimited string of key-value pairs declaratively specifying variables &
      * values to be loaded in addition to any dotenv files.

package/dist/index.mjs

@@ -5054,11 +5054,11 @@ function resolveCommandAttempt(parsed, withoutPathExt) {
     return resolved;
 }
 
-function resolveCommand$1(parsed) {
+function resolveCommand$2(parsed) {
     return resolveCommandAttempt(parsed) || resolveCommandAttempt(parsed, true);
 }
 
-var resolveCommand_1 = resolveCommand$1;
+var resolveCommand_1 = resolveCommand$2;
 
 var _escape = {};
 
@@ -5150,7 +5150,7 @@ function readShebang$1(command) {
 var readShebang_1 = readShebang$1;
 
 const path$o = require$$0$2;
-const resolveCommand = resolveCommand_1;
+const resolveCommand$1 = resolveCommand_1;
 const escape = _escape;
 const readShebang = readShebang_1;
 
@@ -5159,7 +5159,7 @@ const isExecutableRegExp = /\.(?:com|exe)$/i;
 const isCmdShimRegExp = /node_modules[\\/].bin[\\/][^\\/]+\.cmd$/i;
 
 function detectShebang(parsed) {
-    parsed.file = resolveCommand(parsed);
+    parsed.file = resolveCommand$1(parsed);
 
     const shebang = parsed.file && readShebang(parsed.file);
 
@@ -5167,7 +5167,7 @@ function detectShebang(parsed) {
         parsed.args.unshift(parsed.file);
         parsed.command = shebang;
 
-        return resolveCommand(parsed);
+        return resolveCommand$1(parsed);
     }
 
     return parsed.file;
@@ -31148,9 +31148,13 @@ const baseGetDotenvCliOptions = {
     paths: './',
     pathsDelimiter: ' ',
     privateToken: 'local',
-    shellScripts: {
-        'git-status': 'git branch --show-current && git status -s -u',
+    scripts: {
+        'git-status': {
+            cmd: 'git branch --show-current && git status -s -u',
+            shell: true,
+        },
     },
+    shell: true,
     vars: '',
     varsAssignor: '=',
     varsDelimiter: ' ',
@@ -31165,7 +31169,7 @@ const getDotenvOptionsFilename = 'getdotenv.config.json';
  * @returns `getDotenv` options.
  */
 const getDotenvCliOptions2Options = ({ paths, pathsDelimiter, pathsDelimiterPattern, vars, varsAssignor, varsAssignorPattern, varsDelimiter, varsDelimiterPattern, ...rest }) => ({
-    ..._.omit(rest, ['debug', 'shellScripts']),
+    ..._.omit(rest, ['debug', 'scripts']),
     paths: paths?.split(pathsDelimiterPattern
         ? RegExp(pathsDelimiterPattern)
         : pathsDelimiter ?? ' ') ?? [],
@@ -31737,6 +31741,13 @@ const getDotenv = async (options = {}) => {
     return dotenv;
 };
 
+const resolveCommand = (scripts, command) => (scripts && _.isObject(scripts[command])
+    ? scripts[command].cmd
+    : scripts?.[command] ?? command);
+const resolveShell = (scripts, command, shell) => scripts && _.isObject(scripts[command])
+    ? scripts[command].shell
+    : shell;
+
 /*
  * merge2
  * https://github.com/teambition/merge2
@@ -39478,7 +39489,7 @@ const globPaths = async ({ globs, logger, pkgCwd, rootPath, }) => {
     }
     return { absRootPath, paths };
 };
-const execShellCommandBatch = async ({ command, globs, ignoreErrors, list, logger, pkgCwd, rootPath, }) => {
+const execShellCommandBatch = async ({ command, getDotenvCliOptions, globs, ignoreErrors, list, logger, pkgCwd, rootPath, shell, }) => {
     if (!command) {
         logger.error(`No command provided.`);
         process.exit(0);
@@ -39490,8 +39501,8 @@ const execShellCommandBatch = async ({ command, globs, ignoreErrors, list, logge
         rootPath,
     });
     const headerTitle = list
-        ? 'Listing shell command working directories...'
-        : 'Executing shell command batch...';
+        ? 'Listing working directories...'
+        : 'Executing command batch...';
     logger.info('');
     const headerRootPath = `ROOT:  ${absRootPath}`;
     const headerGlobs = `GLOBS: ${globs}`;
@@ -39513,12 +39524,17 @@ const execShellCommandBatch = async ({ command, globs, ignoreErrors, list, logge
         logger.info('*'.repeat(pathLabel.length));
         logger.info(pathLabel);
         logger.info(headerCommand);
-        // Execute shell command.
+        // Execute command.
         try {
             await execaCommand(command, {
                 cwd: path,
+                env: {
+                    getDotenvCliOptions: getDotenvCliOptions
+                        ? JSON.stringify(getDotenvCliOptions)
+                        : undefined,
+                },
                 stdio: 'inherit',
-                shell: true,
+                shell,
             });
         }
         catch (error) {
@@ -39532,7 +39548,7 @@ const execShellCommandBatch = async ({ command, globs, ignoreErrors, list, logge
 
 const cmdCommand$1 = new Command()
     .name('cmd')
-    .description('execute shell command, conflicts with --command option (default command)')
+    .description('execute command, conflicts with --command option (default subcommand)')
     .enablePositionalOptions()
     .passThroughOptions()
     .action(async (options, thisCommand) => {
@@ -39540,60 +39556,64 @@ const cmdCommand$1 = new Command()
         throw new Error(`unable to resolve parent command`);
     if (!thisCommand.parent.parent)
         throw new Error(`unable to resolve root command`);
-    const { getDotenvCliOptions: { logger = console, shellScripts }, } = thisCommand.parent.parent;
+    const { getDotenvCliOptions: { logger = console, ...getDotenvCliOptions }, } = thisCommand.parent.parent;
     const { ignoreErrors, globs, list, pkgCwd, rootPath } = thisCommand.parent.opts();
-    // Execute shell command.
+    // Execute command.
     {
         const command = thisCommand.args.join(' ');
         await execShellCommandBatch({
-            command: shellScripts?.[command] ?? command,
+            command: resolveCommand(getDotenvCliOptions.scripts, command),
+            getDotenvCliOptions,
             globs,
             ignoreErrors,
             list,
             logger,
             pkgCwd,
             rootPath,
+            shell: resolveShell(getDotenvCliOptions.scripts, command, getDotenvCliOptions.shell),
         });
     }
 });
 
 const batchCommand = new Command()
     .name('batch')
-    .description('Batch shell commands across multiple working directories.')
+    .description('Batch command execution across multiple working directories.')
     .enablePositionalOptions()
     .passThroughOptions()
     .option('-p, --pkg-cwd', 'use nearest package directory as current working directory')
     .option('-r, --root-path <string>', 'path to batch root directory from current working directory', './')
     .option('-g, --globs <string>', 'space-delimited globs from root path', '*')
-    .option('-c, --command <string>', 'shell command string, conflicts with cmd subcommand (dotenv-expanded)', dotenvExpandFromProcessEnv)
+    .option('-c, --command <string>', 'command executed according to the base --shell option, conflicts with cmd subcommand (dotenv-expanded)', dotenvExpandFromProcessEnv)
     .option('-l, --list', 'list working directories without executing command')
     .option('-e, --ignore-errors', 'ignore errors and continue with next path')
     .hook('preSubcommand', async (thisCommand) => {
     if (!thisCommand.parent)
         throw new Error(`unable to resolve root command`);
-    const { getDotenvCliOptions: { logger = console, shellScripts }, } = thisCommand.parent;
+    const { getDotenvCliOptions: { logger = console, ...getDotenvCliOptions }, } = thisCommand.parent;
     const { command, ignoreErrors, globs, list, pkgCwd, rootPath } = thisCommand.opts();
     if (command && thisCommand.args.length) {
         logger.error(`--command option conflicts with cmd subcommand.`);
         process.exit(0);
     }
-    // Execute shell command.
+    // Execute command.
     if (command)
         await execShellCommandBatch({
-            command: shellScripts?.[command] ?? command,
+            command: resolveCommand(getDotenvCliOptions.scripts, command),
+            getDotenvCliOptions,
             globs,
             ignoreErrors,
             list,
             logger,
             pkgCwd,
             rootPath,
+            shell: resolveShell(getDotenvCliOptions.scripts, command, getDotenvCliOptions.shell),
         });
 })
     .addCommand(cmdCommand$1, { isDefault: true });
 
 const cmdCommand = new Command()
     .name('cmd')
-    .description('batch execute shell command, conflicts with --command option (default command)')
+    .description('batch execute command string according to the --shell option, conflicts with --command option (default subcommand)')
     .configureHelp({ showGlobalOptions: true })
     .enablePositionalOptions()
     .passThroughOptions()
@@ -39602,13 +39622,14 @@ const cmdCommand = new Command()
         return;
     if (!thisCommand.parent)
         throw new Error('parent command not found');
-    const { getDotenvCliOptions: { debug, logger = console, shellScripts }, } = thisCommand.parent;
+    const { getDotenvCliOptions: { logger = console, ...getDotenvCliOptions }, } = thisCommand.parent;
     const command = thisCommand.args.join(' ');
-    const shellCommand = shellScripts?.[command] ?? command;
-    if (debug)
-        logger.log('\n*** shell command ***\n', `'${shellCommand}'`);
-    await execaCommand(shellCommand, {
-        shell: true,
+    const cmd = resolveCommand(getDotenvCliOptions.scripts, command);
+    if (getDotenvCliOptions.debug)
+        logger.log('\n*** command ***\n', `'${cmd}'`);
+    await execaCommand(cmd, {
+        env: { getDotenvCliOptions: JSON.stringify(getDotenvCliOptions) },
+        shell: resolveShell(getDotenvCliOptions.scripts, command, getDotenvCliOptions.shell),
         stdio: 'inherit',
     });
 });
@@ -39657,7 +39678,7 @@ const resolveExclusionAll = (exclude, excludeOff, defaultValue, excludeAll, excl
  * Generate a Commander CLI Command for get-dotenv.
  */
 const generateGetDotenvCli = async (customOptions) => {
-    const { alias, debug, defaultEnv, description, dotenvToken, dynamicPath, env, excludeDynamic, excludeEnv, excludeGlobal, excludePrivate, excludePublic, loadProcess, log, logger, outputPath, paths, pathsDelimiter, pathsDelimiterPattern, postHook, preHook, privateToken, shellScripts, varsAssignor, varsAssignorPattern, varsDelimiter, varsDelimiterPattern, } = await resolveGetDotenvCliGenerateOptions(customOptions);
+    const { alias, debug, defaultEnv, description, dotenvToken, dynamicPath, env, excludeDynamic, excludeEnv, excludeGlobal, excludePrivate, excludePublic, loadProcess, log, logger, outputPath, paths, pathsDelimiter, pathsDelimiterPattern, postHook, preHook, privateToken, scripts, shell, varsAssignor, varsAssignorPattern, varsDelimiter, varsDelimiterPattern, } = await resolveGetDotenvCliGenerateOptions(customOptions);
     const excludeAll = !!excludeDynamic &&
         ((!!excludeEnv && !!excludeGlobal) ||
             (!!excludePrivate && !!excludePublic));
@@ -39673,8 +39694,10 @@ const generateGetDotenvCli = async (customOptions) => {
     ]
         .map((v) => v.join(varsAssignor))
         .join(varsDelimiter)}`, dotenvExpandFromProcessEnv)
-        .option('-c, --command <string>', 'shell command string, conflicts with cmd subcommand (dotenv-expanded)', dotenvExpandFromProcessEnv)
+        .option('-c, --command <string>', 'command executed according to the --shell option, conflicts with cmd subcommand (dotenv-expanded)', dotenvExpandFromProcessEnv)
         .option('-o, --output-path <string>', 'consolidated output file  (dotenv-expanded)', dotenvExpandFromProcessEnv, outputPath)
+        .addOption(new Option('-s, --shell [string]', `command execution shell, no argument for default OS shell or provide shell string${shell ? ` (default ${_.isBoolean(shell) ? 'OS shell' : shell})` : ''}`).conflicts('shellOff'))
+        .addOption(new Option('-S, --shell-off', `command execution shell OFF${!shell ? ' (default)' : ''}`).conflicts('shell'))
         .addOption(new Option('-p, --load-process', `load variables to process.env ON${loadProcess ? ' (default)' : ''}`).conflicts('loadProcessOff'))
         .addOption(new Option('-P, --load-process-off', `load variables to process.env OFF${!loadProcess ? ' (default)' : ''}`).conflicts('loadProcess'))
         .addOption(new Option('-a, --exclude-all', `exclude all dotenv variables from loading ON${excludeAll ? ' (default)' : ''}`).conflicts('excludeAllOff'))
@@ -39704,8 +39727,8 @@ const generateGetDotenvCli = async (customOptions) => {
         .option('--vars-delimiter-pattern <string>', 'vars delimiter regex pattern', varsDelimiterPattern)
         .option('--vars-assignor <string>', 'vars assignment operator string', varsAssignor)
         .option('--vars-assignor-pattern <string>', 'vars assignment operator regex pattern', varsAssignorPattern)
-        .addOption(new Option('--shell-scripts <string>')
-        .default(JSON.stringify(shellScripts))
+        .addOption(new Option('--scripts <string>')
+        .default(JSON.stringify(scripts))
         .hideHelp())
         .addCommand(batchCommand)
         .addCommand(cmdCommand, { isDefault: true })
@@ -39717,10 +39740,10 @@ const generateGetDotenvCli = async (customOptions) => {
         // Get raw CLI options from commander.
         const rawCliOptions = thisCommand.opts();
         // Extract current GetDotenvCliOptions from raw CLI options.
-        const { command, debugOff, excludeAll, excludeAllOff, excludeDynamicOff, excludeEnvOff, excludeGlobalOff, excludePrivateOff, excludePublicOff, loadProcessOff, logOff, shellScripts, ...rawCliOptionsRest } = rawCliOptions;
+        const { command, debugOff, excludeAll, excludeAllOff, excludeDynamicOff, excludeEnvOff, excludeGlobalOff, excludePrivateOff, excludePublicOff, loadProcessOff, logOff, scripts, shellOff, ...rawCliOptionsRest } = rawCliOptions;
         const currentGetDotenvCliOptions = rawCliOptionsRest;
-        if (shellScripts)
-            currentGetDotenvCliOptions.shellScripts = JSON.parse(shellScripts);
+        if (scripts)
+            currentGetDotenvCliOptions.scripts = JSON.parse(scripts);
         // Merge current & parent GetDotenvCliOptions.
         const mergedGetDotenvCliOptions = _.defaultsDeep(currentGetDotenvCliOptions, parentGetDotenvCliOptions ?? {});
         // Resolve flags.
@@ -39732,12 +39755,17 @@ const generateGetDotenvCli = async (customOptions) => {
         mergedGetDotenvCliOptions.excludePublic = resolveExclusionAll(mergedGetDotenvCliOptions.excludePublic, excludePublicOff, excludePublic, excludeAll, excludeAllOff);
         mergedGetDotenvCliOptions.log = resolveExclusion(mergedGetDotenvCliOptions.log, logOff, log);
         mergedGetDotenvCliOptions.loadProcess = resolveExclusion(mergedGetDotenvCliOptions.loadProcess, loadProcessOff, loadProcess);
+        mergedGetDotenvCliOptions.shell = shellOff
+            ? false
+            : !_.isUndefined(mergedGetDotenvCliOptions.shell)
+                ? mergedGetDotenvCliOptions.shell
+                : !_.isUndefined(shell)
+                    ? shell
+                    : false;
         if (mergedGetDotenvCliOptions.debug && parentGetDotenvCliOptions)
             logger.debug('\n*** parent command GetDotenvCliOptions ***\n', parentGetDotenvCliOptions);
         if (mergedGetDotenvCliOptions.debug)
             logger.debug('\n*** current command raw options ***\n', rawCliOptions);
-        if (mergedGetDotenvCliOptions.debug)
-            logger.debug('\n*** current command GetDotenvCliOptions ***\n', currentGetDotenvCliOptions);
         if (mergedGetDotenvCliOptions.debug)
             logger.debug('\n*** merged GetDotenvCliOptions ***\n', {
                 mergedGetDotenvCliOptions,
@@ -39757,21 +39785,21 @@ const generateGetDotenvCli = async (customOptions) => {
         // Execute post-hook.
         if (postHook)
             await postHook(dotenv);
-        // Execute shell command.
+        // Execute command.
         if (command && thisCommand.args.length) {
             logger.error(`--command option conflicts with cmd subcommand.`);
             process.exit(0);
         }
         if (command) {
-            const shellCommand = mergedGetDotenvCliOptions.shellScripts?.[command] ?? command;
+            const cmd = resolveCommand(mergedGetDotenvCliOptions.scripts, command);
             if (mergedGetDotenvCliOptions.debug)
-                logger.debug('\n*** shell command ***\n', shellCommand);
-            await execaCommand(shellCommand, {
+                logger.debug('\n*** command ***\n', cmd);
+            await execaCommand(cmd, {
                 env: {
                     ...process.env,
                     getDotenvCliOptions: JSON.stringify(_.omit(mergedGetDotenvCliOptions, ['logger'])),
                 },
-                shell: true,
+                shell: resolveShell(mergedGetDotenvCliOptions.scripts, command, mergedGetDotenvCliOptions.shell),
                 stdio: 'inherit',
             });
         }

package/package.json

@@ -22,7 +22,7 @@
     "@commander-js/extra-typings": "^12.1.0",
     "@eslint/js": "^9.3.0",
     "@rollup/plugin-alias": "^5.1.0",
-    "@rollup/plugin-commonjs": "^25.0.7",
+    "@rollup/plugin-commonjs": "^25.0.8",
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^15.2.3",
     "@rollup/plugin-terser": "^0.4.4",
@@ -34,7 +34,7 @@
     "@types/fs-extra": "^11.0.4",
     "@types/lodash": "^4.17.4",
     "@types/mocha": "^10.0.6",
-    "@types/node": "^20.12.12",
+    "@types/node": "^20.12.13",
     "auto-changelog": "^2.4.0",
     "chai": "^5.1.1",
     "cross-env": "^7.0.3",
@@ -45,7 +45,7 @@
     "eslint-plugin-tsdoc": "^0.2.17",
     "fs-extra": "^11.2.0",
     "jsdom-global": "^3.0.2",
-    "lefthook": "^1.6.12",
+    "lefthook": "^1.6.14",
     "mocha": "^10.4.0",
     "nyc": "^15.1.0",
     "prettier": "^3.2.5",
@@ -57,7 +57,7 @@
     "ts-node": "^10.9.2",
     "tslib": "^2.6.2",
     "typescript": "^5.4.5",
-    "typescript-eslint": "^7.10.0"
+    "typescript-eslint": "^7.11.0"
   },
   "exports": {
     ".": {
@@ -124,6 +124,7 @@
   },
   "scripts": {
     "build": "rimraf dist && rollup --config rollup.config.ts --configPlugin @rollup/plugin-typescript",
+    "cli": "node dist/getdotenv.cli.mjs",
     "lint": "eslint src/** && prettier -c src",
     "lint:fix": "eslint --fix src/** && prettier --write src",
     "release": "release-it",
@@ -131,5 +132,5 @@
   },
   "type": "module",
   "types": "dist/index.d.ts",
-  "version": "4.3.2"
+  "version": "4.4.1"
 }