Awesome

Kondo 🧹

Cleans node_modules, target, build, and friends from your projects.

Excellent if

💾 You want to back up your code but don't want to include GBs of dependencies
🧑‍🎨 You try out lots of projects but hate how much space they occupy
⚡️ You like keeping your disks lean and zippy

20+ Supported Project Types <a href="https://doc.rust-lang.org/cargo/">Cargo</a> (Rust), <a href="https://cmake.org">CMake</a> (C, C++), <a href="https://getcomposer.org/">Composer</a> (PHP), <a href="https://elixir-lang.org/">Elixir</a>, <a href="https://godotengine.org/">Godot 4.x</a> (C#, GDScript) <a href="https://gradle.com/">Gradle</a> (Java) <a href="https://jupyter.org/">Jupyter Notebook</a> (Python), <a href="https://pixi.sh/">Pixi</a> (Python), <a href="https://maven.apache.org/">Maven</a> (Java), <a href="https://nodejs.org/">Node</a> (JavaScript) <a href="https://dart.dev/">Pub</a> (Dart), <a href="https://www.python.org/">Python</a> <a href="https://www.scala-sbt.org/">SBT</a> (Scala), <a href="https://docs.haskellstack.org/">Stack</a> (Haskell), <a href="https://cabal.readthedocs.io/en/stable/">Cabal</a> (Haskell), <a href="https://swift.org/">Swift</a> <a href="https://unity.com/">Unity</a> (C#), <a href="https://www.unrealengine.com/">Unreal Engine</a> (C++), <a href="https://ziglang.org/">Zig</a>, <a href="https://dotnet.microsoft.com/">.NET</a> (C#, F#) <a href="https://turbo.build/repo">Turborepo</a> (JavaScript) <img width="972" alt="kondo cli cleaning projects" src="https://user-images.githubusercontent.com/2771466/222950622-475bc6cc-7b91-47c2-86b2-5948bee4fe8e.png"> <img width="1112" alt="kondo gui displaying projects" src="https://user-images.githubusercontent.com/2771466/222950846-964162a1-80c9-4cdf-a9a8-d818ba4cb34a.png"> <details> <summary>CLI Video</summary>

kondo-cli.webm

</details> <details> <summary>GUI Video</summary>

kondo-ui.webm

</details>

Installation

Warning

Kondo is essentially rm -rf with a prompt. Use at your own discretion. Always have a backup of your projects.

Command Line

winget

winget install kondo

Homebrew

brew install kondo

MacPorts

sudo port install kondo

Arch Linux

pacman -S kondo

Source

Requires Rust.

git clone https://github.com/tbillington/kondo.git
cargo install --path kondo/kondo

Others

Binaries available on the releases page.

Graphic User Interface

Windows

winget install kondo-ui

Arch Linux

pacman -S kondo-ui

Source

Requires rust. You may need platform specific dependencies on linux.

git clone https://github.com/tbillington/kondo.git
cargo install --path kondo/kondo-ui

Binaries available on the releases page.

Usage

Warning

Kondo is essentially rm -rf with a prompt. Use at your own discretion. Always have a backup of your projects.

Command Line Interface

Running kondo without a directory specified will run in the current directory.

kondo

Supplying a path will tell kondo where to start. Multiple paths are supported.

kondo code/my_project code/my_project_2

Passing a time will filter projects to those that haven't been modified for at least the specified period. See kondo --help for the full list of options.

kondo --older 3M # only projects with last modified greater than 3 months
kondo -o3M # shorthand

More options such as quiet mode, following symlinks, and filesystem restriction are viewable with kondo --help.

Building/Development

To build the cli kondo you can run cargo build and cargo run from the projects root directory.

To build the gui kondo-ui you must first navigate into the kondo-ui directory, then you can run cargo build and cargo run.

The output binaries will be located in target/debug/ or target/release/ per Cargo defaults.