setclaw 1.0.0 → 1.0.2

package/README.md

@@ -0,0 +1,249 @@
+<div align="center">
+
+# setclaw
+
+**One command. All models. Every OS.**
+
+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.
+
+[![npm version](https://img.shields.io/npm/v/setclaw?color=cb3837&label=npm&logo=npm&logoColor=white)](https://www.npmjs.com/package/setclaw)
+[![node](https://img.shields.io/node/v/setclaw?color=339933&logo=node.js&logoColor=white)](https://nodejs.org)
+[![license](https://img.shields.io/npm/l/setclaw?color=blue)](./LICENSE)
+[![platform](https://img.shields.io/badge/platform-windows%20%7C%20macos%20%7C%20linux-lightgrey?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld0JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9IndoaXRlIiBzdHJva2Utd2lkdGg9IjIiIHN0cm9rZS1saW5lY2FwSj0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiPjxyZWN0IHg9IjIiIHk9IjMiIHdpZHRoPSIyMCIgaGVpZ2h0PSIxNCIgcng9IjIiLz48bGluZSB4MT0iOCIgeTE9IjIxIiB4Mj0iMTYiIHkyPSIyMSIvPjxsaW5lIHgxPSIxMiIgeTE9IjE3IiB4Mj0iMTIiIHkyPSIyMSIvPjwvc3ZnPg==)](https://www.npmjs.com/package/setclaw)
+
+</div>
+
+---
+
+## What You Get
+
+| Provider | Models |
+|:---------|:-------|
+| **Claude** | Sonnet 4.6, Opus 4.6 Thinking, Haiku 4.5 |
+| **Gemini** | 3.1 Pro, 3 Flash |
+| **GPT** | 5.1, 5.1 Codex, 5.1 Codex Max, 5.2, 5.2 Codex, 5.3 Codex |
+
+> All 11 models through one Quatarly API key. No separate accounts needed.
+
+---
+
+## Quick Start
+
+### Prerequisites
+
+| # | What | How |
+|:-:|:-----|:----|
+| 1 | **Node.js 18+** | [nodejs.org](https://nodejs.org) |
+| 2 | **Quatarly API key** | Format: `qua_trail_...` or `qua_...` |
+| 3 | **Factory AI** *(optional)* | See [Install Factory](#install-factory-ai-optional) below |
+
+### Install & Configure
+
+```bash
+npm i -g setclaw
+setclaw <your-quatarly-api-key>
+```
+
+That's it. When you run `setclaw`, it will:
+
+```
+  setclaw — Quatarly setup for Claude Code & Factory
+  ─────────────────────────────────────────────────
+
+> Adding models to Factory...
+✔ Factory: 11 models added, 0 updated (11 total)
+✔ Backup saved to ~/.factory/settings.json.backup
+> Setting Claude Code environment variables...
+✔ Env vars written to Windows registry (HKCU\Environment).
+
+  Environment variables set:
+    ANTHROPIC_BASE_URL             = https://api.quatarly.cloud/
+    ANTHROPIC_AUTH_TOKEN           = qua_trai...
+    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
+
+✔ All done! Restart your terminal, then launch Claude Code.
+```
+
+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 setclaw
+```
+
+---
+
+## Using Claude Code
+
+### 1. Install Claude Code
+
+```bash
+npm i -g @anthropic-ai/claude-code
+```
+
+### 2. Restart Your Terminal
+
+> **Important:** Environment variables are set persistently, but your current shell won't see them until you restart it.
+>
+> - **New terminal** — picks up automatically
+> - **Current terminal** — run `source ~/.zshrc` or `source ~/.bashrc`
+> - **VS Code / GUI apps** — restart the app or log out & back in
+
+### 3. Launch
+
+```bash
+claude
+```
+
+Claude Code now routes all requests through Quatarly using your API key and credit balance.
+
+---
+
+## Install Factory AI *(Optional)*
+
+If you also want custom models inside Factory AI Droid:
+
+**Windows (PowerShell):**
+```powershell
+irm https://app.factory.ai/cli/windows | iex
+```
+
+**macOS / Linux:**
+```bash
+curl -fsSL https://app.factory.ai/cli | sh
+```
+
+Then create an account at [app.factory.ai](https://app.factory.ai), run `droid` once to generate `~/.factory/settings.json`, and re-run:
+
+```bash
+npm i -g setclaw
+```
+
+`setclaw` will detect the Factory config and inject all 11 models automatically.
+
+---
+
+## Environment Variables Set
+
+| Variable | Value |
+|:---------|:------|
+| `ANTHROPIC_BASE_URL` | `https://api.quatarly.cloud/` |
+| `ANTHROPIC_AUTH_TOKEN` | *your Quatarly API key* |
+| `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` |
+
+<details>
+<summary><b>Where are they stored?</b></summary>
+
+| OS | Location |
+|:---|:---------|
+| **Windows** | `HKCU\Environment` (User-level registry) |
+| **macOS** | `~/.bashrc` and `~/.zshrc` |
+| **Linux** | `~/.bashrc` and `~/.zshrc` |
+
+</details>
+
+---
+
+## Models Reference
+
+| Model | Provider | Endpoint |
+|:------|:---------|:---------|
+| `claude-sonnet-4-6-20250929` | Anthropic | `https://api.quatarly.cloud/` |
+| `claude-opus-4-6-thinking` | Anthropic | `https://api.quatarly.cloud/` |
+| `claude-haiku-4-5-20251001` | Anthropic | `https://api.quatarly.cloud/` |
+| `gemini-3.1-pro` | OpenAI-compat | `https://api.quatarly.cloud/v1` |
+| `gemini-3-flash` | OpenAI-compat | `https://api.quatarly.cloud/v1` |
+| `gpt-5.1` | OpenAI-compat | `https://api.quatarly.cloud/v1` |
+| `gpt-5.1-codex` | OpenAI-compat | `https://api.quatarly.cloud/v1` |
+| `gpt-5.1-codex-max` | OpenAI-compat | `https://api.quatarly.cloud/v1` |
+| `gpt-5.2` | OpenAI-compat | `https://api.quatarly.cloud/v1` |
+| `gpt-5.2-codex` | OpenAI-compat | `https://api.quatarly.cloud/v1` |
+| `gpt-5.3-codex` | OpenAI-compat | `https://api.quatarly.cloud/v1` |
+
+---
+
+## Manual Setup (Without setclaw)
+
+<details>
+<summary><b>macOS / Linux</b></summary>
+
+```bash
+export ANTHROPIC_BASE_URL="https://api.quatarly.cloud/"
+export ANTHROPIC_AUTH_TOKEN="qua_trail_your-key-here"
+export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5-20251001"
+export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-6-20250929"
+export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-6-thinking"
+```
+
+Add these to `~/.zshrc` or `~/.bashrc` to persist.
+
+</details>
+
+<details>
+<summary><b>Windows (PowerShell)</b></summary>
+
+```powershell
+$env:ANTHROPIC_BASE_URL             = "https://api.quatarly.cloud/"
+$env:ANTHROPIC_AUTH_TOKEN           = "qua_trail_your-key-here"
+$env:ANTHROPIC_DEFAULT_HAIKU_MODEL  = "claude-haiku-4-5-20251001"
+$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-4-6-20250929"
+$env:ANTHROPIC_DEFAULT_OPUS_MODEL   = "claude-opus-4-6-thinking"
+```
+
+To persist, use `[System.Environment]::SetEnvironmentVariable("VAR", "value", "User")` for each.
+
+</details>
+
+---
+
+## FAQ
+
+<details>
+<summary><b>Can I run it again with a different API key?</b></summary>
+
+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>
+
+<details>
+<summary><b>Do I need an Anthropic account?</b></summary>
+
+No. Claude Code routes through Quatarly — you only need a Quatarly API key.
+
+</details>
+
+<details>
+<summary><b>What if Factory AI isn't installed?</b></summary>
+
+`setclaw` detects whether `~/.factory/settings.json` exists. If not, it skips Factory setup and only configures Claude Code env vars.
+
+</details>
+
+<details>
+<summary><b>How do I uninstall?</b></summary>
+
+```bash
+npm uninstall -g setclaw
+```
+
+This removes the package. To also remove the env vars:
+- **Windows:** Delete from `HKCU\Environment` via System Properties > Environment Variables
+- **macOS/Linux:** Remove the `# --- Quatarly / Claude Code env ---` block from `~/.bashrc` / `~/.zshrc`
+
+</details>
+
+---
+
+## License
+
+MIT

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 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,13 +1,15 @@
 #!/usr/bin/env node
 
 /**
- * setclaw postinstall — runs automatically during `npm i -g setclaw`
+ * setclaw — One-command 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, openSync, 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";
@@ -15,27 +17,14 @@ import { createInterface } from "readline";
 
 // ─── Helpers ─────────────────────────────────────────────────────────
 
-function openTTY() {
-  const ttyPath = platform() === "win32" ? "CON" : "/dev/tty";
-  return createReadStream(ttyPath, { encoding: "utf-8" });
-}
-
 function ask(question) {
-  return new Promise((resolve, reject) => {
-    let ttyIn;
-    try {
-      ttyIn = openTTY();
-    } 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) {
@@ -63,7 +52,7 @@ 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.0",
+  "version": "1.0.2",
   "description": "One-command setup for Quatarly API models in Claude Code and Factory",
   "type": "module",
+  "bin": {
+    "setclaw": "./bin/setup.mjs"
+  },
   "scripts": {
-    "postinstall": "node bin/setup.mjs"
+    "postinstall": "node bin/postinstall.mjs"
   },
   "files": [
     "bin"