setclaw 1.0.7 → 1.1.0

package/README.md

@@ -39,7 +39,14 @@ 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:
+```bash
+npm i -g setclaw --foreground-scripts
+setclaw <your-quatarly-api-key>
+```
+
+The `--foreground-scripts` flag makes npm show the setup instructions during install. Without it, npm is silent (that's npm's default behavior for lifecycle scripts).
+
+**One-liner** — pass your key during install, no second command needed:
 
 **Windows (PowerShell):**
 ```powershell
@@ -51,13 +58,6 @@ $env:QUATARLY_API_KEY="qua_your-key-here"; npm i -g setclaw --foreground-scripts
 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 qua_your-key-here
-```
-
 That's it. When you run `setclaw`, it will:
 
 ```

package/bin/postinstall.mjs

@@ -1,18 +1,42 @@
 #!/usr/bin/env node
 
 import { join } from "path";
-import { homedir } from "os";
+import { homedir, platform } from "os";
 import { writeFileSync, mkdirSync } from "fs";
 
+// ─── Write first-run marker ───────────────────────────────────────────
 const markerDir = join(homedir(), ".setclaw");
 const markerFile = join(markerDir, "pending");
 
 try {
   mkdirSync(markerDir, { recursive: true });
-  wf(markerFile, "1", "utf-8");
+  writeFileSync(markerFile, "1", "utf-8");
 } catch {}
 
+// ─── If API key provided, run full setup now ──────────────────────────
 const apiKey = process.env.QUATARLY_API_KEY;
 if (apiKey) {
   await import("./setclaw.js");
+  process.exit(0);
 }
+
+// ─── Always print next-step instructions ─────────────────────────────
+// (visible when user runs: npm i -g setclaw --foreground-scripts)
+const w = (msg = "") => process.stdout.write(msg + "\n");
+
+w();
+w("  \x1b[1msetclaw\x1b[0m — BOA & Quatarly setup for Claude Code & Factory");
+w("  \x1b[2m─────────────────────────────────────────────────\x1b[0m");
+w();
+w("  \x1b[32m✔ Installed!\x1b[0m Now run:");
+w();
+w("     \x1b[36msetclaw\x1b[0m \x1b[33m<your-quatarly-api-key>\x1b[0m");
+w();
+if (platform() === "win32") {
+  w("  \x1b[2mor with env var:\x1b[0m");
+  w('  \x1b[2m$env:QUATARLY_API_KEY="<key>"; npm i -g setclaw --foreground-scripts\x1b[0m');
+} else {
+  w("  \x1b[2mor with env var:\x1b[0m");
+  w("  \x1b[2mQUATARLY_API_KEY=<key> npm i -g setclaw --foreground-scripts\x1b[0m");
+}
+w();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "setclaw",
-  "version": "1.0.7",
+  "version": "1.1.0",
   "description": "BOA & Quatarly setup for Claude Code and Factory",
   "type": "module",
   "bin": {
@@ -26,5 +26,9 @@
   "license": "MIT",
   "engines": {
     "node": ">=18"
+  },
+  "funding": {
+    "type": "individual",
+    "url": "https://api.quatarly.cloud"
   }
 }