setclaw 1.0.4 → 1.0.6

package/README.md

@@ -39,15 +39,29 @@ 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:
 
 ```
-  setclaw — Quatarly setup for Claude Code & Factory
+  setclaw — BOA & Quatarly setup for Claude Code & Factory
   ─────────────────────────────────────────────────
 
 > Adding models to Factory...

package/bin/postinstall.mjs

@@ -1,33 +1,22 @@
 #!/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";
+import { writeFileSync, join, homedir } from "fs";
 
-const apiKey = process.env.QUATARLY_API_KEY;
+// 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) {
-  // 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("");
+  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,6 +1,6 @@
 {
   "name": "setclaw",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "BOA & Quatarly setup for Claude Code and Factory",
   "type": "module",
   "bin": {
@@ -10,12 +10,14 @@
     "postinstall": "node bin/postinstall.mjs"
   },
   "files": [
-    "bin"
+    "bin/setclaw.js",
+    "bin/postinstall.mjs"
   ],
   "keywords": [
     "claude",
     "claude-code",
     "quatarly",
+    "boa",
     "factory",
     "ai",
     "llm",

package/bin/setup.mjs

@@ -1,213 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * setclaw — BOA & Quatarly setup for Claude Code & Factory
- *
- * Usage:
- *   setclaw <API_KEY>
- *   QUATARLY_API_KEY=<key> setclaw
- *   setclaw              (prompts interactively)
- */
-
-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";
-
-// ─── Helpers ─────────────────────────────────────────────────────────
-
-function ask(question) {
-  const rl = createInterface({ input: process.stdin, output: process.stderr, terminal: true });
-  return new Promise((resolve) =>
-    rl.question(question, (answer) => {
-      rl.close();
-      resolve(answer.trim());
-    })
-  );
-}
-
-function log(msg) {
-  process.stderr.write(`\x1b[36m>\x1b[0m ${msg}\n`);
-}
-
-function success(msg) {
-  process.stderr.write(`\x1b[32m✔\x1b[0m ${msg}\n`);
-}
-
-function warn(msg) {
-  process.stderr.write(`\x1b[33m!\x1b[0m ${msg}\n`);
-}
-
-function fail(msg) {
-  process.stderr.write(`\x1b[31m✖\x1b[0m ${msg}\n`);
-}
-
-// ─── 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");
-
-// ─── Get API key ─────────────────────────────────────────────────────
-
-let apiKey = process.env.QUATARLY_API_KEY || process.argv[2];
-
-if (!apiKey) {
-  try {
-    apiKey = await ask("  Enter your Quatarly API key: ");
-  } catch (err) {
-    fail(err.message);
-    process.exit(1);
-  }
-}
-
-if (!apiKey) {
-  fail("API key cannot be empty.");
-  process.exit(1);
-}
-
-process.stderr.write("\n");
-
-// ─── Step 1: Add models to Factory ──────────────────────────────────
-
-const settingsPath = join(homedir(), ".factory", "settings.json");
-
-if (existsSync(settingsPath)) {
-  log("Adding models to Factory...");
-
-  copyFileSync(settingsPath, `${settingsPath}.backup`);
-
-  let raw = readFileSync(settingsPath, "utf-8");
-  if (raw.charCodeAt(0) === 0xfeff) raw = raw.slice(1);
-  const settings = JSON.parse(raw.trim() || "{}");
-
-  const newModels = [
-    { model: "claude-sonnet-4-6-20250929", baseUrl: "https://api.quatarly.cloud/",   provider: "anthropic" },
-    { model: "claude-opus-4-6-thinking",   baseUrl: "https://api.quatarly.cloud/",   provider: "anthropic" },
-    { model: "claude-haiku-4-5-20251001",  baseUrl: "https://api.quatarly.cloud/",   provider: "anthropic" },
-    { model: "gemini-3.1-pro",             baseUrl: "https://api.quatarly.cloud/v1", provider: "openai"    },
-    { model: "gemini-3-flash",             baseUrl: "https://api.quatarly.cloud/v1", provider: "openai"    },
-    { model: "gpt-5.1",                    baseUrl: "https://api.quatarly.cloud/v1", provider: "openai"    },
-    { model: "gpt-5.1-codex",              baseUrl: "https://api.quatarly.cloud/v1", provider: "openai"    },
-    { model: "gpt-5.1-codex-max",          baseUrl: "https://api.quatarly.cloud/v1", provider: "openai"    },
-    { model: "gpt-5.2",                    baseUrl: "https://api.quatarly.cloud/v1", provider: "openai"    },
-    { model: "gpt-5.2-codex",              baseUrl: "https://api.quatarly.cloud/v1", provider: "openai"    },
-    { model: "gpt-5.3-codex",              baseUrl: "https://api.quatarly.cloud/v1", provider: "openai"    },
-  ];
-
-  const existing = settings.customModels || [];
-  const existingNames = new Set(existing.map((m) => m.model));
-  let maxIndex = existing.reduce((max, m) => Math.max(max, m.index ?? -1), -1);
-  let nextIndex = maxIndex + 1;
-
-  let added = 0;
-  let updated = 0;
-
-  for (const m of newModels) {
-    if (existingNames.has(m.model)) {
-      for (const e of existing) {
-        if (e.model === m.model) {
-          e.apiKey = apiKey;
-          e.baseUrl = m.baseUrl;
-          e.provider = m.provider;
-        }
-      }
-      updated++;
-    } else {
-      existing.push({
-        model: m.model,
-        id: `custom:${m.model}-${nextIndex}`,
-        index: nextIndex,
-        baseUrl: m.baseUrl,
-        apiKey,
-        displayName: m.model,
-        noImageSupport: false,
-        provider: m.provider,
-      });
-      nextIndex++;
-      added++;
-    }
-  }
-
-  settings.customModels = existing;
-  writeFileSync(settingsPath, JSON.stringify(settings, null, 2), "utf-8");
-
-  success(`Factory: ${added} models added, ${updated} updated (${existing.length} total)`);
-  success(`Backup saved to ${settingsPath}.backup`);
-} else {
-  warn(`Factory settings not found at ${settingsPath} — skipped.`);
-}
-
-// ─── Step 2: Set Claude Code env vars ────────────────────────────────
-
-log("Setting Claude Code environment variables...");
-
-const vars = {
-  ANTHROPIC_BASE_URL:             "https://api.quatarly.cloud/",
-  ANTHROPIC_AUTH_TOKEN:           apiKey,
-  ANTHROPIC_DEFAULT_HAIKU_MODEL:  "claude-haiku-4-5-20251001",
-  ANTHROPIC_DEFAULT_SONNET_MODEL: "claude-sonnet-4-6-20250929",
-  ANTHROPIC_DEFAULT_OPUS_MODEL:   "claude-opus-4-6-thinking",
-};
-
-const os = platform();
-
-if (os === "win32") {
-  for (const [key, value] of Object.entries(vars)) {
-    execSync(`reg add "HKCU\\Environment" /v "${key}" /t REG_SZ /d "${value}" /f`, {
-      stdio: "ignore",
-    });
-  }
-  success("Env vars written to Windows registry (HKCU\\Environment).");
-} else {
-  const marker = "# --- Quatarly / Claude Code env ---";
-  const endMarker = "# --- end Quatarly ---";
-  const block = [
-    "",
-    marker,
-    ...Object.entries(vars).map(([k, v]) => `export ${k}="${v}"`),
-    endMarker,
-    "",
-  ].join("\n");
-
-  const rcFiles = [join(homedir(), ".bashrc"), join(homedir(), ".zshrc")];
-  const written = [];
-
-  for (const rc of rcFiles) {
-    if (!existsSync(rc)) continue;
-
-    const content = readFileSync(rc, "utf-8");
-    if (content.includes(marker)) {
-      const regex = new RegExp(
-        `\\n?${marker.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}[\\s\\S]*?${endMarker.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\n?`,
-        "g"
-      );
-      writeFileSync(rc, content.replace(regex, block), "utf-8");
-    } else {
-      appendFileSync(rc, block, "utf-8");
-    }
-    written.push(rc);
-  }
-
-  if (written.length === 0) {
-    const fallback = join(homedir(), ".bashrc");
-    appendFileSync(fallback, block, "utf-8");
-    written.push(fallback);
-  }
-
-  success(`Env vars written to: ${written.join(", ")}`);
-}
-
-// ─── Done ────────────────────────────────────────────────────────────
-
-process.stderr.write("\n");
-process.stderr.write("  \x1b[1mEnvironment variables set:\x1b[0m\n");
-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`);
-}
-process.stderr.write("\n");
-success("All done! Restart your terminal, then launch Claude Code.");
-process.stderr.write("\n");