feat: Update minimum Node.js version to 20 (#3277)

.github/workflows/ci.yml

@@ -17,7 +17,7 @@ jobs:
       contents: read # For checkout
     strategy:
       matrix:
-        node-version: [20.x]
+        node-version: [20.x, 22.x, 24.x]
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
@@ -62,7 +62,7 @@ jobs:
       pull-requests: write
     strategy:
       matrix:
-        node-version: [20.x] # Should match the build job's matrix
+        node-version: [20.x, 22.x, 24.x] # Should match the build job's matrix
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
@@ -124,7 +124,7 @@ jobs:
       pull-requests: write # For commenting
     strategy:
       matrix:
-        node-version: [20.x] # Should match the test job's matrix
+        node-version: [20.x, 22.x, 24.x] # Should match the test job's matrix
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4

CONTRIBUTING.md

@@ -88,8 +88,10 @@ This section guides contributors on how to build, modify, and understand the dev
 
 **Prerequisites:**
 
-1. Install [Node 18+](https://nodejs.org/en/download)
+1.  **Node.js**:
-2. Git
+    - **Development:** Please use Node.js `~20.19.0`. This specific version is required due to an upstream development dependency issue. You can use a tool like [nvm](https://github.com/nvm-sh/nvm) to manage Node.js versions.
+    - **Production:** For running the CLI in a production environment, any version of Node.js `>=20` is acceptable.
+2.  **Git**
 
 ### Build Process
 

docs/cli/configuration.md

@@ -332,7 +332,7 @@ Here's a conceptual example of what a context file at the root of a TypeScript p
 - When generating new TypeScript code, please follow the existing coding style.
 - Ensure all new functions and classes have JSDoc comments.
 - Prefer functional programming paradigms where appropriate.
-- All code should be compatible with TypeScript 5.0 and Node.js 18+.
+- All code should be compatible with TypeScript 5.0 and Node.js 20+.
 
 ## Coding Style:
 

package-lock.json

@@ -38,7 +38,7 @@
         "yargs": "^17.7.2"
       },
       "engines": {
-        "node": ">=18.0.0"
+        "node": ">=20.0.0"
       }
     },
     "node_modules/@alcalzone/ansi-tokenize": {
@@ -11252,7 +11252,7 @@
         "vitest": "^3.1.1"
       },
       "engines": {
-        "node": ">=18"
+        "node": ">=20"
       }
     },
     "packages/cli/node_modules/@testing-library/dom": {
@@ -11416,7 +11416,7 @@
         "vitest": "^3.1.1"
       },
       "engines": {
-        "node": ">=18"
+        "node": ">=20"
       }
     },
     "packages/core/node_modules/ignore": {

package.json

@@ -2,7 +2,7 @@
   "name": "@google/gemini-cli",
   "version": "0.1.9",
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   },
   "type": "module",
   "workspaces": [

packages/cli/package.json

@@ -75,6 +75,6 @@
     "vitest": "^3.1.1"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   }
 }

packages/core/package.json

@@ -55,6 +55,6 @@
     "vitest": "^3.1.1"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   }
 }