Full-stack-skills nvm-troubleshooting-macos

Diagnose and fix nvm issues on macOS, including zsh/bash profile not loading, PATH priority conflicts, permission errors, and Homebrew Node conflicts. Use when the user reports nvm not found on macOS, nvm command not working in zsh or Terminal, or PATH priority issues after macOS updates.

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-troubleshooting-macos" ~/.claude/skills/partme-ai-full-stack-skills-nvm-troubleshooting-macos && rm -rf "$T"

manifest: skills/nvm-skills/nvm-troubleshooting-macos/SKILL.md

nvm Troubleshooting (macOS)

Diagnose and fix common nvm problems on macOS including profile loading and PATH conflicts.

Workflow

Run diagnostic checks:

echo "Shell: $SHELL"
echo "NVM_DIR: $NVM_DIR"
cat ~/.zshrc | grep -n nvm
echo $PATH | tr ':' '\n' | head -10

Check profile load order (macOS zsh reads these in order):
- ```
~/.zshenv
```
  (always)
- ```
~/.zprofile
```
  (login shells)
- ```
~/.zshrc
```
  (interactive shells)

Fix the most common issue (nvm lines missing from

~/.zshrc

# Add to ~/.zshrc:
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

Verify the fix:

source ~/.zshrc
command -v nvm   # Should print "nvm"
nvm --version
node -v

Note: General verification belongs to nvm-verify. For Linux/WSL issues, use nvm-troubleshooting-linux.

Example file map

```
examples/troubleshooting-macos.md
```
- macOS-specific troubleshooting
```
examples/macos-troubleshooting.md
```
- Additional macOS guidance
```
examples/problems.md
```
- Common problems and solutions
```
examples/compatibility-issues.md
```
- Known compatibility issues

Keywords

macos, zsh, bash, PATH, permissions, troubleshooting, profile, nvm not found