dvc-gc

dvc gc [options]

dvc gc removes unused files from the DVC cache, freeing disk space. At least one scope option (-w, -a, -T, -A, --all-experiments, -n, --rev, or --date) must be specified to define which data to keep.The cache accumulates files from all tracked versions. Garbage collection identifies and removes files no longer referenced by any specified commits, branches, or tags.The cloud option (-c) extends cleaning to remote storage, removing files not needed by the specified scope.

-w, --workspace

Keep files used in current workspace.

Keep files used in all Git branch tips.

Keep files used in all Git tags.

Keep files used in all Git commits.

Keep files used in all experiments.

Also garbage collect in remote storage in addition to local cache.

Target a specific remote for garbage collection.

Keep data from the last NUM commits (default: 1).

Keep data files from a specified Git commit.

Keep cached data from commits after the specified date.

Keep data not present in remote storage.

Skip confirmation prompts.

Number of concurrent jobs for cloud operations.

Preview what would be deleted without executing.

Include specified projects when sharing a cache directory.

Irreversible operation - removed cache files must be re-downloaded or re-computed. Consider keeping all branches for collaboration. Cloud gc may affect other users' access to data. A scope option is required; running without one produces an error.

dvc gc implements garbage collection for DVC caches, similar to git gc but for versioned data files, enabling storage management in ML projects.

dvc(1), dvc-init(1), dvc-add(1), git-gc(1)