Skip to content
mawesome

npm-vm documentation

@mawesome/npm-vm@0.1.0

Reference documentation for @mawesome/npm-vm, a per-project npm version manager: every npm and npx call runs the version the project declares in devEngines.packageManager, whatever Node is active and whatever nvm or fnm did to PATH.

Contents

Section titled “Contents”
  • Get started: install in one command, pin a version, check with doctor.
  • How it works: the shim, the launcher, resolution order, the cache and the exit codes.
  • CLI reference: every command, flag, environment variable and message.
  • Shells and Node managers: what nvm and fnm do to PATH, the prompt hook, link mode, Windows.
  • Security: what is verified, what is never read, and the threat model.
  • GitHub Action: the same npm in CI, cached between runs.