#clean #cleanup #delete #free

app kondo-ui

kondo-ui is a filesystem cleaning tool that recursively searches directories for known project structures and allows you to clean them of unnecessary files like build artifacts

4 releases (breaking)

0.7.0 Jul 6, 2023
0.6.0 Mar 12, 2023
0.2.0 Mar 28, 2021
0.1.0 Apr 4, 2020

#142 in Filesystem

29 downloads per month

MIT license

36KB
822 lines

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

16 Supported Project Types

Cargo - Node - Unity - Scala SBT - Haskell Stack - Maven - Unreal Engine - Python

Jupyter Notebook - CMake - Composer - Pub - Elixir - Swift - Gradle - Zig

Pull requests are welcome, it's easy to extend!

Current deleted directories config.

kondo cli cleaning projects kondo gui displaying projects
CLI Video

kondo-cli.webm

GUI Video

kondo-ui.webm

Installation

Warning

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

Command Line

Homebrew

brew 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.

Packaging status

Graphic User Interface

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.

Packaging status

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

Dependencies

~15MB
~262K SLoC