@aayambansal/squint 0.2.4 → 0.2.5

package/README.md

@@ -225,6 +225,8 @@ All product behavior lives in the harness, so a new engine is ~80 lines.
 
 ## Docs
 
+- [Engine setup guide](./docs/engines.md) — install + auth for all eight, and how to choose
+- [Configuration](./docs/configuration.md) — every key, every `.squint/` file
 - [Architecture](./docs/design/2026-07-25-architecture.md)
 - [How Lovable works under the hood](./docs/research/lovable.md)
 - [Making agents produce excellent frontend work](./docs/research/frontend-quality.md)

package/dist/background-J7OQTYEC.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+
+// src/tui/background.ts
+function parseOsc11(reply) {
+  const match = /rgb:([0-9a-fA-F]{2,4})\/([0-9a-fA-F]{2,4})\/([0-9a-fA-F]{2,4})/.exec(reply);
+  if (!match) return "unknown";
+  const channel = (hex) => Number.parseInt(hex.slice(0, 2), 16);
+  const [r, g, b] = [channel(match[1]), channel(match[2]), channel(match[3])];
+  const luminance = 0.2126 * r + 0.7152 * g + 0.0722 * b;
+  return luminance > 140 ? "light" : "dark";
+}
+function detectBackground(timeoutMs = 300) {
+  return new Promise((resolve) => {
+    const { stdin, stdout } = process;
+    if (!stdin.isTTY || !stdout.isTTY) return resolve("unknown");
+    let buffer = "";
+    const finish = (result) => {
+      clearTimeout(timer);
+      stdin.off("data", onData);
+      resolve(result);
+    };
+    const onData = (chunk) => {
+      buffer += chunk.toString("utf8");
+      if (buffer.includes("rgb:")) {
+        const parsed = parseOsc11(buffer);
+        if (parsed !== "unknown") finish(parsed);
+      }
+    };
+    const timer = setTimeout(() => finish("unknown"), timeoutMs);
+    stdin.on("data", onData);
+    try {
+      stdout.write("\x1B]11;?\x07");
+    } catch {
+      finish("unknown");
+    }
+  });
+}
+export {
+  detectBackground,
+  parseOsc11
+};

package/dist/{chrome-RD7XQ767.js → chrome-RV25VKUA.js}

