Menu
Use this skill to execute commands when a user requests to run nodejs/npm commands, and you can specify the desired nodejs version.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | nodapt |
| description | Use this skill to execute commands when a user requests to run nodejs/npm commands, and you can specify the desired nodejs version. |
nodapt is a virtual Node.js environment designed to provide a simple and reliable version management tool for Node.js projects. It can automatically select and install the appropriate version of Node.js based on the version constraints in package.json and run commands.
If your package.json file contains Node.js version constraints, or if the user explicitly requests to run Node.js with a specific version or manage installed versions, then you should use this skill to run the command.
If the user requests to use or remove a specific Node.js version but does not provide a valid version format, ask the user to clarify the desired version before executing the command.
If the user does not have nodapt installed, you can suggest them to install it using the instructions in the Installation section below.
Use this skill when:
package.json specifies a Node.js version in engines.nodeRun commands with the Node.js version specified in package.json:
# Run node command with auto-detected version
nodapt node -v
# Run npm command
nodapt npm install
# Run any node-based tool
nodapt npx create-react-app my-app
Use a specific Node.js version for a command:
# Use exact version
nodapt use v14.17.0 node app.js
# Use major version (latest 22.x)
nodapt use 22 node script.js
# Use semantic versioning
nodapt use ^16.14.0 npm test
List installed versions:
nodapt ls
# Example output:
# v14.17.0
# v16.20.2
# v18.18.0
List available remote versions:
nodapt ls-remote
Remove a specific version:
nodapt rm v14.17.0
Clean all installed versions:
nodapt clean
When a user asks to run a project, first check if package.json exists and has Node.js version constraints:
# Example package.json
{
"engines": {
"node": ">=16.0.0 <19.0.0"
}
}
# Run the project
nodapt npm start
When a user needs to test code with different Node.js versions:
# Test with Node.js 14
nodapt use 14 npm test
# Test with Node.js 16
nodapt use 16 npm test
# Test with Node.js 18
nodapt use 18 npm test
Install tools without affecting the system Node.js:
# Install a global tool
nodapt npm install -g yarn
# Use the installed tool
nodapt yarn build
If the specified version is not available:
$ nodapt use v14.17.0 node -v
Error: Version v14.17.0 not found
# Check available versions
nodapt ls-remote | grep 14.17
If the user provides an invalid version format, ask for clarification:
# User: "use version 14"
# Assistant: "Would you like to use Node.js 14.x (latest minor version) or specifically v14.0.0?"
# User: "remove the old version"
# Assistant: "Please specify the exact version to remove, e.g., 'nodapt rm v14.17.0'"
When auto-detection fails:
$ nodapt node -v
Error: No compatible Node.js version found for engines.node: ">=99.0.0"
# Suggested action: Ask user to modify package.json or specify a version manually
$ cask install github.com/axetroy/nodapt
$ npm install -g nodapt
Check the source repository for binary releases.
nodapt --version
Set custom Node.js mirror (useful in China):
export NODE_MIRROR="https://registry.npmmirror.com/-/binary/node/"
Set custom installation directory:
export NODE_ENV_DIR="/custom/path/.nodapt"
Enable debug output:
export DEBUG=1
nodapt node -v
Always check for package.json: Before running commands with nodapt, check if the project has a package.json with Node.js version constraints.
Use version ranges wisely: When specifying versions, use semantic versioning ranges (e.g., ^16.14.0, >=14.0.0 <17.0.0).
Prefer automatic selection: Let nodapt auto-detect the version from package.json when possible.
Clean up old versions: Periodically run nodapt clean to remove unused Node.js versions and free disk space.
Specify exact versions in CI/CD: In automated environments, always specify exact versions to ensure reproducibility.
# Ensure nodapt is installed
which nodapt
# If not found, reinstall
npm install -g nodapt
# On Unix systems, check permissions
ls -la $(which nodapt)
# Or install without sudo using npm
npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH
npm install -g nodapt
# Use Chinese mirror for faster downloads
export NODE_MIRROR="https://registry.npmmirror.com/-/binary/node/"
nodapt node -v
User: "Run my Node.js app"
# Assistant should check for package.json first
nodapt node app.js
User: "Test with Node.js 18"
nodapt use 18 npm test
User: "Install dependencies"
nodapt npm install
User: "Which Node.js versions do I have installed?"
nodapt ls
User: "Remove Node.js 14"
nodapt rm v14.17.0
For complete help information:
nodapt --help
This displays all available commands, options, and examples.
Find the source code and report issues at: https://github.com/axetroy/nodapt