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

1026d 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

[soup/paginator

Paginator is a simple class that allows you to create pagination. It doesn't require any database connection. It is compatible with Twitter's Bootstrap Framework, by using the CSS class pagination that is also attached.

351.5k](/packages/soup-paginator)

PHPackages © 2026

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