@hamedb89/localghost 0.4.1 → 0.6.1

package/docs/localghost.1.md

@@ -132,6 +132,32 @@ Prints Localghost's project-local state file and setup readiness. Pass `--ready`
 localghost status --ready
 ```
 
+Pass `--ports` to inspect remembered allocations, active Localghost leases, and ports used by active sessions without changing registry state. It also probes a bounded range for free ports; use `--from` and `--count` to control that range. Add `--json` for machine-readable output.
+
+```sh
+localghost status --ports
+localghost status --ports --from 3000 --count 5 --json
+```
+
+### test
+
+Runs a test command with an isolated, dynamically selected Localghost port. Use a unique `--instance` value for parallel runs. The lease is renewed while the command runs and released when it exits.
+
+```sh
+localghost test --instance smoke-1 -- npm test
+localghost test --instance smoke-2 -- npm test
+```
+
+### ports
+
+Use `ports prune` to remove expired or dead leases while preserving remembered allocations. Use `ports prune --test-only` for test cleanup; it removes only stale `test:` leases and orphaned test allocations, preserving live sessions and other Localghost leases. Use `ports reset --yes` to clear the entire port registry, including remembered allocations.
+
+```sh
+localghost ports prune
+localghost ports prune --test-only
+localghost ports reset --yes
+```
+
 ### ps
 
 Shows Localghost `dev` and `run` sessions that are currently running on the machine. Stale records are pruned automatically when their wrapper process is gone. Each route also reports whether its upstream `127.0.0.1:<port>` is listening. Pass `--json` for menu bar helpers or other polling tools.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hamedb89/localghost",
-  "version": "0.4.1",
+  "version": "0.6.1",
   "description": "Friendly local hostnames for app repos with .localghost, Caddy, /etc/hosts, and Vite.",
   "type": "module",
   "bin": {