feat: CLI implementation and enhance command-line features

- Updated the GitHub Actions workflow to use double quotes for npm cache.
- Added CLI usage instructions and options to the README.md.
- Introduced new dependencies: cross-spawn and minimist for improved command execution and argument parsing.
- Refactored CLI tests to use the new runNodeCli function instead of runCli.
- Created a new node-cli.ts file to encapsulate CLI logic and options parsing.
- Enhanced the main CLI function to support multiple command-line flags and improved error handling.
- Updated load.ts to utilize the new runNodeCli function.

Author: marcocesarato

.github/workflows/node.js.yml

@@ -24,7 +24,7 @@ jobs:
               uses: actions/setup-node@v4
               with:
                   node-version: ${{ matrix.node-version }}
-                  cache: 'npm'
+                  cache: "npm"
             - name: Install dependencies
               run: npm ci
             - name: Build production bundle

README.md

@@ -270,6 +270,51 @@ $ DOTENV_CONFIG_<OPTION>=value node -r dotenv-mono/load your_script.js
 $ DOTENV_CONFIG_ENCODING=latin1 DOTENV_CONFIG_DEBUG=true node -r dotenv-mono/load your_script.js dotenv_config_path=/custom/path/to/.env
 ```
 
+### CLI
+
+You can use `dotenv-mono` as a command-line tool to run commands with environment variables loaded from your `.env` files. This is similar to `dotenv-cli` but with all the enhanced features of `dotenv-mono`.
+
+```bash
+# Basic usage - load .env and run a command
+dotenv-mono -- node your_script.js
+
+# Load specific .env file
+dotenv-mono -e .env.production -- node your_script.js
+
+# Load multiple .env files
+dotenv-mono -e .env.local -e .env.production -- node your_script.js
+
+# Set additional variables
+dotenv-mono -v NODE_ENV=production -v DEBUG=true -- node your_script.js
+
+# Print a variable value
+dotenv-mono -p NODE_ENV
+
+# Debug mode - see what files would be loaded
+dotenv-mono --debug -e .env.production
+
+# Use all dotenv-mono features
+dotenv-mono --cwd /path/to/project --extension server --depth 3 -- node server.js
+```
+
+#### CLI Options
+
+| Option                | Description                                                                                      |
+| --------------------- | ------------------------------------------------------------------------------------------------ |
+| `--help`              | Print help message                                                                               |
+| `--debug`             | Output the files that would be processed but don't actually parse them or run the command        |
+| `-e <path>`           | Parse the file `<path>` as a `.env` file and add variables to the environment (multiple allowed) |
+| `-v <name>=<value>`   | Put variable `<name>` into environment using `<value>` (multiple allowed)                        |
+| `-p <variable>`       | Print value of `<variable>` to the console                                                       |
+| `--no-expand`         | Skip variable expansion                                                                          |
+| `--override`          | Override system variables                                                                        |
+| `--cwd <path>`        | Specify the current working directory                                                            |
+| `--depth <number>`    | Specify the max depth to reach when finding up the folder tree                                   |
+| `--encoding <enc>`    | Specify the encoding of your file containing environment variables                               |
+| `--extension <ext>`   | Specify to load specific dotenv file used only on specific apps/packages                         |
+| `--defaults <file>`   | Specify the defaults dotenv filename                                                             |
+| `--priorities <json>` | Specify the criteria of the filename priority to load as dotenv file                             |
+
 ## 💡 Methods
 
 ### Config

package-lock.json

@@ -38,11 +38,15 @@
 		"coverage": "jest --coverage && start coverage/index.html"
 	},
 	"dependencies": {
+		"cross-spawn": "^7.0.6",
 		"dotenv": "^17.2.0",
-		"dotenv-expand": "^12.0.2"
+		"dotenv-expand": "^12.0.2",
+		"minimist": "^1.2.8"
 	},
 	"devDependencies": {
+		"@types/cross-spawn": "^6.0.6",
 		"@types/jest": "^30.0.0",
+		"@types/minimist": "^1.2.5",
 		"@types/mock-fs": "^4.13.4",
 		"@types/node": "^24.0.14",
 		"@typescript-eslint/eslint-plugin": "^8.37.0",
@@ -86,49 +90,59 @@
 		"url": "git+https://github.com/marcocesarato/dotenv-mono.git"
 	},
 	"keywords": [
-		"monorepo",
 		"dotenv",
+		"dotenv-mono",
 		"dotenv-expand",
-		"expand",
-		"vars",
+		"monorepo",
+		"env",
+		"environment",
+		"environment variables",
+		"env loader",
+		"env manager",
+		"env file",
+		".env",
+		".env.local",
+		".env.development",
+		".env.production",
+		"centralized",
+		"config",
+		"configuration",
 		"variables",
-		"load",
+		"vars",
 		"loader",
-		"mono",
-		"one",
-		"single",
-		"centralized",
-		"repo",
-		"changes",
+		"load",
 		"edit",
+		"save",
+		"manipulate",
 		"priorities",
-		"env",
-		"environemnt",
-		"local",
-		"test",
-		"production",
-		"development",
-		"prod",
-		"dev",
+		"default",
+		"defaults",
+		"shared",
+		"share",
+		"single",
+		"one",
+		"repo",
 		"apps",
 		"packages",
 		"nextjs",
 		"next.js",
 		"react",
 		"angular",
-		".env",
-		".env.local",
-		".env.development",
-		".env.production",
 		"turbo",
 		"turborepo",
 		"storybook",
-		"shared",
-		"share",
-		"default",
-		"defaults",
 		"cli",
 		"console",
-		"preload"
+		"node",
+		"typescript",
+		"js",
+		"javascript",
+		"test",
+		"production",
+		"development",
+		"prod",
+		"dev",
+		"preload",
+		"changes"
 	]
 }