setclaw 1.0.5 → 1.0.6

package/README.md

@@ -39,9 +39,23 @@ Connect [Claude Code](https://docs.anthropic.com/en/docs/claude-code) and [Facto
 
 ### Install & Configure
 
+Pass your API key during install — everything configures automatically in one command:
+
+**Windows (PowerShell):**
+```powershell
+$env:QUATARLY_API_KEY="qua_your-key-here"; npm i -g setclaw --foreground-scripts
+```
+
+**macOS / Linux:**
+```bash
+QUATARLY_API_KEY=qua_your-key-here npm i -g setclaw --foreground-scripts
+```
+
+Or install first, then run the `setclaw` command separately:
+
 ```bash
 npm i -g setclaw
-setclaw <your-quatarly-api-key>
+setclaw qua_your-key-here
 ```
 
 That's it. When you run `setclaw`, it will:

package/bin/postinstall.mjs

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+
+import { platform } from "os";
+import { writeFileSync, join, homedir } from "fs";
+
+// Always write a "pending setup" marker so setclaw can detect first run
+import { join as pathJoin } from "path";
+import { homedir as getHome } from "os";
+import { writeFileSync as wf, mkdirSync } from "fs";
+
+const markerDir = pathJoin(getHome(), ".setclaw");
+const markerFile = pathJoin(markerDir, "pending");
+
+try {
+  mkdirSync(markerDir, { recursive: true });
+  wf(markerFile, "1", "utf-8");
+} catch {}
+
+const apiKey = process.env.QUATARLY_API_KEY;
+if (apiKey) {
+  await import("./setclaw.js");
+}

package/bin/setclaw.js

@@ -9,7 +9,7 @@
  *   setclaw              (prompts interactively)
  */
 
-import { readFileSync, writeFileSync, copyFileSync, appendFileSync, existsSync } from "fs";
+import { readFileSync, writeFileSync, copyFileSync, appendFileSync, existsSync, rmSync, mkdirSync } from "fs";
 import { join } from "path";
 import { homedir, platform } from "os";
 import { execSync } from "child_process";
@@ -27,33 +27,41 @@ function ask(question) {
   );
 }
 
-function log(msg) {
-  process.stderr.write(`\x1b[36m>\x1b[0m ${msg}\n`);
-}
+const out = (msg) => process.stdout.write(msg + "\n");
+const err = (msg) => process.stderr.write(msg + "\n");
 
-function success(msg) {
-  process.stderr.write(`\x1b[32m✔\x1b[0m ${msg}\n`);
-}
+function log(msg)     { err(`\x1b[36m>\x1b[0m ${msg}`); }
+function success(msg) { err(`\x1b[32m✔\x1b[0m ${msg}`); }
+function warn(msg)    { err(`\x1b[33m!\x1b[0m ${msg}`); }
+function fail(msg)    { err(`\x1b[31m✖\x1b[0m ${msg}`); }
 
-function warn(msg) {
-  process.stderr.write(`\x1b[33m!\x1b[0m ${msg}\n`);
-}
+// ─── First-run detection ──────────────────────────────────────────────
 
-function fail(msg) {
-  process.stderr.write(`\x1b[31m✖\x1b[0m ${msg}\n`);
-}
+const markerFile = join(homedir(), ".setclaw", "pending");
+const isFirstRun = existsSync(markerFile);
 
 // ─── Banner ──────────────────────────────────────────────────────────
 
-process.stderr.write("\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");
+out("");
+out("\x1b[1m  setclaw\x1b[0m — BOA & Quatarly setup for Claude Code & Factory");
+out("  \x1b[2m─────────────────────────────────────────────────\x1b[0m");
+out("");
 
 // ─── Get API key ─────────────────────────────────────────────────────
 
 let apiKey = process.env.QUATARLY_API_KEY || process.argv[2];
 
+// If no key and this is first run (just installed), show clear instructions
+if (!apiKey && isFirstRun) {
+  out("  \x1b[33m⚡ Setup required!\x1b[0m Run with your Quatarly API key:");
+  out("");
+  out("     \x1b[36msetclaw\x1b[0m \x1b[33m<your-api-key>\x1b[0m");
+  out("");
+  out("  Get your key at \x1b[4mhttps://api.quatarly.cloud\x1b[0m");
+  out("");
+  process.exit(0);
+}
+
 if (!apiKey) {
   try {
     apiKey = await ask("  Enter your Quatarly API key: ");
@@ -202,12 +210,15 @@ if (os === "win32") {
 
 // ─── Done ────────────────────────────────────────────────────────────
 
-process.stderr.write("\n");
-process.stderr.write("  \x1b[1mEnvironment variables set:\x1b[0m\n");
+// Clear the first-run marker
+try { rmSync(markerFile); } catch {}
+
+out("");
+out("  \x1b[1mEnvironment variables set:\x1b[0m");
 for (const [key, value] of Object.entries(vars)) {
   const display = key === "ANTHROPIC_AUTH_TOKEN" ? value.slice(0, 8) + "..." : value;
-  process.stderr.write(`    ${key} = ${display}\n`);
+  out(`    ${key} = ${display}`);
 }
-process.stderr.write("\n");
+out("");
 success("All done! Restart your terminal, then launch Claude Code.");
-process.stderr.write("\n");
+out("");

package/package.json

@@ -1,13 +1,17 @@
 {
   "name": "setclaw",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "BOA & Quatarly setup for Claude Code and Factory",
   "type": "module",
   "bin": {
     "setclaw": "bin/setclaw.js"
   },
+  "scripts": {
+    "postinstall": "node bin/postinstall.mjs"
+  },
   "files": [
-    "bin/setclaw.js"
+    "bin/setclaw.js",
+    "bin/postinstall.mjs"
   ],
   "keywords": [
     "claude",