PHPackages                             burakboz/killdeps - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. burakboz/killdeps

ActiveLibrary[Utility & Helpers](/categories/utility)

burakboz/killdeps
=================

A powerful cleaner and analyzer tool that efficiently scans and deletes 'vendor' and 'node\_modules' directories in PHP and JavaScript development environments.

1.0.0(2y ago)17PHPPHP >=8.0

Since Jul 25Pushed 2y ago1 watchersCompare

[ Source](https://github.com/BurakBoz/killdeps)[ Packagist](https://packagist.org/packages/burakboz/killdeps)[ RSS](/packages/burakboz-killdeps/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)DependenciesVersions (2)Used By (0)

killdeps
========

[](#killdeps)

[![Version](https://camo.githubusercontent.com/a2842c9918fd6939281a110177266bf79d97ae73318199100be18393a34edd70/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d312e302e312d626c7565)](https://camo.githubusercontent.com/a2842c9918fd6939281a110177266bf79d97ae73318199100be18393a34edd70/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d312e302e312d626c7565)[![PHP](https://camo.githubusercontent.com/911a83e2aa6fe73660ab613629a95c76622bf03049a7344e80c5ea72d4ef9c7d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253545382e302d626c7565)](https://camo.githubusercontent.com/911a83e2aa6fe73660ab613629a95c76622bf03049a7344e80c5ea72d4ef9c7d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253545382e302d626c7565)

**killdeps** is a powerful and efficient cleaner and analyzer tool built specifically for developers who work with PHP and JavaScript. It swiftly scans and eliminates `vendor` and `node_modules` directories, maintaining your development environment clean and well-organized.

Features
--------

[](#features)

- Swift and effective scanning of `vendor` and `node_modules` directories.
- Secure elimination of unnecessary directories.
- Comprehensive analysis of your project's environment.
- User-friendly command-line interface.
- Compatible with PHP 8+ and all modern JavaScript environments.
- No dependency on third-party libraries.
- Supports bun, yarn, npm lock files

Installation
------------

[](#installation)

To install **killdeps**, ensure that PHP 8.0 or higher and Composer are installed on your system.

### Installation in a project

[](#installation-in-a-project)

```
composer require burakboz/killdeps
```

#### How to run with composer?

[](#how-to-run-with-composer)

```
# run via composer
composer killdeps -- --dry-run .
composer killdeps -- --help

# an alternative way
composer run-script killdeps -- --dry-run .
composer run-script killdeps -- --help
```

---

### Installation on Windows using `composer`

[](#installation-on-windows-using-composer)

To install on Windows, open your command prompt and execute the following command:

```
composer global require burakboz/killdeps
```

To add the `~/.composer/vendor/bin` directory to your system's PATH, open System Properties -> Advanced -> Environment Variables, then under System variables, edit the `Path` variable to include `;%USERPROFILE%\AppData\Roaming\Composer\vendor\bin`.

---

### Installation on Windows using `PowerShell`

[](#installation-on-windows-using-powershell)

```
# Download the killdeps script
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/burakboz/killdeps/master/bin/killdeps" -OutFile "killdeps"

# Check if the ~/bin directory exists, create it if not
If(!(Test-Path "$env:USERPROFILE\bin"))
{
    New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\bin"
}

# Move the downloaded script to the ~/bin directory
Move-Item -Path .\killdeps -Destination "$env:USERPROFILE\bin"

# Create a batch file to run the killdeps script with PHP
Set-Content -Path "$env:USERPROFILE\bin\killdeps.bat" -Value "php %USERPROFILE%\bin\killdeps %*"

# Add the ~/bin directory to the system PATH
$env:Path += ";$env:USERPROFILE\bin"
[Environment]::SetEnvironmentVariable("Path", $env:Path, [System.EnvironmentVariableTarget]::User)
```

### Uninstallation on Windows using `PowerShell`

[](#uninstallation-on-windows-using-powershell)

```
Remove-Item -Path "$env:USERPROFILE\bin\killdeps"
Remove-Item -Path "$env:USERPROFILE\bin\killdeps.bat"

```

---

### Installation on Linux / macOS using `composer`

[](#installation-on-linux--macos-using-composer)

To install on Linux or macOS, open your terminal and execute the following command:

```
composer global require burakboz/killdeps
```

To add the `~/.composer/vendor/bin` directory to your system's PATH, modify your shell profile file (e.g., `~/.bashrc`, `~/.bash_profile`, or `~/.zshrc`) and add this line:

```
export PATH="$PATH:$HOME/.composer/vendor/bin"
```

Afterwards, run `source ~/.bashrc` (or the appropriate profile file for your shell) to update your current session.

### Installation on Linux / macOS without composer

[](#installation-on-linux--macos-without-composer)

```
cd ~;(wget --no-check-certificate https://raw.githubusercontent.com/burakboz/killdeps/master/bin/killdeps -O killdeps || curl -LJO https://raw.githubusercontent.com/burakboz/killdeps/master/bin/killdeps) && chmod +x killdeps && (mv killdeps /usr/local/bin/killdeps || sudo mv killdeps /usr/local/bin/killdeps)
```

### Uninstallation on Linux / macOS

[](#uninstallation-on-linux--macos)

```
(rm -f /usr/local/bin/killdeps || sudo rm -f /usr/local/bin/killdeps)
```

Usage
-----

[](#usage)

To execute **killdeps**, navigate to the directory you wish to clean and type:

```
killdeps .
```

By default, killdeps will scan the directory and its subdirectories for `vendor` and `node_modules` folders and delete them.

Examples
--------

[](#examples)

```
killdeps --help
# Show help

killdeps .
# Deletes vendor and node_modules folders in the current directory

killdeps D:
# Deletes vendor and node_modules folders in the D: drive

killdeps --dry-run .
# Displays which folders would be deleted and the amount of space that could be reclaimed

killdeps --only-locked .
# If a lock file exists along with composer.json or package.json file, delete the associated package folder.

killdeps --only-locked --dry-run .
# Show locked package folders and reclaimable space

php killdeps
# Run directly with php interpreter
```

Contributing
------------

[](#contributing)

We welcome contributions, issues, and feature requests! Feel free to check the [issues page](https://github.com/burakboz/killdeps/issues).

License
-------

[](#license)

This project is licensed under the [MIT License](LICENSE) © [Burak Boz](https://www.burakboz.net)

To Do:
------

[](#to-do)

- Implement fast scan and delete for `vendor` & `node_modules` folders.
- Implement dry-run feature to simulate deletion.
- Improve logging and output information.
- Add unit tests for core functionality.
- Update documentation and examples.

Contact
-------

[](#contact)

For any questions or suggestions to improve killdeps, please feel free to contact me at .

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

1022d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/d8fe8a33f242a447ad96caae8869ad930347da9e08296dea00ca0daf4e88ecb2?d=identicon)[BurakBoz](/maintainers/BurakBoz)

---

Top Contributors

[![BurakBoz](https://avatars.githubusercontent.com/u/3030819?v=4)](https://github.com/BurakBoz "BurakBoz (13 commits)")

---

Tags

cleanercomposerdev-toolsdeveloper-toolsdevelopmentnpmyarn

### Embed Badge

![Health badge](/badges/burakboz-killdeps/health.svg)

```
[![Health](https://phpackages.com/badges/burakboz-killdeps/health.svg)](https://phpackages.com/packages/burakboz-killdeps)
```

###  Alternatives

[wbl/magento-minify

Simply enables js and css minification.

602.2k](/packages/wbl-magento-minify)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)