bdeering1 / polykill

Command line utility for removing dependencies and build artifacts from unused projects.

Polykill

Lightweight utility for removing unwanted dependencies and build artifacts from local projects. Inspired by npkill.

Supported project types:

• Cargo
• Node
• Mix
• .NET Core
• Gradle
• Composer
• Misc. (see "Addional Information")

Installation

cargo install polykill

Usage

polykill [OPTIONS] [DIR]

Polykill will recursively search for projects in the provided directory and output a list of all projects found. If no directory is provided, the current directory will be searched.

When the search has completed, navigate the menu using the following controls:

Key Bind	Action
↓, ↑, ←, →, h, j, k, l	select project
enter, del	remove artifacts
esc, q	exit

Removing artifacts involves removing the build/dependency directories associated with a project type.

Warning for Node projects: Some Node applications need their node_modules directory to work and deleting it may break them.

Options

Argument	Description
-v, --verbose	Verbose output
-s, --skip-empty	Hide projects with zero possible disk savings
--no-vcs	Include projects without version control (will slow down search)
-u, --unsorted	Don't sort projects
-h, --help	Print help
-V, --version	Print version

*supported version control systems are: git, svn, and mercurial

Additional Information

How projects are identified and which directories are used for dependencies and build artifacts:

Type	Identifier(s)	Directories
Node	package.json	node_modules
Cargo	cargo.toml	target
Mix	mix.exs	_build, deps
.NET Core	.csproj	bin, obj
Gradle	build.gradle(.kts)	build
Composer	composer.json	vendor
Misc.	bin, build, dist	bin, build, dist

polykill's Issues

great idea but...

This is a great idea but it's not really usable if you have a lot of folders. It scrolls over the top of my terminal and when you navigate with the up/down arrow you can't see what's going on. It would be great to put this in a fixed sized list based on the height of your terminal and then be able to scroll within that list.