@@ -2,8 +2,8 @@
 import {
   findChrome,
   screenshot
-} from "./chunk-P3V5CWH5.js";
-import "./chunk-2LRIKWBU.js";
+} from "./chunk-CJXYSQNB.js";
+import "./chunk-CH4GNJCZ.js";
 export {
   findChrome,
   screenshot

package/dist/{chunk-DLCRYRWQ.js → chunk-62JNF5M2.js}

@@ -39,6 +39,20 @@ function detectGates(cwd) {
   } else if (hasEslintConfig) {
     gates.push({ id: "lint", command: "npx", args: ["eslint", ".", "--max-warnings", "0"], display: "eslint ." });
   }
+  const hasPrettier = [
+    ".prettierrc",
+    ".prettierrc.json",
+    ".prettierrc.js",
+    ".prettierrc.yaml",
+    ".prettierrc.yml",
+    "prettier.config.js",
+    "prettier.config.mjs"
+  ].some((file) => fs.existsSync(path.join(cwd, file)));
+  if (scripts.format && /--check|-c\b/.test(scripts.format)) {
+    gates.push({ id: "format", ...npmRun("format") });
+  } else if (hasPrettier) {
+    gates.push({ id: "format", command: "npx", args: ["prettier", "--check", "."], display: "prettier --check ." });
+  }
   const testScript = scripts.test;
   if (testScript && !/no test specified/i.test(testScript)) {
     gates.push({ id: "test", ...npmRun("test") });

package/dist/{chunk-2LRIKWBU.js → chunk-CH4GNJCZ.js}

@@ -37,6 +37,7 @@ var aider = {
   supportsResume: false,
   buildArgs(opts) {
     const args = ["--message", opts.prompt, "--yes-always", "--no-auto-commits"];
+    if (opts.mode === "plan") args.push("--dry-run");
     if (opts.model) args.push("--model", opts.model);
     return args;
   }
@@ -123,10 +124,9 @@ var amp = {
   install: "npm install -g @sourcegraph/amp",
   supportsResume: true,
   buildArgs(opts) {
-    if (opts.sessionId) {
-      return ["threads", "continue", "--execute", opts.prompt, "--stream-json"];
-    }
-    return ["-x", opts.prompt, "--stream-json"];
+    const args = opts.sessionId ? ["threads", "continue", "--execute", opts.prompt, "--stream-json"] : ["-x", opts.prompt, "--stream-json"];
+    if (opts.mode === "yolo") args.push("--dangerously-allow-all");
+    return args;
   },
   createParser: () => createClaudeStreamParser("amp")
 };
@@ -265,7 +265,8 @@ var copilot = {
   install: "npm install -g @github/copilot",
   supportsResume: false,
   buildArgs(opts) {
-    const args = ["-p", opts.prompt, "-s", "--allow-all-tools"];
+    const args = ["-p", opts.prompt, "-s"];
+    if (opts.mode !== "plan") args.push("--allow-all-tools");
     if (opts.model) args.push("--model", opts.model);
     return args;
   }
@@ -314,6 +315,8 @@ var opencode = {
   supportsResume: true,
   buildArgs(opts) {
     const args = ["run", "--format", "json"];
+    if (opts.mode === "plan") args.push("--agent", "plan");
+    if (opts.mode === "yolo") args.push("--auto");
     if (opts.model) args.push("--model", opts.model);
     if (opts.sessionId) args.push("--session", opts.sessionId);
     args.push(opts.prompt);

package/dist/{chunk-P3V5CWH5.js → chunk-CJXYSQNB.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   findBinary
-} from "./chunk-2LRIKWBU.js";
+} from "./chunk-CH4GNJCZ.js";
 
 // src/preview/chrome.ts
 import { spawn } from "child_process";

package/dist/{chunk-CIQ3OUAF.js → chunk-DKQ5KJD7.js}

@@ -6,7 +6,7 @@ import {
 import {
   findChrome,
   screenshot
-} from "./chunk-P3V5CWH5.js";
+} from "./chunk-CJXYSQNB.js";
 
 // src/preview/preview.ts
 import fs2 from "fs";

package/dist/{chunk-2IW2MMCY.js → chunk-QNNT6FP4.js}

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import {
   variantsRoot
-} from "./chunk-LCS47EAG.js";
+} from "./chunk-XLNTTZX4.js";
 import {
   findChrome,
   screenshot
-} from "./chunk-P3V5CWH5.js";
+} from "./chunk-CJXYSQNB.js";
 import {
   lineSplitter
-} from "./chunk-2LRIKWBU.js";
+} from "./chunk-CH4GNJCZ.js";
 
 // src/variants/shots.ts
 import path2 from "path";

package/dist/{chunk-OTG4ZB4R.js → chunk-TI2R7QRL.js}

@@ -3,7 +3,7 @@ import {
   findEngineBinary,
   lineSplitter,
   truncate
-} from "./chunk-2LRIKWBU.js";
+} from "./chunk-CH4GNJCZ.js";
 
 // src/runner/run.ts
 import { spawn } from "child_process";

package/dist/{chunk-LCS47EAG.js → chunk-XLNTTZX4.js}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-P3H4N2EN.js";
 import {
   runAgent
-} from "./chunk-OTG4ZB4R.js";
+} from "./chunk-TI2R7QRL.js";
 
 // src/variants/variants.ts
 import { execFileSync } from "child_process";

package/dist/cli.js

@@ -10,19 +10,19 @@ import {
   buildFixPrompt,
   detectDevCommand,
   screenshotVariants
-} from "./chunk-2IW2MMCY.js";
+} from "./chunk-QNNT6FP4.js";
 import {
   applyVariant,
   cleanVariants,
   listVariants,
   runVariants
-} from "./chunk-LCS47EAG.js";
+} from "./chunk-XLNTTZX4.js";
 import {
   composePrompt
 } from "./chunk-P3H4N2EN.js";
 import {
   runAgent
-} from "./chunk-OTG4ZB4R.js";
+} from "./chunk-TI2R7QRL.js";
 import {
   completeCommand
 } from "./chunk-EECGXFRX.js";
