port-reclaim 0.2.0 → 0.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +11 -0
- package/package.json +10 -4
package/README.md
CHANGED
|
@@ -2,6 +2,17 @@
|
|
|
2
2
|
|
|
3
3
|
A zero-configuration, cross-platform CLI for safely reclaiming ports held by stale local development processes.
|
|
4
4
|
|
|
5
|
+
## Why `port-reclaim`?
|
|
6
|
+
|
|
7
|
+
Tools like [`kill-port`](https://www.npmjs.com/package/kill-port) free a port by killing whatever holds it. `port-reclaim` is built for everyday development, where the process holding port 3000 is usually *yours*:
|
|
8
|
+
|
|
9
|
+
- **Knows your project** — a process started from your current directory is reclaimed automatically; anything else asks first. No more killing the wrong `node`.
|
|
10
|
+
- **Shows what it found** — process name, PID, working directory, and uptime. `--list` looks without touching.
|
|
11
|
+
- **Never kills Docker** — ports held by `docker-proxy` or Docker Desktop are reported with a hint to stop the container instead.
|
|
12
|
+
- **Multiple ports, one command** — `port-reclaim 3000 5173 8080`.
|
|
13
|
+
- **TCP and UDP** — catches UDP listeners as well as TCP.
|
|
14
|
+
- **Configurable** — declare ports in `package.json` or `.reclaimignore`, then plain `port-reclaim` in your `dev` script is enough.
|
|
15
|
+
|
|
5
16
|
## Install
|
|
6
17
|
|
|
7
18
|
Run it once without installing:
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "port-reclaim",
|
|
3
|
-
"version": "0.2.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "0.2.1",
|
|
4
|
+
"description": "Free up a port already in use: find and kill the process holding it (EADDRINUSE). Cross-platform, zero-config, Docker-safe.",
|
|
5
5
|
"author": "princegoel0",
|
|
6
6
|
"license": "MIT",
|
|
7
7
|
"type": "module",
|
|
@@ -37,9 +37,15 @@
|
|
|
37
37
|
"keywords": [
|
|
38
38
|
"cli",
|
|
39
39
|
"port",
|
|
40
|
-
"
|
|
40
|
+
"kill-port",
|
|
41
|
+
"port-killer",
|
|
42
|
+
"eaddrinuse",
|
|
43
|
+
"port-already-in-use",
|
|
44
|
+
"dev-server",
|
|
41
45
|
"developer-tools",
|
|
42
|
-
"
|
|
46
|
+
"devtools",
|
|
47
|
+
"cross-platform",
|
|
48
|
+
"process"
|
|
43
49
|
],
|
|
44
50
|
"engines": {
|
|
45
51
|
"node": ">=18"
|