Try the Vibgrate CLI with npx (No Install)

Sometimes you just want to try the Vibgrate CLI once, or run it in a clean CI container, without a global install. The npx workflow downloads and runs @vibgrate/cli on demand. This is the fastest way to see your DriftScore.

Prerequisites

• Node.js 18+ with npx
• A project directory to scan

Steps

1. Confirm npx is available

npx ships with modern npm.

npx --version

2. Run a no-install scan

The no-install form names the package and the subcommand explicitly. Run it from your project root.

npx @vibgrate/cli scan

npx fetches the package, runs the scan against the current directory, and prints a results table.

3. Read the results

The output includes a DriftScore from 0 to 100 summarizing how far your dependencies have drifted from current versions, plus the drift findings that contribute to it.

4. Add a failure gate

For a quick CI check, fail the run when issues at or above a severity are present.

npx @vibgrate/cli scan --fail-on error

The command exits non-zero when matching findings exist, which lets a pipeline block on drift.

5. Decide whether to install

If you scan often, a persistent install avoids re-downloading the package each run.

Verification

The scan prints a results table and a DriftScore. With --fail-on error the exit code is non-zero when qualifying findings exist and zero otherwise, which you can check in a shell.

Next Steps

• Scanning regularly? Install the CLI globally with npm.
• Want a config file and .vibgrate directory? Run vg init.
• Adding this to a pipeline? Explore the failure gate and exit codes tutorials.