Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

prune

Prune the uv cache — deletes unused download archives, wheels, and source artifacts that uv has cached but no longer needs.

Usage

scoop prune

This is a thin wrapper around uv cache prune. uv decides what’s safe to delete; scoop just forwards the result so you don’t have to remember the exact invocation.

When to use

  • After uninstalling Python versions you no longer need
  • When disk space on ~/.cache/uv/ is filling up
  • As part of regular cleanup, paired with scoop gc for orphan virtualenvs

Options

OptionDescription
--jsonOutput the result as JSON

Examples

# Standard cleanup
scoop prune

# Capture freed-bytes for a script
scoop prune --json | jq -r '.data.output'

See also

  • gc — garbage-collect orphan virtual environments
  • doctor — health check (does not delete anything)