setclaw 1.0.1 → 1.0.3

package/README.md

@@ -2,7 +2,7 @@
 
 # setclaw
 
-**One command. All models. Every OS.**
+**BOA & Quatarly setup for Claude Code & Factory**
 
 Connect [Claude Code](https://docs.anthropic.com/en/docs/claude-code) and [Factory AI Droid](https://app.factory.ai) to [Quatarly](https://api.quatarly.cloud) — access Claude, Gemini, and GPT models with a single API key.
 
@@ -37,20 +37,19 @@ Connect [Claude Code](https://docs.anthropic.com/en/docs/claude-code) and [Facto
 | 2 | **Quatarly API key** | Format: `qua_trail_...` or `qua_...` |
 | 3 | **Factory AI** *(optional)* | See [Install Factory](#install-factory-ai-optional) below |
 
-### Install & Configure — One Command
+### Install & Configure
 
 ```bash
 npm i -g setclaw
+setclaw <your-quatarly-api-key>
 ```
 
-That's it. During installation it will:
+That's it. When you run `setclaw`, it will:
 
 ```
   setclaw — Quatarly setup for Claude Code & Factory
   ─────────────────────────────────────────────────
 
-  Enter your Quatarly API key: █
-
 > Adding models to Factory...
 ✔ Factory: 11 models added, 0 updated (11 total)
 ✔ Backup saved to ~/.factory/settings.json.backup
@@ -67,10 +66,17 @@ That's it. During installation it will:
 ✔ All done! Restart your terminal, then launch Claude Code.
 ```
 
-### Non-Interactive Install (CI / Scripts)
+You can also run without arguments to get an interactive prompt:
+
+```bash
+setclaw
+#   Enter your Quatarly API key: █
+```
+
+### Non-Interactive (CI / Scripts)
 
 ```bash
-QUATARLY_API_KEY=qua_trail_your-key npm i -g setclaw
+QUATARLY_API_KEY=qua_trail_your-key setclaw
 ```
 
 ---
@@ -205,7 +211,7 @@ To persist, use `[System.Environment]::SetEnvironmentVariable("VAR", "value", "U
 <details>
 <summary><b>Can I run it again with a different API key?</b></summary>
 
-Yes. Re-run `npm i -g setclaw` — it updates existing models and env vars without creating duplicates. A backup of your Factory settings is saved before any changes.
+Yes. Just run `setclaw <new-key>` again — it updates existing models and env vars without creating duplicates. A backup of your Factory settings is saved before any changes.
 
 </details>
 

package/bin/postinstall.mjs

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+
+/**
+ * postinstall — If QUATARLY_API_KEY env var is set, run setup automatically.
+ * Otherwise, print instructions telling the user to run `setclaw`.
+ */
+
+import { platform } from "os";
+
+const apiKey = process.env.QUATARLY_API_KEY;
+
+if (apiKey) {
+  // Non-interactive install: run setup directly
+  await import("./setup.mjs");
+} else {
+  // Interactive install: can't prompt during npm postinstall, so guide the user
+  const w = (msg) => process.stderr.write(msg + "\n");
+  w("");
+  w("\x1b[1m  setclaw\x1b[0m — BOA & Quatarly — installed successfully!");
+  w("");
+  w("  Run this command to configure your Quatarly API key:");
+  w("");
+  w("    \x1b[36msetclaw \x1b[33m<your-api-key>\x1b[0m");
+  w("");
+  w("  Or with an env var:");
+  w("");
+  if (platform() === "win32") {
+    w('    \x1b[36m$env:QUATARLY_API_KEY="your-key"; setclaw\x1b[0m');
+  } else {
+    w("    \x1b[36mQUATARLY_API_KEY=your-key setclaw\x1b[0m");
+  }
+  w("");
+}

package/bin/setup.mjs

@@ -1,55 +1,30 @@
 #!/usr/bin/env node
 
 /**
- * setclaw postinstall — runs automatically during `npm i -g setclaw`
+ * setclaw — BOA & Quatarly setup for Claude Code & Factory
  *
- * npm suppresses stdin during lifecycle scripts, so we open the
- * terminal directly (/dev/tty on unix, CON on windows) to prompt.
+ * Usage:
+ *   setclaw <API_KEY>
+ *   QUATARLY_API_KEY=<key> setclaw
+ *   setclaw              (prompts interactively)
  */
 
-import { readFileSync, writeFileSync, copyFileSync, appendFileSync, existsSync, createReadStream } from "fs";
+import { readFileSync, writeFileSync, copyFileSync, appendFileSync, existsSync } from "fs";
 import { join } from "path";
 import { homedir, platform } from "os";
 import { execSync } from "child_process";
 import { createInterface } from "readline";
-import { Socket } from "net";
 
 // ─── Helpers ─────────────────────────────────────────────────────────
 
 function ask(question) {
-  if (platform() === "win32") {
-    // On Windows, npm postinstall has no usable stdin and createReadStream("CON")
-    // resolves as a relative path. Shell out to PowerShell to read from the console.
-    process.stderr.write(question);
-    try {
-      const result = execSync(
-        'powershell -NoProfile -Command "[Console]::In.ReadLine()"',
-        { stdio: ["inherit", "pipe", "inherit"], encoding: "utf-8" }
-      );
-      return Promise.resolve((result || "").trim());
-    } catch {
-      return Promise.reject(
-        new Error("Cannot read from terminal. Pass the key via: QUATARLY_API_KEY=<key> npm i -g setclaw")
-      );
-    }
-  }
-
-  // Unix: open /dev/tty directly to bypass npm's stdin suppression
-  return new Promise((resolve, reject) => {
-    let ttyIn;
-    try {
-      ttyIn = createReadStream("/dev/tty", { encoding: "utf-8" });
-    } catch {
-      reject(new Error("Cannot open terminal for input. Pass the key via: QUATARLY_API_KEY=<key> npm i -g setclaw"));
-      return;
-    }
-    const rl = createInterface({ input: ttyIn, output: process.stderr, terminal: true });
+  const rl = createInterface({ input: process.stdin, output: process.stderr, terminal: true });
+  return new Promise((resolve) =>
     rl.question(question, (answer) => {
       rl.close();
-      ttyIn.destroy();
       resolve(answer.trim());
-    });
-  });
+    })
+  );
 }
 
 function log(msg) {
@@ -71,13 +46,13 @@ function fail(msg) {
 // ─── Banner ──────────────────────────────────────────────────────────
 
 process.stderr.write("\n");
-process.stderr.write("\x1b[1m  setclaw\x1b[0m — Quatarly setup for Claude Code & Factory\n");
+process.stderr.write("\x1b[1m  setclaw\x1b[0m — BOA & Quatarly setup for Claude Code & Factory\n");
 process.stderr.write("  ─────────────────────────────────────────────────\n");
 process.stderr.write("\n");
 
 // ─── Get API key ─────────────────────────────────────────────────────
 
-let apiKey = process.env.QUATARLY_API_KEY;
+let apiKey = process.env.QUATARLY_API_KEY || process.argv[2];
 
 if (!apiKey) {
   try {

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "setclaw",
-  "version": "1.0.1",
-  "description": "One-command setup for Quatarly API models in Claude Code and Factory",
+  "version": "1.0.3",
+  "description": "BOA & Quatarly setup for Claude Code and Factory",
   "type": "module",
+  "bin": {
+    "setclaw": "./bin/setup.mjs"
+  },
   "scripts": {
-    "postinstall": "node bin/setup.mjs"
+    "postinstall": "node bin/postinstall.mjs"
   },
   "files": [
     "bin"