Install the Vibgrate CLI on Windows

This guide covers installing the Vibgrate CLI (@vibgrate/cli) on Windows. After installation the scanner is available as vg, and running a bare vg scans the current directory and reports a DriftScore.

Prerequisites

• Windows 10 or 11 with Windows Terminal or PowerShell
• Node.js 18 or newer if you install through npm (run node --version to check)
• Permission to install software for your user account

Install with npm (global)

From PowerShell or Windows Terminal:

npm install -g @vibgrate/cli

Then scan the current directory:

vg

Install with the PowerShell installer

If you would rather not use npm, the PowerShell installer fetches a self-contained build:

iwr https://vibgrate.com/install.ps1 -useb | iex

Close and reopen your terminal afterward so the updated PATH is applied.

Verify the installation

vg --version

Then run a scan from inside a project folder:

vg

Troubleshooting

• vg is not recognized — open a new terminal window so PATH updates take effect.
• Script execution is blocked — your PowerShell execution policy may prevent the installer from running. Use the npm install method instead, or adjust your execution policy according to your organization's guidance.
• Corporate proxy — if downloads fail behind a proxy, configure npm's proxy settings or use the npm install path.

Related

After installing, read the first scan walkthrough and understanding your first DriftScore. To try Vibgrate without installing, use npx @vibgrate/cli scan.