noninteractive 0.3.1 → 0.3.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "noninteractive",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "type": "module",
   "bin": {
     "noninteractive": "./src/index.ts"

package/src/index.ts

@@ -5,13 +5,32 @@ import { existsSync } from "node:fs";
 import { socketPath, ensureSessionsDir } from "./paths";
 import { sendMessage } from "./client";
 
-const HELP = `usage: noninteractive <command> [args]
+const HELP = `noninteractive — run interactive CLI commands non-interactively.
 
-  start <name> [args...]   start a session (runs npx <name>)
-  read  <name>             read terminal output
-  send  <name> <text>      send keystrokes to session
-  stop  <name>             stop a session
-  list                     show active sessions`;
+usage: npx noninteractive <command> [args]
+
+commands:
+  start <cmd> [args...]    start a session running <cmd>
+  read  <session>          read current terminal output
+  send  <session> <text>   send keystrokes (use "" for Enter)
+  stop  <session>          stop a session
+  list                     show active sessions
+
+the first argument to "start" is the command to run, NOT a session name.
+the session name is auto-derived from the command (e.g. "npx vercel" → session "vercel").
+
+example workflow:
+  npx noninteractive start npx vercel       # starts "npx vercel", session name = "vercel"
+  npx noninteractive read vercel            # see what's on screen
+  npx noninteractive send vercel ""         # press Enter
+  npx noninteractive send vercel "y"        # type "y" and press Enter
+  npx noninteractive read vercel            # see updated output
+  npx noninteractive stop vercel            # done, stop the session
+
+more examples:
+  npx noninteractive start npx workos       # session "workos"
+  npx noninteractive start vercel login     # session "vercel"
+  npx noninteractive start npx supabase init  # session "supabase"`;
 
 function getSelfCommand(): string[] {
   if (process.argv[1] && /\.(ts|js)$/.test(process.argv[1])) {
@@ -20,15 +39,39 @@ function getSelfCommand(): string[] {
   return [process.argv[0]];
 }
 
-async function start(name: string, args: string[]) {
+function deriveSessionName(cmd: string, args: string[]): string {
+  const parts = [cmd, ...args];
+  // skip npx/bunx prefix to get the real command name
+  let i = 0;
+  if (parts[i] === "npx" || parts[i] === "bunx") i++;
+  // skip flags like -y, --yes
+  while (i < parts.length && parts[i].startsWith("-")) i++;
+  const name = parts[i] || cmd;
+  // strip npm scope @foo/bar -> bar
+  return name.replace(/^@[^/]+\//, "").replace(/[^a-zA-Z0-9_-]/g, "");
+}
+
+async function start(cmdArgs: string[]) {
+  const executable = cmdArgs[0];
+  const args = cmdArgs.slice(1);
+  const name = deriveSessionName(executable, args);
   const sock = socketPath(name);
 
   try {
     const res = await sendMessage(sock, { action: "read" });
     if (res.ok) {
       process.stdout.write(res.output ?? "");
-      console.log(`\n[session '${name}' already running]`);
-      return;
+      if (res.exited) {
+        console.log(`\n[session '${name}' already exists but exited ${res.exitCode} — stopping it]`);
+        try { await sendMessage(sock, { action: "stop" }); } catch {}
+        // fall through to start a new session
+      } else {
+        console.log(`\n[session '${name}' already running — read the output above, then use:]`);
+        console.log(`  npx noninteractive send ${name} "<text>"   # send keystrokes (use "" for Enter)`);
+        console.log(`  npx noninteractive read ${name}             # read updated output`);
+        console.log(`  npx noninteractive stop ${name}             # stop the session`);
+        return;
+      }
     }
   } catch {}
 
@@ -36,7 +79,7 @@ async function start(name: string, args: string[]) {
   try { const { unlinkSync } = await import("node:fs"); unlinkSync(sock); } catch {}
 
   const self = getSelfCommand();
-  const child = spawn(self[0], [...self.slice(1), "__daemon__", name, "npx", name, ...args], {
+  const child = spawn(self[0], [...self.slice(1), "__daemon__", name, executable, ...args], {
     detached: true,
     stdio: "ignore",
   });
@@ -49,7 +92,11 @@ async function start(name: string, args: string[]) {
   }
 
   if (!existsSync(sock)) {
-    console.error("timeout: failed to start session");
+    console.error(`error: failed to start session '${name}'.`);
+    console.error(`the command was: ${executable} ${args.join(" ")}`);
+    console.error(`\nmake sure the command exists. examples:`);
+    console.error(`  npx noninteractive start npx vercel        # run an npx package`);
+    console.error(`  npx noninteractive start vercel login       # run a command directly`);
     process.exit(1);
   }
 
@@ -62,21 +109,34 @@ async function start(name: string, args: string[]) {
       const clean = stripAnsi(res.output ?? "").trim();
       if (clean.length > 10) {
         process.stdout.write(res.output);
-        console.log(`\n[session '${name}' started]`);
+        if (res.exited) {
+          console.log(`\n[session '${name}' exited ${res.exitCode} — the command failed]`);
+          console.log(`hint: the first argument to "start" is the command to run, NOT a session name.`);
+          console.log(`  npx noninteractive start npx vercel        # run an npx package`);
+          console.log(`  npx noninteractive start vercel login       # run a command directly`);
+        } else {
+          console.log(`\n[session '${name}' started — read the output above, then use:]`);
+          console.log(`  npx noninteractive send ${name} "<text>"   # send keystrokes (use "" for Enter)`);
+          console.log(`  npx noninteractive read ${name}             # read updated output`);
+          console.log(`  npx noninteractive stop ${name}             # stop the session`);
+        }
         return;
       }
       if (res.exited) {
         process.stdout.write(res.output ?? "");
-        console.log(`\n[session '${name}' exited ${res.exitCode}]`);
+        console.log(`\n[session '${name}' exited ${res.exitCode} — the command failed]`);
+        console.log(`hint: the first argument to "start" is the command to run, NOT a session name.`);
+        console.log(`  npx noninteractive start npx vercel        # run an npx package`);
+        console.log(`  npx noninteractive start vercel login       # run a command directly`);
         return;
       }
     } catch {}
   }
 
-  console.log(`[session '${name}' started]`);
-
-  console.error("timeout: failed to start session");
-  process.exit(1);
+  console.log(`[session '${name}' started but no output yet — use:]`);
+  console.log(`  npx noninteractive read ${name}             # read output`);
+  console.log(`  npx noninteractive send ${name} "<text>"   # send keystrokes (use "" for Enter)`);
+  console.log(`  npx noninteractive stop ${name}             # stop the session`);
 }
 
 async function read(name: string) {
@@ -89,6 +149,7 @@ async function read(name: string) {
 async function send(name: string, text: string) {
   const sock = socketPath(name);
   await sendMessage(sock, { action: "send", data: text });
+  console.log(`[sent to '${name}' — run "npx noninteractive read ${name}" to see the result]`);
 }
 
 async function stop(name: string) {
@@ -132,24 +193,23 @@ async function main() {
 
   switch (cmd) {
     case "start": {
-      const name = args[1];
-      if (!name) { console.error("usage: noninteractive start <name> [args...]"); process.exit(1); }
-      return start(name, args.slice(2));
+      if (args.length < 2) { console.error("usage: noninteractive start <cmd> [args...]\n\nexample: npx noninteractive start npx vercel"); process.exit(1); }
+      return start(args.slice(1));
     }
     case "read": {
       const name = args[1];
-      if (!name) { console.error("usage: noninteractive read <name>"); process.exit(1); }
+      if (!name) { console.error("usage: noninteractive read <session>\n\nexample: npx noninteractive read vercel"); process.exit(1); }
       return read(name);
     }
     case "send": {
       const name = args[1];
       const text = args[2];
-      if (!name || text === undefined) { console.error("usage: noninteractive send <name> <text>"); process.exit(1); }
+      if (!name || text === undefined) { console.error("usage: noninteractive send <session> <text>\n\nexample: npx noninteractive send vercel \"y\""); process.exit(1); }
       return send(name, text);
     }
     case "stop": {
       const name = args[1];
-      if (!name) { console.error("usage: noninteractive stop <name>"); process.exit(1); }
+      if (!name) { console.error("usage: noninteractive stop <session>\n\nexample: npx noninteractive stop vercel"); process.exit(1); }
       return stop(name);
     }
     case "list":