Install Node.js on macOS

Node.js is required for running tools like CodeX CLI, Gemini CLI, and CC-Switch.

Method 1: Official Installer

1. Visit https://nodejs.org
2. Download the LTS version for macOS (.pkg file)
3. Run the installer and follow the prompts
4. Verify installation:

node -v
npm -v

Method 2: Using Homebrew (Recommended)

If you have Homebrew installed:

brew install node

Verify:

node -v
npm -v

Method 3: Using fnm (Fast Node Manager)

fnm is the recommended way to manage multiple Node.js versions.

Install fnm

brew install fnm

Or via the install script:

curl -fsSL https://fnm.vercel.app/install | bash

Install Node.js

fnm install --lts
fnm use lts-latest
fnm default lts-latest

Add to Shell Profile

Add the following to your shell profile (~/.zshrc or ~/.bashrc):

eval "$(fnm env --use-on-cd --shell zsh)"

Then reload:

source ~/.zshrc

Method 4: Using nvm

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash

Restart your terminal, then:

nvm install --lts
nvm use --lts

Troubleshooting

node: command not found

• Open a new terminal window after installation
• Check your PATH: echo $PATH
• For fnm: ensure the eval line is in your shell profile

macOS Gatekeeper Warning

If macOS blocks the installer, go to System Preferences → Security & Privacy → click Open Anyway.