uv tool uninstall [OPTIONS] <NAME>...
uv tool uninstall --all

uv tool uninstall ruff

uv tool uninstall ruff black mypy

uv tool uninstall --all

# Using a shell prompt for confirmation
read -p "Are you sure you want to uninstall ruff? (y/n) " -n 1 -r
echo
if [[ $REPLY =~ ^[Yy]$ ]]; then
    uv tool uninstall ruff
fi

~/.local/share/uv/tools/
  ├── ruff/
  └── black/

~/.local/bin/
  ├── ruff
  ├── black
  └── blackd

~/.local/share/uv/tools/
  └── black/

~/.local/bin/
  ├── black
  └── blackd

uv tool uninstall nonexistent-tool
# Error: Tool 'nonexistent-tool' is not installed

uv tool uninstall ruff nonexistent black
# Uninstalls ruff and black, reports error for nonexistent

# Check if tool is listed
uv tool list | grep ruff

# Try to run the command (should fail)
ruff --version
# Output: command not found: ruff

# Uninstall tool (removes environment, keeps cached packages)
uv tool uninstall ruff

# Reinstall is fast due to cache
uv tool install ruff

# To also clear the cache
uv cache clean ruff

# Remove current installation
uv tool uninstall ruff

# Install specific version
uv tool install ruff==0.4.0

# Uninstall development tools
uv tool uninstall black ruff mypy pytest

# Or uninstall everything
uv tool uninstall --all

# Old way: uninstall then install
uv tool uninstall ruff
uv tool install ruff==0.4.0

# Better way: use --force
uv tool install --force ruff==0.4.0

# Check which command is being run
which ruff

# If it points to a different location, you may have another installation
# For example, via pip, pipx, or system package manager

# Check tool directory permissions
ls -la $(uv tool dir)

# May need to fix ownership
# (Only if tools were installed by different user)

# Manually remove the broken link
rm $(uv tool dir --bin)/ruff

# Then reinstall if needed
uv tool install ruff

# Stop any running instances of the tool
pkill -f ruff

# Then uninstall
uv tool uninstall ruff

# Uninstall all tools starting with 'py'
uv tool list | awk '{print $1}' | grep '^py' | xargs uv tool uninstall

# Keep ruff and black, remove others
uv tool list | awk '{print $1}' | grep -v '^ruff$\|^black$' | xargs uv tool uninstall

# Save current tools
uv tool list > installed-tools.txt

# Uninstall all
uv tool uninstall --all

# Later, reinstall from backup
cat installed-tools.txt | awk '{print $1}' | xargs -n1 uv tool install