# Volta Global Tool Installation Rule
## Rule
All global CLI tools MUST be installed with `volta install`, NEVER with `npm install -g` or `yarn global add`. This ensures tools are project-aware and cleanly managed.
## Why
Volta-installed globals use the project's pinned Node version when run inside a project. npm globals always use the system Node, causing version mismatches and subtle bugs.
## Good
```bash
volta install typescript
volta install prettier
volta install eslint
volta install tsx
```
## Bad
```bash
npm install -g typescript # Uses system Node always
yarn global add prettier # Not managed by Volta
sudo npm install -g eslint # Never use sudo!
```
## Migration from npm globals
```bash
# List npm globals
npm list -g --depth=0
# Reinstall through Volta
npm uninstall -g typescript prettier eslint
volta install typescript prettier eslint
# Verify
volta list all
```
## Exception
```bash
# Only exception: tools that manage Volta itself
# npm/yarn are managed by Volta directly via volta pin
```