AI Agent Skill HUB
multiAI Summary Pending

nvm-shell-integration

Configure automatic nvm version switching when changing directories, using shell hooks for bash, zsh, and fish. Covers auto-use on cd, PATH restoration, and nvm deactivate. Use when the user wants automatic Node version switching per project, nvm use to run on directory change, or needs to deactivate nvm and restore system PATH.

223 stars
bypartme-ai
View on GitHubInstallation ↓

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/nvm-shell-integration/SKILL.md --create-dirs "https://raw.githubusercontent.com/partme-ai/full-stack-skills/main/skills/nvm-skills/nvm-shell-integration/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/nvm-shell-integration/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How nvm-shell-integration Compares

Feature / Agentnvm-shell-integrationStandard Approach
Platform SupportmultiLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Configure automatic nvm version switching when changing directories, using shell hooks for bash, zsh, and fish. Covers auto-use on cd, PATH restoration, and nvm deactivate. Use when the user wants automatic Node version switching per project, nvm use to run on directory change, or needs to deactivate nvm and restore system PATH.

Which AI agents support this skill?

This skill is compatible with multi.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# nvm Shell Integration

Add automatic `nvm use` on directory changes so the correct Node version activates per project.

## Workflow

1. **Add auto-switching for bash** (append to `~/.bashrc`):
   ```bash
   cdnvm() {
     command cd "$@" || return $?
     nvm_path="$(nvm_find_up .nvmrc | command tr -d '\n')"
     if [ -n "$nvm_path" ]; then
       local nvm_node_version=$(nvm version "$(cat "$nvm_path/.nvmrc")")
       if [ "$nvm_node_version" = "N/A" ]; then
         nvm install
       elif [ "$nvm_node_version" != "$(nvm version)" ]; then
         nvm use
       fi
     fi
   }
   alias cd='cdnvm'
   ```

2. **Deactivate nvm and restore PATH** when needed:
   ```bash
   nvm deactivate   # Removes nvm from PATH, restores system node
   nvm use system   # Switch to system-installed Node
   ```

3. **Verify auto-switching works:**
   ```bash
   echo "20" > /tmp/test-project/.nvmrc
   cd /tmp/test-project   # Should auto-switch to Node 20
   node -v                # Should show v20.x.x
   ```

**Note:** Base shell loading belongs to nvm-setup. This skill adds deeper integration on top.

### Example file map

- `examples/shell-integration.md` - Overview of integration options
- `examples/auto-use-bash.md` - Bash auto-switching hook
- `examples/auto-use-zsh.md` - Zsh auto-switching hook
- `examples/auto-use-fish.md` - Fish auto-switching hook
- `examples/restore-path.md` - PATH restoration and nvm deactivate

## Keywords

shell integration, auto use, PATH restore, nvm deactivate, auto switch, cdnvm