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.