Skip to main content

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