Installation
Installation and setup guides
FAQs
How do I install Node.js to run the Vibgrate CLI?
The Vibgrate CLI requires Node.js >= 22.0.0. On macOS, install via Homebrew: brew install node@22. On Windows, download from nodejs.org or use winget install OpenJS.NodeJS.LTS. On Linux, use your package manager or nvm: nvm install 22. Verify installation with node --version.
How do I install Node.js on macOS?
Use Homebrew (recommended): brew install node@22. Alternatively, use nvm for version management: curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash then nvm install 22. You can also download the installer directly from nodejs.org. After installation, verify with node --version to ensure you have version 20 or higher.
How do I install Node.js on Windows?
Use winget (recommended): winget install OpenJS.NodeJS.LTS. Alternatively, download the Windows installer from nodejs.org and run it. You can also use Chocolatey: choco install nodejs-lts. After installation, open a new terminal and verify with node --version. Note: You may need to restart your terminal or computer for PATH changes to take effect.
How do I install the Vibgrate CLI?
Install as a dev dependency in your project: npm install -D @vibgrate/cli@latest (or use pnpm, yarn, bun). You can also run without installing using npx: npx @vibgrate/cli scan. For global installation: npm install -g @vibgrate/cli@latest. After installation, run vibgrate --help to see available commands.
Should I use npx or install Vibgrate globally?
Use npx @vibgrate/cli scan for one-off scans without installation — always gets the latest version. For projects, install as devDependency (npm install -D @vibgrate/cli@latest) for reproducible scans with a pinned version. Avoid global install (npm install -g) in CI; prefer npx or project-local install for consistency.
How do I update the Vibgrate CLI?
Run vg update to check for and install updates. Use --check to see if updates are available without installing. For project installs: npm update @vibgrate/cli@latest or reinstall with npm install -D @vibgrate/cli@latest. For npx users, it automatically fetches the latest version each time.