Full-stack-skills 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.

install
source · Clone the upstream repo
git clone https://github.com/partme-ai/full-stack-skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/partme-ai/full-stack-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/nvm-skills/nvm-shell-integration" ~/.claude/skills/partme-ai-full-stack-skills-nvm-shell-integration && rm -rf "$T"
manifest: skills/nvm-skills/nvm-shell-integration/SKILL.md
source content

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
    ):

    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:

    nvm deactivate   # Removes nvm from PATH, restores system node
    nvm use system   # Switch to system-installed Node
    
  3. Verify auto-switching works:

    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