{"id":20127314,"url":"https://github.com/burakboz/killdeps","last_synced_at":"2026-04-28T12:32:09.312Z","repository":{"id":183802249,"uuid":"670789122","full_name":"BurakBoz/killdeps","owner":"BurakBoz","description":"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.","archived":false,"fork":false,"pushed_at":"2023-10-06T12:18:57.000Z","size":33,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-08T04:37:12.005Z","etag":null,"topics":["cleaner","composer","dev-tools","developer-tools","development","npm","yarn"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BurakBoz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-07-25T20:58:47.000Z","updated_at":"2023-07-25T21:55:48.000Z","dependencies_parsed_at":"2024-11-13T20:22:52.269Z","dependency_job_id":"adf34e06-28b4-44ab-b68d-e0a8f13303ad","html_url":"https://github.com/BurakBoz/killdeps","commit_stats":null,"previous_names":["burakboz/killdeps"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/BurakBoz/killdeps","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BurakBoz%2Fkilldeps","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BurakBoz%2Fkilldeps/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BurakBoz%2Fkilldeps/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BurakBoz%2Fkilldeps/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BurakBoz","download_url":"https://codeload.github.com/BurakBoz/killdeps/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BurakBoz%2Fkilldeps/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280923949,"owners_count":26414346,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-25T02:00:06.499Z","response_time":81,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cleaner","composer","dev-tools","developer-tools","development","npm","yarn"],"created_at":"2024-11-13T20:20:26.591Z","updated_at":"2025-10-25T08:15:00.245Z","avatar_url":"https://github.com/BurakBoz.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# killdeps\n\n![Version](https://img.shields.io/badge/version-1.0.1-blue)\n![PHP](https://img.shields.io/badge/php-%5E8.0-blue)\n\n**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.\n\n## Features\n\n- Swift and effective scanning of `vendor` and `node_modules` directories.\n- Secure elimination of unnecessary directories.\n- Comprehensive analysis of your project's environment.\n- User-friendly command-line interface.\n- Compatible with PHP 8+ and all modern JavaScript environments.\n- No dependency on third-party libraries.\n- Supports bun, yarn, npm lock files\n\n## Installation\n\nTo install **killdeps**, ensure that PHP 8.0 or higher and Composer are installed on your system.\n\n### Installation in a project\n```bash\ncomposer require burakboz/killdeps\n```\n\n#### How to run with composer?\n```bash\n# run via composer\ncomposer killdeps -- --dry-run .\ncomposer killdeps -- --help\n\n# an alternative way\ncomposer run-script killdeps -- --dry-run .\ncomposer run-script killdeps -- --help\n```\n\n---\n\n### Installation on Windows using `composer`\n\nTo install on Windows, open your command prompt and execute the following command:\n\n```bash\ncomposer global require burakboz/killdeps\n```\n\nTo add the `~/.composer/vendor/bin` directory to your system's PATH, open System Properties -\u003e Advanced -\u003e Environment Variables, then under System variables, edit the `Path` variable to include `;%USERPROFILE%\\AppData\\Roaming\\Composer\\vendor\\bin`.\n\n---\n\n### Installation on Windows using `PowerShell`\n\n```bash\n# Download the killdeps script\nInvoke-WebRequest -Uri \"https://raw.githubusercontent.com/burakboz/killdeps/master/bin/killdeps\" -OutFile \"killdeps\"\n\n# Check if the ~/bin directory exists, create it if not\nIf(!(Test-Path \"$env:USERPROFILE\\bin\"))\n{\n    New-Item -ItemType Directory -Force -Path \"$env:USERPROFILE\\bin\"\n}\n\n# Move the downloaded script to the ~/bin directory\nMove-Item -Path .\\killdeps -Destination \"$env:USERPROFILE\\bin\"\n\n# Create a batch file to run the killdeps script with PHP\nSet-Content -Path \"$env:USERPROFILE\\bin\\killdeps.bat\" -Value \"php %USERPROFILE%\\bin\\killdeps %*\"\n\n# Add the ~/bin directory to the system PATH\n$env:Path += \";$env:USERPROFILE\\bin\"\n[Environment]::SetEnvironmentVariable(\"Path\", $env:Path, [System.EnvironmentVariableTarget]::User)\n```\n\n### Uninstallation on Windows using `PowerShell`\n```\nRemove-Item -Path \"$env:USERPROFILE\\bin\\killdeps\"\nRemove-Item -Path \"$env:USERPROFILE\\bin\\killdeps.bat\"\n```\n---\n\n### Installation on Linux / macOS using `composer`\n\nTo install on Linux or macOS, open your terminal and execute the following command:\n\n```bash\ncomposer global require burakboz/killdeps\n```\n\nTo 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:\n\n```bash\nexport PATH=\"$PATH:$HOME/.composer/vendor/bin\"\n```\n\nAfterwards, run `source ~/.bashrc` (or the appropriate profile file for your shell) to update your current session.\n\n### Installation on Linux / macOS without composer\n\n```bash\ncd ~;(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) \u0026\u0026 chmod +x killdeps \u0026\u0026 (mv killdeps /usr/local/bin/killdeps || sudo mv killdeps /usr/local/bin/killdeps)\n```\n\n### Uninstallation on Linux / macOS\n\n```bash\n(rm -f /usr/local/bin/killdeps || sudo rm -f /usr/local/bin/killdeps)\n```\n\n## Usage\n\nTo execute **killdeps**, navigate to the directory you wish to clean and type:\n\n```bash\nkilldeps .\n```\n\nBy default, killdeps will scan the directory and its subdirectories for `vendor` and `node_modules` folders and delete them.\n\n\n## Examples\n\n```bash\nkilldeps --help\n# Show help\n\nkilldeps . \n# Deletes vendor and node_modules folders in the current directory\n\nkilldeps D:\n# Deletes vendor and node_modules folders in the D: drive\n\nkilldeps --dry-run .\n# Displays which folders would be deleted and the amount of space that could be reclaimed\n\nkilldeps --only-locked .\n# If a lock file exists along with composer.json or package.json file, delete the associated package folder.\n\nkilldeps --only-locked --dry-run .\n# Show locked package folders and reclaimable space\n\nphp killdeps\n# Run directly with php interpreter\n```\n\n## Contributing\n\nWe welcome contributions, issues, and feature requests! Feel free to check the [issues page](https://github.com/burakboz/killdeps/issues).\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE) © [Burak Boz](https://www.burakboz.net)\n\n## To Do:\n\n- [x] Implement fast scan and delete for `vendor` \u0026 `node_modules` folders.\n- [x] Implement dry-run feature to simulate deletion.\n- [ ] Improve logging and output information.\n- [ ] Add unit tests for core functionality.\n- [ ] Update documentation and examples.\n\n## Contact\n\nFor any questions or suggestions to improve killdeps, please feel free to contact me at killdeps@burakboz.net.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fburakboz%2Fkilldeps","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fburakboz%2Fkilldeps","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fburakboz%2Fkilldeps/lists"}