DOKK / manpages / debian 13 / datalad / datalad-clean.1.en
datalad clean(1) General Commands Manual datalad clean(1)

datalad clean - clean up after DataLad (possible temporary files etc.)

datalad clean [-h] [-d DATASET] [--what [WHAT ...]] [--dry-run] [-r] [-R LEVELS] [--version]

Removes temporary files and directories left behind by DataLad and git-annex in a dataset.

Clean all known temporary locations of a dataset::


% datalad clean

Report on all existing temporary locations of a dataset::


% datalad clean --dry-run

Clean all known temporary locations of a dataset and all its subdatasets::


% datalad clean -r

Clean only the archive extraction caches of a dataset and all its subdatasets::


% datalad clean --what cached-archives -r

Report on existing annex transfer files of a dataset and all its subdatasets::


% datalad clean --what annex-transfer -r --dry-run

show this help message. --help-np forcefully disables the use of a pager for displaying the help message
specify the dataset to perform the clean operation on. If no dataset is given, an attempt is made to identify the dataset in current working directory. Constraints: Value must be a Dataset or a valid identifier of a Dataset (e.g. a path) or value must be NONE
What to clean. If none specified -- all known targets are considered. Constraints: value must be one of ('cached-archives', 'annex-tmp', 'annex-transfer', 'search-index') or value must be NONE
Report on cleanable locations - not actually cleaning up anything.
if set, recurse into potential subdatasets.
limit recursion into subdatasets to the given number of levels. Constraints: value must be convertible to type 'int' or value must be NONE
show the module and its version which provides the command


datalad is developed by The DataLad Team and Contributors <team@datalad.org>.

2025-06-15 datalad clean 1.1.5