PHPackages                             abdelhamiderrahmouni/vendorkill - 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. [File &amp; Storage](/categories/file-storage)
4. /
5. abdelhamiderrahmouni/vendorkill

ActiveLibrary[File &amp; Storage](/categories/file-storage)

abdelhamiderrahmouni/vendorkill
===============================

a composer package to install globally and remove composer vendor folders in you old project to save storage.

v0.1.86(2y ago)537MITPHPPHP ^8.1|^8.2CI passing

Since Feb 20Pushed 4w ago1 watchersCompare

[ Source](https://github.com/abdelhamiderrahmouni/vendorkill)[ Packagist](https://packagist.org/packages/abdelhamiderrahmouni/vendorkill)[ Docs](https://github.com/abdelhamiderrahmouni/vendorkill)[ RSS](/packages/abdelhamiderrahmouni-vendorkill/feed)WikiDiscussions master Synced 3mo ago

READMEChangelog (10)Dependencies (7)Versions (16)Used By (0)

```
   █████████  ██████   █████ █████   ████ █████ █████       █████
  ███░░░░░██  ░██████  ░███  ░███   ███░  ░███  ░███        ░███
 ███     ░░░  ░███░███ ░███  ░███  ███    ░███  ░███        ░███
░███          ░███░░███░███  ░███████     ░███  ░███        ░███
░███          ░███ ░░██████  ░███░░███    ░███  ░███        ░███
░░███     ███ ░███  ░░█████  ░███ ░░███   ░███  ░███      █ ░███      █
 ░░█████████  █████  ░░█████ █████ ░░████ █████ ███████████ ███████████
  ░░░░░░░░░  ░░░░░    ░░░░░ ░░░░░   ░░░░ ░░░░░ ░░░░░░░░░░░ ░░░░░░░░░░░
```

[![Latest Version on Packagist](https://camo.githubusercontent.com/ca4df9e87935a557d52f8bef125e65e8ab43fa1878b2159afb1297ac456dc5b6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6261726e7068702f636e6b696c6c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/barnphp/cnkill)[![GitHub Tests Action Status](https://camo.githubusercontent.com/4ad029f55c23775a2b3b6f23978af5c0326dcb203f7a33bde36fde59f9407958/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6261726e7068702f636e6b696c6c2f72756e2d74657374732e796d6c3f6272616e63683d6d6173746572266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/barnphp/cnkill/actions?query=workflow%3Arun-tests+branch%3Amaster)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/16d69d147f0428c04cf82c8409af311b8546061dda62ebf7d7a2babb1d45e3c6/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6261726e7068702f636e6b696c6c2f70696e742e796d6c3f6272616e63683d6d6173746572266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/barnphp/cnkill/actions?query=workflow%3A%22pint%22+branch%3Amaster)[![Total Downloads](https://camo.githubusercontent.com/78fd8d0e242aaa28463960c0e9e304511b7447fe6a6f0adfe009820911748d72/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6261726e7068702f636e6b696c6c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/barnphp/cnkill)

A Blazing Fast, Interactive TUI tool (like `npkill`) to find and delete `vendor/` and `node_modules/` directories in your old projects — freeing up disk space fast.

Installation &amp;&amp; Update
------------------------------

[](#installation--update)

We provide multiple installation methods to suit your preferences. The recommended way is the standalone executable for Linux and macOS.

1. Quick install (Linux/macOS, standalone executable):

```
curl -fsSL https://raw.githubusercontent.com/barnphp/cnkill/master/install.sh | sh
```

2. System-wide install (requires sudo):

```
curl -fsSL https://raw.githubusercontent.com/barnphp/cnkill/master/install.sh | sh -s -- --system
```

3. Install via cpx (the npx for PHP):

```
cpx barnphp/cnkill
```

4. Install globally via Composer:

```
composer global require barnphp/cnkill
```

You will find it installed in `~/.composer/vendor/bin` or `~/.config/composer/vendor/bin`. Add it to your PATH or create an alias:

```
alias cnkill="~/.composer/vendor/bin/cnkill"
# or
alias cnkill="~/.config/composer/vendor/bin/cnkill"
```

Usage
-----

[](#usage)

```
cnkill [path: defaults to current path] [options]
```

```
## Examples

cnkill                              # find both vendor/ and node_modules/ in current path

cnkill /path/to/projects            # find both vendor/ and node_modules/ in a specific path

cnkill /path/to/projects --node     # find node_modules/ only

cnkill /path/to/projects --composer # find vendor/ only

cnkill /path/to/projects --sort=size      # sort by size

cnkill /path/to/projects --maxdepth=4     # limit search depth

cnkill /path/to/projects --rust         # find target/ (Rust Cargo) directories only

cnkill cache --sort=modified        # sort caches by last modified
```

Configuration
-------------

[](#configuration)

cnkill stores its configuration at `~/.config/cnkill/config.json` (respects `$XDG_CONFIG_HOME`).

Use the `config` command to manage which targets are scanned and to define custom ones.

### Toggle enabled targets

[](#toggle-enabled-targets)

```
cnkill config
```

Opens an interactive multi-select list of all known targets (built-in and custom). Use `Space` to toggle a target on or off, `Enter` to save, and `q` to quit without saving.

### Add a custom target

[](#add-a-custom-target)

```
cnkill config add
```

Runs an interactive 4-step wizard:

1. **Folder name or pattern** — a simple name (e.g. `.venv`) or a wildcard path pattern (e.g. `*/ios/build`)
2. **Label** — human-readable name shown in `cnkill config`
3. **Manifest files** — comma-separated files that must exist in the parent directory to confirm it's a real project (e.g. `pyproject.toml, requirements.txt`); leave blank to match any
4. **Lock / reference files** — files used to determine the "last modified" timestamp; defaults to manifests if left blank

After the wizard, the new target is saved and automatically enabled.

### Remove a custom target

[](#remove-a-custom-target)

```
cnkill config remove
```

Presents a list of user-defined custom targets. Select one and confirm to delete it.

### Built-in targets

[](#built-in-targets)

TargetDirectoryEnabled by default`vendor`vendor (Composer)Yes`node`node\_modules (npm/pnpm/yarn/bun)Yes`next`.next (Next.js build output)Yes`expo`.expo (Expo / React Native)Yes`turbo`.turbo (Turborepo cache)Yes`svelte-kit`.svelte-kit (SvelteKit)Yes`nuxt`.nuxt (Nuxt build output)Yes`cache`.cache (generic tool cache)Yes`parcel-cache`.parcel-cache (Parcel bundler)Yes`coverage`coverage (test coverage reports)Yes`output`.output (Nitro / Nuxt server output)Yes`rust`target (Cargo build output)Yes`dist`dist (build distribution)No`build`build (generic build output)No`derived-data`DerivedData (Xcode)No`android`android/build (Android / Gradle)No> **Note:** Per-run flags like `--node` and `--composer` override the saved config for that invocation only.

Controls
--------

[](#controls)

KeyAction`↑` / `↓`Navigate the list`←` / `→`Page through the list`s`Cycle sort mode`Shift + s`Toggle sort direction`Space`Delete the highlighted directory`q` / `Ctrl-C`QuitRoadmap
-------

[](#roadmap)

- Interactive TUI with real-time streaming results
- Support for `vendor/` directories (Composer)
- Support for `node_modules/` directories (npm/yarn)
- Async size calculation and deletion
- Add support for Windows
- Add a build workflow to publish release binaries automatically
- ... share your ideas in the [issues](https://github.com/barnphp/cnkill/issues)

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

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

[](#contributing)

Please see [CONTRIBUTING](/.github/CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please open an [issue](https://github.com/barnphp/cnkill/issues) to report any security vulnerabilities.

Credits
-------

[](#credits)

- [Abdelhamid Errahmouni](https://github.com/abdelhamiderrahmouni)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance62

Regular maintenance activity

Popularity13

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity52

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

Every ~0 days

Total

15

Last Release

857d ago

PHP version history (2 changes)v0.1.0PHP ^8.1

v0.1.8PHP ^8.1|^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/745a0575996f5a3dcb6b8e177e5f37e610d83906028a1e99aa2ec3213a281027?d=identicon)[abdelhamiderrahmouni](/maintainers/abdelhamiderrahmouni)

---

Top Contributors

[![abdelhamiderrahmouni](https://avatars.githubusercontent.com/u/26693672?v=4)](https://github.com/abdelhamiderrahmouni "abdelhamiderrahmouni (173 commits)")

---

Tags

clearcnkillcomposerfreenode-modulesnpkillstoragevendorcomposerstoragecleanfreevendordeletecleanerdiskremoveclearspacenpkill

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/abdelhamiderrahmouni-vendorkill/health.svg)

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

###  Alternatives

[laravel/framework

The Laravel Framework.

34.8k532.1M19.4k](/packages/laravel-framework)[league/flysystem

File storage abstraction for PHP

13.6k665.7M2.4k](/packages/league-flysystem)[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

1.7k277.8M961](/packages/league-flysystem-aws-s3-v3)[illuminate/console

The Illuminate Console package.

13045.3M6.2k](/packages/illuminate-console)[liborm85/composer-vendor-cleaner

Composer Vendor Cleaner removes unnecessary development files and directories from vendor directory.

34389.0k1](/packages/liborm85-composer-vendor-cleaner)[vectorial1024/laravel-cache-evict

Efficiently remove expired Laravel file/database cache data

5916.2k](/packages/vectorial1024-laravel-cache-evict)

PHPackages © 2026

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