Home

Awesome

Projclean

CI Crates

Project dependencies & build artifacts cleanup tool.

screenshot

Install

With cargo

cargo install projclean

Binaries on macOS, Linux, Windows

Download from Github Releases, unzip and add projclean to your $PATH.

CLI

Usage: projclean [OPTIONS] [RULES]...

Arguments:
  [RULES]...  Search rules, e.g. node_modules target@Cargo.toml

Options:
  -C, --cwd <DIR>         Start searching from <DIR> [default: .]
  -x, --exclude <DIR>     Exclude directories from search, e.g. ignore1,ignore2
  -t, --time <[+|-]DAY>   Path was last modified less than, more than or exactly <DAY> days
  -s, --size <[+|-]SIZE>  Path uses less than, more than or exactly <SIZE> units (K|M|G|T) of space
  -D, --delete-all        Automatically delete all found targets
  -P, --print             Print the found targets
  -h, --help              Print help
  -V, --version           Print version

Clean up node_modules.

projclean node_modules

Clean up various types of projects.

projclean node_modules target@Cargo.toml

Start searching from a specific directory with -C or --cwd

projclean -C $HOME node_modules       # equal to `cd $HOME && projclean node_modules`

Find node_modules with the latest updates over 30 days and occupy more than 1G disk space.

projclean node_modules --time +30 --size +1G

Search Rule

Projclean find targets according search rule.

Rule consist of two parts:

<target[,target...]>[@detect[,detect...]]
projectrule
nodejsnode_modules
cargotarget@Cargo.toml
maventarget@pom.xml
gradle.gradle,build@build.gradle,build.gradle.kts
cmakebuild@CMakeLists.txt
composervendor@composer.json
dotnetbin,obj@*.csproj,*.fsproj
vs.vs,Debug,Release@*.sln
vc++Debug,Release@*.vcxproj
swift.build,.swiftpm@Package.swift
podPods@Podfile
pub.dart_tool,build@pubspec.yaml
sbttarget,project/target@build.sbt
jupyter.ipynb_checkpoints@*.ipynb
zigzig-cache,zig-out@build.zig
rebar_build@rebar.config
dune_build@dune-project
mix_build@mix.exs
stack.stack-work@stack.yaml
godot.godot@project.godot

License

Copyright (c) 2022-2024 projclean-developers.

argc is made available under the terms of either the MIT License or the Apache License 2.0, at your option.

See the LICENSE-APACHE and LICENSE-MIT files for license details.