@@ -31,7 +31,7 @@ import {
   detectFastGates,
   detectGates,
   runGates
-} from "./chunk-DLCRYRWQ.js";
+} from "./chunk-62JNF5M2.js";
 import {
   buildReviewPrompt,
   buildRuntimeFixPrompt,
@@ -42,15 +42,15 @@ import {
   probeRuntime,
   runtimeSummary,
   saveState
-} from "./chunk-CIQ3OUAF.js";
+} from "./chunk-DKQ5KJD7.js";
 import "./chunk-OC6RU6XH.js";
 import {
   findChrome
-} from "./chunk-P3V5CWH5.js";
+} from "./chunk-CJXYSQNB.js";
 import {
   detectEngines,
   getEngine
-} from "./chunk-2LRIKWBU.js";
+} from "./chunk-CH4GNJCZ.js";
 import {
   enrich
 } from "./chunk-4LAU5TGK.js";
@@ -1051,6 +1051,15 @@ var THEMES = {
     success: "#31748f",
     tool: "#c4a7e7"
   },
+  light: {
+    name: "light",
+    accent: "#9a6b1f",
+    dim: "#6b6f76",
+    user: "#2a5db0",
+    error: "#c4322e",
+    success: "#3d7a37",
+    tool: "#0f7b8a"
+  },
   mono: {
     name: "mono",
     accent: "white",
@@ -1473,12 +1482,18 @@ function App({
 
 // src/cli.tsx
 import { jsx as jsx4 } from "react/jsx-runtime";
-var VERSION = "0.2.4";
+var VERSION = "0.2.5";
 var program = new Command();
 program.name("squint").description("Lovable for your terminal \u2014 a frontend harness on top of Claude Code, Codex, and friends.").version(VERSION);
-program.command("run").description("Run one prompt headlessly and stream the result").argument("<prompt...>", "what to build or change").option("-e, --engine <id>", "engine to use (claude, codex, gemini, opencode)").option("-m, --model <name>", "model override for the engine").option("--no-brief", "send the prompt without the squint design brief").option("--json", "emit normalized agent events as ndjson").action(
+program.command("run").description("Run one prompt headlessly and stream the result").argument("<prompt...>", "what to build or change").option("-e, --engine <id>", "engine to use (see squint engines)").option("-m, --model <name>", "model override for the engine").option("--mode <mode>", "plan (read-only) \xB7 safe (default) \xB7 yolo (no friction)").option("--no-brief", "send the prompt without the squint design brief").option("--json", "emit normalized agent events as ndjson").action(
   async (promptWords, options) => {
     const cwd = process.cwd();
+    if (options.mode && !["plan", "safe", "yolo"].includes(options.mode)) {
+      console.error(pc.red("\u2717 --mode must be plan, safe, or yolo"));
+      process.exitCode = 1;
+      return;
+    }
+    const mode = options.mode;
     const config = loadConfig(defaultPaths(cwd));
     const engineId = resolveEngineId(config, options.engine);
     const engine = getEngine(engineId);
@@ -1488,8 +1503,9 @@ program.command("run").description("Run one prompt headlessly and stream the res
     const onEvent = options.json ? (event) => {
       if (event.type !== "delta") console.log(JSON.stringify(event));
     } : createPrinter();
-    if (!options.json) console.log(pc.dim(`squint \xB7 ${engine.id}${model ? ` \xB7 ${model}` : ""}`));
-    const result = await runAgent(engine, { prompt, cwd, model }, onEvent);
+    if (!options.json)
+      console.log(pc.dim(`squint \xB7 ${engine.id}${model ? ` \xB7 ${model}` : ""}${mode && mode !== "safe" ? ` \xB7 ${mode}` : ""}`));
+    const result = await runAgent(engine, { prompt, cwd, model, mode }, onEvent);
     if (options.json) {
       console.log(JSON.stringify({ type: "summary", ...result }));
     } else if (result.ok) {
@@ -1517,7 +1533,7 @@ program.command("doctor").description("Check squint prerequisites and engine ava
     console.log(`${status} ${engine.name}${binaryPath ? "" : pc.dim(` \u2014 install: ${engine.install}`)}`);
   }
   if (options.probe) {
-    const { runAgent: runAgent2 } = await import("./run-XHLCTF6V.js");
+    const { runAgent: runAgent2 } = await import("./run-TIGEZHMQ.js");
     console.log(pc.dim("\nprobing engines with a one-word prompt (verifies auth end to end)\u2026"));
     for (const { engine, path: binaryPath } of detected) {
       if (!binaryPath) continue;
@@ -1539,7 +1555,7 @@ program.command("doctor").description("Check squint prerequisites and engine ava
       );
     }
   }
-  const { findChrome: findChrome2 } = await import("./chrome-RD7XQ767.js");
+  const { findChrome: findChrome2 } = await import("./chrome-RV25VKUA.js");
   const { hasWebSocket } = await import("./cdp-SFWNP7OA.js");
   const chrome = findChrome2();
   console.log(
@@ -1666,7 +1682,7 @@ variantsCommand.command("gen").description("Generate n variants of one ask in pa
       process.exitCode = 1;
       return;
     }
-    const { runVariants: runVariants2, cleanVariants: cleanVariants2 } = await import("./variants-7A7723L7.js");
+    const { runVariants: runVariants2, cleanVariants: cleanVariants2 } = await import("./variants-SM6NRX4U.js");
     const config = loadConfig(defaultPaths(cwd));
     const engineId = resolveEngineId(config, options.engine);
     const engine = getEngine(engineId);
@@ -1684,7 +1700,7 @@ variantsCommand.command("gen").description("Generate n variants of one ask in pa
     );
     const succeeded = runs.filter((r) => r.result.ok);
     if (options.shots && succeeded.length > 0) {
-      const { screenshotVariants: screenshotVariants2 } = await import("./shots-LRYYMTPK.js");
+      const { screenshotVariants: screenshotVariants2 } = await import("./shots-X3I6MRLX.js");
       console.log(pc.dim("capturing screenshots\u2026"));
       const shots = await screenshotVariants2(cwd, succeeded.map((r) => r.variant));
       for (const shot of shots) {
@@ -1699,7 +1715,7 @@ ${succeeded.length}/${runs.length} variants ready in .squint/variants/ \u2014 `
   }
 );
 variantsCommand.command("list").description("List generated variants").action(async () => {
-  const { listVariants: listVariants2 } = await import("./variants-7A7723L7.js");
+  const { listVariants: listVariants2 } = await import("./variants-SM6NRX4U.js");
   const ids = listVariants2(process.cwd());
   if (ids.length === 0) {
     console.log(pc.dim('no variants \u2014 squint variants gen <n> "<ask>"'));
@@ -1708,7 +1724,7 @@ variantsCommand.command("list").description("List generated variants").action(as
   for (const id of ids) console.log(id);
 });
 variantsCommand.command("apply").description("Apply one variant\u2019s changes to the main tree and discard the rest").argument("<id>", "family id of the winning variant").action(async (id) => {
-  const { applyVariant: applyVariant2, cleanVariants: cleanVariants2 } = await import("./variants-7A7723L7.js");
+  const { applyVariant: applyVariant2, cleanVariants: cleanVariants2 } = await import("./variants-SM6NRX4U.js");
   const cwd = process.cwd();
   const result = applyVariant2(cwd, id);
   if (!result.ok) {
@@ -1720,7 +1736,7 @@ variantsCommand.command("apply").description("Apply one variant\u2019s changes t
   console.log(pc.green(`\u2713 applied ${id} to the working tree`) + pc.dim(" \u2014 review with git diff"));
 });
 variantsCommand.command("clean").description("Discard all variants").action(async () => {
-  const { cleanVariants: cleanVariants2 } = await import("./variants-7A7723L7.js");
+  const { cleanVariants: cleanVariants2 } = await import("./variants-SM6NRX4U.js");
   const count = cleanVariants2(process.cwd());
   console.log(pc.dim(`removed ${count} variant(s)`));
 });
@@ -1754,7 +1770,7 @@ program.command("brief").description("Set a committed design direction for this
   console.log(pc.dim("every squint ask in this repo now holds this direction \u2014 edit the file to remix"));
 });
 program.command("check").description("Run this project\u2019s quality gates (typecheck, lint, test, build)").action(async () => {
-  const { detectGates: detectGates2, runGates: runGates2 } = await import("./gates-I2GGQGMA.js");
+  const { detectGates: detectGates2, runGates: runGates2 } = await import("./gates-ZC67NMW3.js");
   const cwd = process.cwd();
   const gates = detectGates2(cwd);
   if (gates.length === 0) {
@@ -1770,7 +1786,7 @@ program.command("check").description("Run this project\u2019s quality gates (typ
   if (results.some((r) => !r.ok)) process.exitCode = 1;
 });
 program.command("shot").description("Screenshot a running app at mobile/tablet/desktop viewports").argument("<url>", "URL of the running app (e.g. http://localhost:5173)").action(async (url) => {
-  const { captureViewports: captureViewports2 } = await import("./preview-LZDH65ID.js");
+  const { captureViewports: captureViewports2 } = await import("./preview-ZHUQT7TJ.js");
   const result = await captureViewports2(process.cwd(), url);
   if (!result) {
     console.error(pc.red("\u2717 no Chrome/Chromium found"));
@@ -1797,11 +1813,16 @@ configCommand.command("path").description("Show config file locations").action((
   console.log(`global   ${paths.globalFile}`);
   console.log(`project  ${paths.projectFile}`);
 });
-program.action(() => {
+program.action(async () => {
   const cwd = process.cwd();
   const config = loadConfig(defaultPaths(cwd));
   const engineId = resolveEngineId(config);
   const model = resolveModel(config, engineId);
+  let theme2 = config.theme;
+  if (!theme2 && !process.env.NO_COLOR) {
+    const { detectBackground } = await import("./background-J7OQTYEC.js");
+    if (await detectBackground() === "light") theme2 = "light";
+  }
   render(
     /* @__PURE__ */ jsx4(
       App,
@@ -1815,7 +1836,7 @@ program.action(() => {
         autoCheck: config.autoCheck,
         bell: config.bell,
         budgetUsd: config.budgetUsd,
-        initialTheme: config.theme
+        initialTheme: theme2
       }
     )
   );

package/dist/{gates-I2GGQGMA.js → gates-ZC67NMW3.js}

@@ -5,7 +5,7 @@ import {
   detectGates,
   runGate,
   runGates
-} from "./chunk-DLCRYRWQ.js";
+} from "./chunk-62JNF5M2.js";
 export {
   buildGatePrompt,
   detectFastGates,

package/dist/{preview-LZDH65ID.js → preview-ZHUQT7TJ.js}

@@ -10,10 +10,10 @@ import {
   probeRuntime,
   routeShotName,
   runtimeSummary
-} from "./chunk-CIQ3OUAF.js";
+} from "./chunk-DKQ5KJD7.js";
 import "./chunk-OC6RU6XH.js";
-import "./chunk-P3V5CWH5.js";
-import "./chunk-2LRIKWBU.js";
+import "./chunk-CJXYSQNB.js";
+import "./chunk-CH4GNJCZ.js";
 export {
   VIEWPORTS,
   buildReviewPrompt,

package/dist/{run-XHLCTF6V.js → run-TIGEZHMQ.js}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   runAgent
-} from "./chunk-OTG4ZB4R.js";
-import "./chunk-2LRIKWBU.js";
+} from "./chunk-TI2R7QRL.js";
+import "./chunk-CH4GNJCZ.js";
 export {
   runAgent
 };

package/dist/shots-X3I6MRLX.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import {
+  screenshotVariants
+} from "./chunk-QNNT6FP4.js";
+import "./chunk-XLNTTZX4.js";
+import "./chunk-P3H4N2EN.js";
+import "./chunk-TI2R7QRL.js";
+import "./chunk-CJXYSQNB.js";
+import "./chunk-CH4GNJCZ.js";
+export {
+  screenshotVariants
+};

package/dist/{variants-7A7723L7.js → variants-SM6NRX4U.js}

@@ -9,10 +9,10 @@ import {
   runVariants,
   variantPrompt,
   variantsRoot
-} from "./chunk-LCS47EAG.js";
+} from "./chunk-XLNTTZX4.js";
 import "./chunk-P3H4N2EN.js";
-import "./chunk-OTG4ZB4R.js";
-import "./chunk-2LRIKWBU.js";
+import "./chunk-TI2R7QRL.js";
+import "./chunk-CH4GNJCZ.js";
 export {
   MAX_VARIANTS,
   applyVariant,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aayambansal/squint",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "Lovable for your terminal — a frontend harness on top of Claude Code, Codex, and other coding agents.",
   "type": "module",
   "license": "MIT",

package/dist/shots-LRYYMTPK.js

@@ -1,12 +0,0 @@
-#!/usr/bin/env node
-import {
-  screenshotVariants
-} from "./chunk-2IW2MMCY.js";
-import "./chunk-LCS47EAG.js";
-import "./chunk-P3H4N2EN.js";
-import "./chunk-OTG4ZB4R.js";
-import "./chunk-P3V5CWH5.js";
-import "./chunk-2LRIKWBU.js";
-export {
-  screenshotVariants
-};