Troubleshooting — Installation
scd not found after install
macOS / Linux: Check where npm puts global binaries:
npm config get prefix
Add the bin subdirectory to your PATH if missing:
# Add to ~/.zshrc or ~/.bash_profile:
export PATH="$(npm config get prefix)/bin:$PATH"
source ~/.zshrc
If you use nvm, run nvm use 22 (or nvm alias default 22 to make it permanent) and try again.
Windows: npm may not have added its global bin directory to PATH. Run this in PowerShell, then open a new terminal:
[System.Environment]::SetEnvironmentVariable(
"PATH",
$env:PATH + ";$env:APPDATA\npm",
[System.EnvironmentVariableTarget]::User
)
Permission error on npm install -g (Linux)
Do not use sudo npm install -g. Configure npm to use a user-local prefix instead:
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH="$HOME/.npm-global/bin:$PATH" # add to ~/.bashrc too
npm install -g @activemind/scd
scd points to wrong location after switching Node.js versions
Clear your shell's command cache:
hash -r
which scd
If still missing, reinstall for the current Node.js version:
nvm use 22
npm install -g @activemind/scd