portless 0.2.1 → 0.2.2

package/dist/cli.js

@@ -367,6 +367,13 @@ portless
 }
 async function main() {
   const args = process.argv.slice(2);
+  const isNpx = process.env.npm_command === "exec" && !process.env.npm_lifecycle_event;
+  const isPnpmDlx = !!process.env.PNPM_SCRIPT_SRC_DIR && !process.env.npm_lifecycle_event;
+  if (isNpx || isPnpmDlx) {
+    console.error(chalk.red("Error: portless should not be run via npx or pnpm dlx."));
+    console.log(chalk.blue("Install globally: npm install -g portless"));
+    process.exit(1);
+  }
   const skipPortless = process.env.PORTLESS === "0" || process.env.PORTLESS === "skip";
   if (skipPortless && args.length >= 2 && args[0] !== "proxy") {
     spawnCommand(args.slice(1));
@@ -379,6 +386,10 @@ ${chalk.bold("portless")} - Replace port numbers with stable, named .localhost U
 Eliminates port conflicts, memorizing port numbers, and cookie/storage
 clashes by giving each dev server a stable .localhost URL.
 
+${chalk.bold("Install:")}
+  ${chalk.cyan("npm install -g portless")}
+  Do NOT add portless as a project dependency.
+
 ${chalk.bold("Usage:")}
   ${chalk.cyan("sudo portless proxy")}              Start the proxy (run once, keep open)
   ${chalk.cyan("sudo portless proxy --port 8080")}  Start the proxy on a custom port
@@ -387,9 +398,9 @@ ${chalk.bold("Usage:")}
   ${chalk.cyan("portless list")}                    Show active routes
 
 ${chalk.bold("Examples:")}
-  sudo portless proxy              # Start proxy in terminal 1
-  portless myapp next dev          # Terminal 2 -> http://myapp.localhost
-  portless api.myapp pnpm start    # Terminal 3 -> http://api.myapp.localhost
+  sudo portless proxy               # Start proxy in terminal 1
+  portless myapp next dev           # Terminal 2 -> http://myapp.localhost
+  portless api.myapp pnpm start     # Terminal 3 -> http://api.myapp.localhost
 
 ${chalk.bold("In package.json:")}
   {
@@ -415,7 +426,7 @@ ${chalk.bold("Skip portless:")}
     process.exit(0);
   }
   if (args[0] === "--version" || args[0] === "-v") {
-    console.log("0.2.1");
+    console.log("0.2.2");
     process.exit(0);
   }
   if (args[0] === "list") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "portless",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Replace port numbers with stable, named .localhost URLs. For humans and agents.",
   "type": "module",
   "main": "./dist/index.js",
@@ -17,6 +17,7 @@
   "files": [
     "dist"
   ],
+  "packageManager": "pnpm@9.15.4",
   "engines": {
     "node": ">=20"
   },
@@ -24,6 +25,21 @@
     "darwin",
     "linux"
   ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "prepublishOnly": "pnpm build",
+    "pretest": "pnpm build",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepare": "husky"
+  },
   "keywords": [
     "local",
     "development",
@@ -65,18 +81,5 @@
       "prettier --write"
     ],
     "*.{json,md,yml,yaml}": "prettier --write"
-  },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "format": "prettier --write .",
-    "format:check": "prettier --check .",
-    "lint": "eslint src/",
-    "lint:fix": "eslint src/ --fix",
-    "pretest": "pnpm build",
-    "test": "vitest run",
-    "test:coverage": "vitest run --coverage",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit"
   }
-}
+}