{"_id":"@bobfromarcher/portkill","_rev":"2-d172d09380095e0b0c3d2a4d3d0e72f5","name":"@bobfromarcher/portkill","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@bobfromarcher/portkill","version":"1.0.0","keywords":["port","kill","tcp","netstat","lsof","cli","eaddrinuse","process","cross-platform","zero-dependency","devtools"],"author":{"name":"bobfromarcher"},"license":"MIT","_id":"@bobfromarcher/portkill@1.0.0","maintainers":[{"name":"bobfromarcher","email":"chrisbellth@gmail.com"}],"homepage":"https://github.com/bobfromarcher/portkill#readme","bugs":{"url":"https://github.com/bobfromarcher/portkill/issues"},"bin":{"portkill":"bin/portkill.js"},"dist":{"shasum":"73ea7d9bb52a7672ebc696d2729648ea69e701d0","tarball":"https://registry.npmjs.org/@bobfromarcher/portkill/-/portkill-1.0.0.tgz","fileCount":4,"integrity":"sha512-wZ9pWfpEUma+lpalRUBtRpwtKkoU7WT5VtEiawLUIJliZYM02fkf3ehklvlSjmzgFjRkzCeZCrP0mw65LqLuHA==","signatures":[{"sig":"MEQCIDFbwmEFfxbd7foKBu/VjFbavYdnfKINUFH49oUjDlAOAiB1IpFTCV770JqAw0kQK1xn3Ak1XIDcfamDDGD707vJtg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10510},"engines":{"node":">=16"},"gitHead":"895d212c470c26c5a486e69f48f48818306d7b0c","scripts":{"test":"node test/test.js","start":"node bin/portkill.js"},"_npmUser":{"name":"bobfromarcher","email":"chrisbellth@gmail.com"},"repository":{"url":"git+https://github.com/bobfromarcher/portkill.git","type":"git"},"_npmVersion":"11.11.0","description":"Find and kill whatever is holding a TCP port — cross-platform (Windows/macOS/Linux). Zero dependencies.","directories":{},"_nodeVersion":"24.14.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/portkill_1.0.0_1781945965850_0.7261116836890018","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@bobfromarcher/portkill","publishConfig":{"access":"public"},"version":"1.0.1","description":"Find and kill whatever is holding a TCP port - cross-platform (Windows/macOS/Linux). Zero dependencies.","bin":{"portkill":"bin/portkill.js"},"scripts":{"test":"node test/test.js","start":"node bin/portkill.js"},"keywords":["port","kill","tcp","netstat","lsof","cli","eaddrinuse","process","cross-platform","zero-dependency","devtools"],"author":{"name":"bobfromarcher"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/bobfromarcher/portkill.git"},"bugs":{"url":"https://github.com/bobfromarcher/portkill/issues"},"homepage":"https://github.com/bobfromarcher/portkill#readme","engines":{"node":">=16"},"gitHead":"604052c68b176f9e5dba1ce3e0850c26d03bfc18","_id":"@bobfromarcher/portkill@1.0.1","_nodeVersion":"24.14.1","_npmVersion":"11.11.0","dist":{"integrity":"sha512-yeX6bodxeXLvOePFrZPj8y75a9Zpc8cPJh2C60F64YFEnVruvTVxAABGNHyFQP1IonG0FJnAD+go9UZkjmatnA==","shasum":"4f91852800be09a376798f3207b2f06876fbe451","tarball":"https://registry.npmjs.org/@bobfromarcher/portkill/-/portkill-1.0.1.tgz","fileCount":4,"unpackedSize":10611,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICHM828D8eo8CtR9rBefSLKH0n8fX/qty6+6mEWdHFjcAiBUeUZ8LTtSQidlmYjY3UR+SjlF41lY0rS/7EItSwctmQ=="}]},"_npmUser":{"name":"bobfromarcher","email":"chrisbellth@gmail.com"},"directories":{},"maintainers":[{"name":"bobfromarcher","email":"chrisbellth@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/portkill_1.0.1_1781948617054_0.1536084846593706"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-20T08:59:25.680Z","modified":"2026-06-20T09:43:37.297Z","1.0.0":"2026-06-20T08:59:25.989Z","1.0.1":"2026-06-20T09:43:37.198Z"},"bugs":{"url":"https://github.com/bobfromarcher/portkill/issues"},"author":{"name":"bobfromarcher"},"license":"MIT","homepage":"https://github.com/bobfromarcher/portkill#readme","keywords":["port","kill","tcp","netstat","lsof","cli","eaddrinuse","process","cross-platform","zero-dependency","devtools"],"repository":{"type":"git","url":"git+https://github.com/bobfromarcher/portkill.git"},"description":"Find and kill whatever is holding a TCP port - cross-platform (Windows/macOS/Linux). Zero dependencies.","maintainers":[{"name":"bobfromarcher","email":"chrisbellth@gmail.com"}],"readme":"# portkill\n\n[![npm](https://img.shields.io/npm/v/@bobfromarcher/portkill?color=cb3837&logo=npm)](https://www.npmjs.com/package/@bobfromarcher/portkill)\n[![CI](https://github.com/bobfromarcher/portkill/actions/workflows/ci.yml/badge.svg)](https://github.com/bobfromarcher/portkill/actions/workflows/ci.yml)\n[![license](https://img.shields.io/npm/l/@bobfromarcher/portkill?color=blue)](LICENSE)\n[![zero deps](https://img.shields.io/badge/dependencies-0-success)](package.json)\n\nFinds whatever process is holding a TCP port and kills it. Works on Windows, macOS and Linux. It is the quick fix for `Error: listen EADDRINUSE: address already in use :::3000`. No dependencies, no AI.\n\n

\"portkill

\n\n## Install\n\n```bash\nnpm install -g @bobfromarcher/portkill\n# or once:\nnpx @bobfromarcher/portkill 3000\n```\n\n## Usage\n\n```bash\nportkill [options]\nportkill --list\n```\n\n| Option | Description |\n| --- | --- |\n| `--list`, `-l` | List every listening port and its owning process |\n| `--force`, `-f` | Kill without the confirmation prompt |\n| `--json` | Output JSON instead of killing |\n| `-h, --help` | Show help |\n| `-v, --version` | Show version |\n\n## Examples\n\n```bash\nportkill 3000 # find the process on :3000 and confirm before killing\nportkill 8080 --force # kill it immediately, no prompt\nportkill --list # everything that is listening, sorted by port\nportkill 5432 --json # report the owner, do not kill\n```\n\n## How it works\n\nportkill shells out to the tools your OS already ships: `netstat -ano` and `tasklist` on Windows, `lsof` and `ps` on macOS and Linux. It parses their output and maps the port to a process. The parsing is pure and unit tested against captured fixtures from each platform, so behavior is the same everywhere. No native modules, nothing to compile.\n\n## Development\n\n```bash\ngit clone https://github.com/bobfromarcher/portkill\ncd portkill\nnode test/test.js\n```\n\nCI runs the suite on Node 18, 20 and 22 across Linux, macOS and Windows.\n\n## License\n\nMIT, bobfromarcher.\n","readmeFilename":"README.md"}