volta-node-cleanup

Delete obsolete Volta-managed Node.js version artifacts from ~/.volta on macOS.

Updated Jun 18, 2025
One-click install
npx skills add https://github.com/ekozmdev/my-codex-cli-settings --skill volta-node-cleanup
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: volta-node-cleanup
Source: https://github.com/ekozmdev/my-codex-cli-settings/tree/main/.agents/skills/volta-node-cleanup
Command: npx skills add https://github.com/ekozmdev/my-codex-cli-settings --skill volta-node-cleanup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill explains how to manually remove obsolete Volta-managed Node.js versions on macOS by deleting the actual artifacts when the built-in uninstall command is not available.

Core Features & Use Cases

  • Manual cleanup of outdated Volta Node.js versions by removing the corresponding directories under ~/.volta/tools.
  • Reclaim disk space when automatic uninstallation does not exist or is unavailable.
  • Use case: you upgraded Node.js in Volta and need to prune old versions to keep the environment tidy.

Quick Start

Remove the target version by executing the following commands: rm -rf "$HOME/.volta/tools/image/node/<version>" rm -f "$HOME/.volta/tools/inventory/node/node-v<version>-darwin-"*.tar.gz rm -f "$HOME/.volta/tools/inventory/node/node-v<version>-npm"

Frequently Asked Questions about volta-node-cleanup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I remove obsolete Volta Node.js versions on macOS?▼

You can manually remove obsolete Volta Node.js versions on macOS by using rm -rf to delete the target version directory under ~/.volta/tools/image/node/ and rm -f to delete the matching inventory tar.gz files.

What is the best way to reclaim disk space from Volta Node versions?▼

Reclaim disk space from Volta Node versions by directly deleting the installed artifacts in the ~/.volta directory structure, which removes the actual files consuming storage when automatic uninstall is unavailable.

Can I use the volta uninstall command to clean up old Node versions?▼

The volta uninstall command is currently unavailable or does not exist for this purpose, so you must use direct filesystem deletions targeting the ~/.volta directory to clean up old Node versions.

Does this manual Node cleanup method work on operating systems other than macOS?▼

This manual Node cleanup method targets the macOS-specific darwin tar.gz files in the ~/.volta inventory directory, so the deterministic deletion process is specifically designed for macOS environments.

Why does Volta keep old Node.js versions after upgrading?▼

Volta keeps old Node.js versions after upgrading because it lacks a built-in uninstall command to automatically prune outdated artifacts, leaving obsolete directories in the ~/.volta/tools/image/node/ path consuming disk space.