Projclean

Project dependecies & build artifacts cleaner.

screenshot

Why

Save space: Cleans unnecessary directories and files.
Very fast: Written in rust, optimized for concurrency.
Easy to use: A tui listing all found targets and pressing SPACE to get rid of them.
Minified: single executable file, no dependencies, no installation.

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...]>[@flag]

project	rule
node	`node_modules`
cargo	`target@Cargo.toml`
maven	`target@pom.xml`
gradle	`.gradle,build@build.gradle`
python	`__pycache__,.mypy_cache,.pytest_cache,.ruff_cache,.tox@*.py`
composer	`vendor@composer.json`
swift	`.build,.swiftpm@Package.swift`
dart	`.dart_tool,build@pubspec.yaml`
cocoapods	`Pods@Podfile`
sbt	`target,project/target@build.sbt`
zig	`zig-cache,zig-out@build.zig`
stack	`.stack-work@stack.yaml`
jupyter	`.ipynb_checkpoints@*.ipynb`
ocaml	`_build@dune-project`
elixir	`_build@mix.exs`
erlang	`_build@rebar.config`
vs	`.vs,Debug,Release@*.sln`
vc	`Debug,Release@*.vcxproj`
c#	`bin,obj@*.csproj`
f#	`bin,obj@*.fsproj`
unity	`Library,Temp,Obj,Logs,MemoryCaptures,Build,Builds@Assembly-CSharp.csproj`
unreal	`Binaries,Build,Saved,DerivedDataCache,Intermediate@*.uproject`
godot	`.godot@project.godot`

License

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.

projclean 0.7.0