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

<br /> <p align="center"> <strong>20+ Supported Project Types</strong> </p> <p align="center"> <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) </p> <p align="center"> <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) </p> <p align="center"> <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> </p> <p align="center"> <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) </p> <p align="center"> <a href="https://developer.hashicorp.com/terraform">Terraform</a> <a href="https://reactnative.dev/">React Native</a> </p> <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.

<a href="https://repology.org/project/kondo/versions"> <img src="https://repology.org/badge/vertical-allrepos/kondo.svg" alt="Packaging status"> </a>

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.

<a href="https://repology.org/project/rust:kondo-ui/versions"> <img src="https://repology.org/badge/vertical-allrepos/rust:kondo-ui.svg" alt="Packaging status"> </a>

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.

Similar Projects

• The Tin Summer
• Detox
• Sweep
• npkill
• Cargo Cleanall
• Cargo Sweep
• Cargo Wipe
• cargo-clean-recursive