free-dev-space

Instantly free up gigabytes of disk space by cleaning regenerable dev artifacts.

npx free-dev-space ~/dev

When the Docker daemon is reachable, the tool also reports disk usage for Docker images, containers, volumes, and build cache (via docker system df), lists the largest images and containers, and prompts before running:

docker system prune --all --volumes --force

This removes all stopped containers, all images not used by a running container, all unused volumes, and all build cache. Skip with --no-docker.

npx free-dev-space [path] [options]

-d, --dry-run    Preview what would be deleted
-y, --yes        Skip confirmation prompts
    --no-docker  Skip Docker scan and cleanup
-v, --version    Show version
-h, --help       Show help

# Scan current directory
npx free-dev-space .

# Preview without deleting
npx free-dev-space ~/dev --dry-run

# Skip confirmation
npx free-dev-space ~/projects -y

# Skip the Docker scan
npx free-dev-space . --no-docker

• Ambiguous directories (target, vendor) require sibling file checks (Cargo.toml, Gemfile)
• Platform-specific dirs (Pods, .gradle, build, .cxx) require parent directory validation
• Interactive confirmation before deletion (skip with --yes)
• File artifact deletion and Docker cleanup are confirmed separately
• --dry-run mode to preview
• Never recurses into matched directories
• Respects NO_COLOR and non-TTY environments
• Docker cleanup is opt-in per run (skip entirely with --no-docker); the prune command will not touch images currently used by a running container, but it will remove tagged images that are not in use — review the listing before confirming

Node.js >= 18.17

MIT