A Go binary that handles the full cache flow — request, extraction, retries, and npm ci fallback. Drop it into any CI runner.
Pre-built binaries for Linux and Windows. Pick the one matching your CI runner architecture. Latest: 1.0.0.
Set four environment variables and run the binary. It reads your manifests, calls the API, extracts node_modules, retries up to five times on failure, and falls back to npm ci automatically.
curl -fsSL "https://www.node-modules-cache.com/nmc-cli/nmc-linux-amd64" \
-o nmc && chmod +x nmc
export NMC_TOKEN="${NMC_ACCESS_TOKEN}"
export NMC_BASE_DIR="/path/to/project"
export NMC_DOCKER_IMAGE="node:22.15.0"
export NMC_ARCHITECTURE="x64"
./nmcNMC_TOKEN
Your API access token. Store it as a CI secret.
NMC_BASE_DIR
Absolute path to your project directory. package.json and package-lock.json must be here.
NMC_DOCKER_IMAGE
Your CI Docker image reference, e.g. node:22.15.0. Used as part of the cache key.
NMC_ARCHITECTURE
x64 or arm64. Must match your runner's CPU architecture.
Append a release tag to any download URL to pin to a specific version. Without a tag, you always get the latest.
curl -fsSL "https://www.node-modules-cache.com/nmc-cli/nmc-linux-amd64/1.0.0" -o nmc && chmod +x nmc1.0.0
0.0.3-rc.1
0.0.2