Skip to main content

​
Installation

npm install -g @runtools/cli

​
Verify Installation

runtools --version
# RunTools CLI v1.0.0

​
Requirements

  • Node.js 18+ or Bun 1.0+
  • macOS, Linux, or Windows (WSL recommended)

​
Shell Completion

​
Bash

runtools completion bash >> ~/.bashrc
source ~/.bashrc

​
Zsh

runtools completion zsh >> ~/.zshrc
source ~/.zshrc

​
Fish

runtools completion fish > ~/.config/fish/completions/runtools.fish

​
Update CLI

npm update -g @runtools/cli

​
Uninstall

npm uninstall -g @runtools/cli

​
Troubleshooting

​
Command not found

Make sure npm global bin is in your PATH: 
# Check npm bin location
npm bin -g

# Add to PATH (add to ~/.bashrc or ~/.zshrc)
export PATH="$(npm bin -g):$PATH"

​
Permission errors (macOS/Linux)

If you get EACCES errors: 
# Option 1: Fix npm permissions
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

# Option 2: Use a node version manager (recommended)
# Install nvm or fnm

​
Next Steps

Authentication

Login to your RunTools account