vm-cleanup

To free disk space in a Claude VM, you can run a phased cleanup process that targets npm and pip caches, build artifacts, and temporary files. It applies safe, incremental deletion steps to recover space without risking user data.

The safest way to clear npm and pip caches involves using explicit deletion targets rather than broad removals. This phased cleanup approach removes unnecessary temporary files and build artifacts while reporting before and after disk space metrics.

Yes, disk cleanup applies across both Cowork VM and Claude Code sessions. It remediates disk-full conditions by reclaiming space from caches and build artifacts to stabilize workflows in either environment.

If space recovery does not fully resolve the disk-full error, the cleanup process provides fallback recommendations to restart your environment. This ensures you can restore responsiveness when standard cache deletion is insufficient.

Phased disk cleanup manages space recovery through emergency, medium, and heavy steps, guiding safe incremental actions. Unlike manual deletion, it uses explicit targets for caches and artifacts, preventing accidental data loss while reporting before and after space.