Skip to content

Tayhlow8/Caixa-D-gua-website-2026 / .agents/skills/gstack

gstack

Flagged

Fast headless browser for QA testing and site dogfooding. Navigate pages, interact with elements, verify state, diff before/after, take annotated screenshots, test responsive layouts, forms, uploads, dialogs, and capture bug evidence. Use when asked to open or test a site, verify a deployment, dogfood a user flow, or file a bug with screenshots. (gstack)

FileKindSize
AGENTS.mdmarkdown2.5 KB
ARCHITECTURE.mdmarkdown29.3 KB
BROWSER.mdmarkdown29.2 KB
CHANGELOG.mdmarkdown389.3 KB
CLAUDE.mdmarkdown40.4 KB
CONTRIBUTING.mdmarkdown21.4 KB
DESIGN.mdmarkdown4.4 KB
ETHOS.mdmarkdown7.3 KB
LICENSEother1.0 KB
README.mdmarkdown37.3 KB
SKILL.mdskill md40.7 KB
SKILL.md.tmplother10.9 KB
TODOS.mdmarkdown79.0 KB
USING_GBRAIN_WITH_GSTACK.mdmarkdown19.0 KB
VERSIONother9 B
actionlint.yamlconfig56 B
agents/openai.yamlconfig351 B
bin/chrome-cdpother2.2 KB
bin/dev-setupother2.4 KB
bin/dev-teardownother1.6 KB
bin/gstack-analyticsother6.3 KB
bin/gstack-brain-consumerother5.5 KB
bin/gstack-brain-enqueueother1.9 KB
bin/gstack-brain-initother13.8 KB
bin/gstack-brain-readerother21 B
bin/gstack-brain-restoreother7.5 KB
bin/gstack-brain-syncother14.6 KB
bin/gstack-brain-uninstallother5.2 KB
bin/gstack-builder-profileother616 B
bin/gstack-codex-probeother4.5 KB
bin/gstack-community-dashboardother4.5 KB
bin/gstack-configother10.4 KB
bin/gstack-developer-profileother15.9 KB
bin/gstack-diff-scopeother3.1 KB
bin/gstack-extensionother2.0 KB
bin/gstack-gbrain-detectother3.6 KB
bin/gstack-gbrain-installother6.6 KB
bin/gstack-gbrain-lib.shscript3.4 KB
bin/gstack-gbrain-repo-policyother7.0 KB
bin/gstack-gbrain-supabase-provisionother15.2 KB
bin/gstack-gbrain-supabase-verifyother4.0 KB
bin/gstack-global-discover.tsscript18.8 KB
bin/gstack-jsonl-mergeother2.7 KB
bin/gstack-learnings-logother3.3 KB
bin/gstack-learnings-searchother4.8 KB
bin/gstack-model-benchmarkother5.8 KB
bin/gstack-next-versionother16.3 KB
bin/gstack-open-urlother338 B
bin/gstack-patch-namesother1.2 KB
bin/gstack-platform-detectother1.0 KB
bin/gstack-question-logother6.4 KB
bin/gstack-question-preferenceother9.4 KB
bin/gstack-relinkother3.0 KB
bin/gstack-repo-modeother3.5 KB
bin/gstack-review-logother866 B
bin/gstack-review-readother528 B
bin/gstack-security-dashboardother4.9 KB
bin/gstack-session-updateother3.5 KB
bin/gstack-settings-hookother2.8 KB
bin/gstack-slugother1.9 KB
bin/gstack-specialist-statsother2.2 KB
bin/gstack-taste-updateother10.5 KB
bin/gstack-team-initother6.7 KB
bin/gstack-telemetry-logother10.0 KB
bin/gstack-telemetry-syncother5.3 KB
bin/gstack-timeline-logother1.6 KB
bin/gstack-timeline-readother2.6 KB
bin/gstack-uninstallother10.3 KB
bin/gstack-update-checkother7.7 KB
bun.lockother57.4 KB
claude/SKILL.md.tmplother8.7 KB
conductor.jsonconfig87 B
connect-chromeother19 B
contrib/add-host/SKILL.md.tmplother1.7 KB
design/prototype.tsscript5.4 KB
design/src/auth.tsscript1.7 KB
design/src/brief.tsscript1.9 KB
design/src/check.tsscript3.3 KB
design/src/cli.tsscript8.9 KB
design/src/commands.tsscript3.0 KB
design/src/compare.tsscript19.1 KB
design/src/design-to-code.tsscript3.0 KB
design/src/diff.tsscript3.3 KB
design/src/evolve.tsscript5.3 KB
design/src/gallery.tsscript7.0 KB
design/src/generate.tsscript4.4 KB
design/src/iterate.tsscript6.5 KB
design/src/memory.tsscript6.0 KB
design/src/serve.tsscript8.3 KB
design/src/session.tsscript1.8 KB
design/src/variants.tsscript8.7 KB
design/test/feedback-roundtrip.test.tsscript12.6 KB
design/test/gallery.test.tsscript5.0 KB
design/test/serve.test.tsscript16.0 KB
docs/ADDING_A_HOST.mdmarkdown6.1 KB
docs/ON_THE_LOC_CONTROVERSY.mdmarkdown13.2 KB
docs/OPENCLAW.mdmarkdown6.5 KB
docs/REMOTE_BROWSER_ACCESS.mdmarkdown9.6 KB
docs/designs/BUN_NATIVE_INFERENCE.mdmarkdown6.7 KB
docs/designs/CHROME_VS_CHROMIUM_EXPLORATION.mdmarkdown4.0 KB
docs/designs/CONDUCTOR_CHROME_SIDEBAR_INTEGRATION.mdmarkdown3.5 KB
docs/designs/CONDUCTOR_SESSION_API.mdmarkdown3.9 KB
docs/designs/DESIGN_SHOTGUN.mdmarkdown22.5 KB
docs/designs/DESIGN_TOOLS_V1.mdmarkdown36.0 KB
docs/designs/GCOMPACTION.mdmarkdown57.6 KB
docs/designs/GSTACK_BROWSER_V0.mdmarkdown17.3 KB
docs/designs/ML_PROMPT_INJECTION_KILLER.mdmarkdown20.7 KB
docs/designs/PACING_UPDATES_V0.mdmarkdown9.7 KB
docs/designs/PLAN_TUNING_V0.mdmarkdown31.2 KB
docs/designs/PLAN_TUNING_V1.mdmarkdown19.0 KB
docs/designs/SELF_LEARNING_V0.mdmarkdown15.4 KB
docs/designs/SESSION_INTELLIGENCE.mdmarkdown6.8 KB
docs/designs/SIDEBAR_MESSAGE_FLOW.mdmarkdown10.1 KB
docs/designs/SLATE_HOST.mdmarkdown12.6 KB
docs/designs/SLOP_SCAN_FOR_REVIEW_SHIP.mdmarkdown3.0 KB
docs/evals/security-bench-ensemble-v2.jsonconfig1.6 KB
docs/gbrain-sync-errors.mdmarkdown6.2 KB
docs/gbrain-sync.mdmarkdown6.5 KB
docs/images/github-2013.pngbinary61.9 KB
docs/images/github-2026.pngbinary59.1 KB
docs/skills.mdmarkdown59.5 KB
extension/background.jsscript20.6 KB
extension/content.cssother2.5 KB
extension/content.jsscript11.9 KB
extension/icons/icon-128.pngbinary2.8 KB
extension/icons/icon-16.pngbinary400 B
extension/icons/icon-48.pngbinary1.1 KB
extension/inspector.cssother798 B
extension/inspector.jsscript15.7 KB
extension/lib/xterm-addon-fit.jsscript1.5 KB
extension/lib/xterm.cssother5.3 KB
extension/lib/xterm.jsscript276.8 KB
extension/manifest.jsonconfig783 B
extension/popup.htmlother2.3 KB
extension/popup.jsscript1.7 KB
extension/sidepanel-terminal.jsscript15.2 KB
extension/sidepanel.cssother39.6 KB
extension/sidepanel.htmlother9.1 KB
extension/sidepanel.jsscript40.2 KB
hosts/claude.tsscript1.1 KB
hosts/codex.tsscript2.2 KB
hosts/cursor.tsscript1.1 KB
hosts/factory.tsscript1.8 KB
hosts/gbrain.tsscript2.2 KB
hosts/hermes.tsscript2.1 KB
hosts/index.tsscript2.2 KB
hosts/kiro.tsscript1.2 KB
hosts/openclaw.tsscript2.0 KB
hosts/opencode.tsscript1.3 KB
hosts/slate.tsscript1.1 KB
lib/worktree.tsscript9.6 KB
model-overlays/claude.mdmarkdown613 B
model-overlays/gemini.mdmarkdown551 B
model-overlays/gpt-5.4.mdmarkdown683 B
model-overlays/gpt.mdmarkdown1.9 KB
model-overlays/o-series.mdmarkdown660 B
model-overlays/opus-4-7.mdmarkdown1.5 KB
openclaw/agents-gstack-section.mdmarkdown2.5 KB
openclaw/gstack-full-CLAUDE.mdmarkdown538 B
openclaw/gstack-lite-CLAUDE.mdmarkdown688 B
openclaw/gstack-plan-CLAUDE.mdmarkdown1.0 KB
package.jsonmanifest4.7 KB
scripts/analytics.tsscript5.3 KB
scripts/app/gstack-browserother2.4 KB
scripts/app/icon.icnsother1.0 MB
scripts/archetypes.tsscript5.4 KB
scripts/build-app.shscript7.5 KB
scripts/compare-pr-version.tsscript3.0 KB
scripts/detect-bump.tsscript1.2 KB
scripts/dev-skill.tsscript2.4 KB
scripts/discover-skills.tsscript1.2 KB
scripts/eval-compare.tsscript3.0 KB
scripts/eval-list.tsscript3.5 KB
scripts/eval-select.tsscript3.1 KB
scripts/eval-summary.tsscript6.5 KB
scripts/eval-watch.tsscript5.4 KB
scripts/garry-output-comparison.tsscript17.0 KB
scripts/gen-skill-docs.tsscript28.3 KB
scripts/host-adapters/openclaw-adapter.tsscript1.7 KB
scripts/host-config-export.tsscript3.4 KB
scripts/host-config.tsscript7.3 KB
scripts/jargon-list.jsonconfig1.8 KB
scripts/models.tsscript2.5 KB
scripts/one-way-doors.tsscript5.6 KB
scripts/preflight-agent-sdk.tsscript4.4 KB
scripts/psychographic-signals.tsscript10.3 KB
scripts/question-registry.tsscript23.5 KB
scripts/resolvers/browse.tsscript6.2 KB
scripts/resolvers/codex-helpers.tsscript5.0 KB
scripts/resolvers/composition.tsscript1.8 KB
scripts/resolvers/confidence.tsscript1.6 KB
scripts/resolvers/constants.tsscript3.1 KB
scripts/resolvers/design.tsscript56.9 KB
scripts/resolvers/dx.tsscript5.4 KB
scripts/resolvers/gbrain.tsscript5.3 KB
scripts/resolvers/index.tsscript4.3 KB
scripts/resolvers/learnings.tsscript3.9 KB
scripts/resolvers/make-pdf.tsscript2.2 KB
scripts/resolvers/model-overlay.tsscript2.2 KB
scripts/resolvers/preamble.tsscript5.7 KB

design/src/cli.ts

View on GitHub
/**
 * gstack design CLI — stateless CLI for AI-powered design generation.
 *
 * Unlike the browse binary (persistent Chromium daemon), the design binary
 * is stateless: each invocation makes API calls and writes files. Session
 * state for multi-turn iteration is a JSON file in /tmp.
 *
 * Flow:
 *   1. Parse command + flags from argv
 *   2. Resolve auth (~/. gstack/openai.json → OPENAI_API_KEY → guided setup)
 *   3. Execute command (API call → write PNG/HTML)
 *   4. Print result JSON to stdout
 */

import { COMMANDS } from "./commands";
import { generate } from "./generate";
import { checkCommand } from "./check";
import { compare } from "./compare";
import { variants } from "./variants";
import { iterate } from "./iterate";
import { resolveApiKey, saveApiKey } from "./auth";
import { extractDesignLanguage, updateDesignMd } from "./memory";
import { diffMockups, verifyAgainstMockup } from "./diff";
import { evolve } from "./evolve";
import { generateDesignToCodePrompt } from "./design-to-code";
import { serve } from "./serve";
import { gallery } from "./gallery";

function parseArgs(argv: string[]): { command: string; flags: Record<string, string | boolean> } {
  const args = argv.slice(2); // skip bun/node and script path
  if (args.length === 0) {
    printUsage();
    process.exit(0);
  }

  const command = args[0];
  const flags: Record<string, string | boolean> = {};

  for (let i = 1; i < args.length; i++) {
    const arg = args[i];
    if (arg.startsWith("--")) {
      const key = arg.slice(2);
      const next = args[i + 1];
      if (next && !next.startsWith("--")) {
        flags[key] = next;
        i++;
      } else {
        flags[key] = true;
      }
    }
  }

  return { command, flags };
}

function printUsage(): void {
  console.log("gstack design — AI-powered UI mockup generation\n");
  console.log("Commands:");
  for (const [name, info] of COMMANDS) {
    console.log(`  ${name.padEnd(12)} ${info.description}`);
    console.log(`  ${"".padEnd(12)} ${info.usage}`);
  }
  console.log("\nAuth: ~/.gstack/openai.json or OPENAI_API_KEY env var");
  console.log("Setup: $D setup");
}

async function runSetup(): Promise<void> {
  const existing = resolveApiKey();
  if (existing) {
    console.log("Existing API key found. Running smoke test...");
  } else {
    console.log("No API key found. Please enter your OpenAI API key.");
    console.log("Get one at: https://platform.openai.com/api-keys");
    console.log("(Needs image generation permissions)\n");

    // Read from stdin
    process.stdout.write("API key: ");
    const reader = Bun.stdin.stream().getReader();
    const { value } = await reader.read();
    reader.releaseLock();
    const key = new TextDecoder().decode(value).trim();

    if (!key || !key.startsWith("sk-")) {
      console.error("Invalid key. Must start with 'sk-'.");
      process.exit(1);
    }

    saveApiKey(key);
    console.log("Key saved to ~/.gstack/openai.json (0600 permissions).");
  }

  // Smoke test
  console.log("\nRunning smoke test (generating a simple image)...");
  try {
    await generate({
      brief: "A simple blue square centered on a white background. Minimal, geometric, clean.",
      output: "/tmp/gstack-design-smoke-test.png",
      size: "1024x1024",
      quality: "low",
    });
    console.log("\nSmoke test PASSED. Design generation is working.");
  } catch (err: any) {
    console.error(`\nSmoke test FAILED: ${err.message}`);
    console.error("Check your API key and organization verification status.");
    process.exit(1);
  }
}

async function main(): Promise<void> {
  const { command, flags } = parseArgs(process.argv);

  if (!COMMANDS.has(command)) {
    console.error(`Unknown command: ${command}`);
    printUsage();
    process.exit(1);
  }

  switch (command) {
    case "generate":
      await generate({
        brief: flags.brief as string,
        briefFile: flags["brief-file"] as string,
        output: (flags.output as string) || "/tmp/gstack-mockup.png",
        check: !!flags.check,
        retry: flags.retry ? parseInt(flags.retry as string) : 0,
        size: flags.size as string,
        quality: flags.quality as string,
      });
      break;

    case "check":
      await checkCommand(flags.image as string, flags.brief as string);
      break;

    case "compare": {
      // Parse --images as glob or multiple files
      const imagesArg = flags.images as string;
      const images = await resolveImagePaths(imagesArg);
      const outputPath = (flags.output as string) || "/tmp/gstack-design-board.html";
      compare({ images, output: outputPath });
      // If --serve flag is set, start HTTP server for the board
      if (flags.serve) {
        await serve({
          html: outputPath,
          timeout: flags.timeout ? parseInt(flags.timeout as string) : 600,
        });
      }
      break;
    }

    case "prompt": {
      const promptImage = flags.image as string;
      if (!promptImage) {
        console.error("--image is required");
        process.exit(1);
      }
      console.error(`Generating implementation prompt from ${promptImage}...`);
      const proc2 = Bun.spawn(["git", "rev-parse", "--show-toplevel"]);
      const root = (await new Response(proc2.stdout).text()).trim();
      const d2c = await generateDesignToCodePrompt(promptImage, root || undefined);
      console.log(JSON.stringify(d2c, null, 2));
      break;
    }

    case "setup":
      await runSetup();
      break;

    case "variants":
      await variants({
        brief: flags.brief as string,
        briefFile: flags["brief-file"] as string,
        count: flags.count ? parseInt(flags.count as string) : 3,
        outputDir: (flags["output-dir"] as string) || "/tmp/gstack-variants/",
        size: flags.size as string,
        quality: flags.quality as string,
        viewports: flags.viewports as string,
      });
      break;

    case "iterate":
      await iterate({
        session: flags.session as string,
        feedback: flags.feedback as string,
        output: (flags.output as string) || "/tmp/gstack-iterate.png",
      });
      break;

    case "extract": {
      const imagePath = flags.image as string;
      if (!imagePath) {
        console.error("--image is required");
        process.exit(1);
      }
      console.error(`Extracting design language from ${imagePath}...`);
      const extracted = await extractDesignLanguage(imagePath);
      const proc = Bun.spawn(["git", "rev-parse", "--show-toplevel"]);
      const repoRoot = (await new Response(proc.stdout).text()).trim();
      if (repoRoot) {
        updateDesignMd(repoRoot, extracted, imagePath);
      }
      console.log(JSON.stringify(extracted, null, 2));
      break;
    }

    case "diff": {
      const before = flags.before as string;
      const after = flags.after as string;
      if (!before || !after) {
        console.error("--before and --after are required");
        process.exit(1);
      }
      console.error(`Comparing ${before} vs ${after}...`);
      const diffResult = await diffMockups(before, after);
      console.log(JSON.stringify(diffResult, null, 2));
      break;
    }

    case "verify": {
      const mockup = flags.mockup as string;
      const screenshot = flags.screenshot as string;
      if (!mockup || !screenshot) {
        console.error("--mockup and --screenshot are required");
        process.exit(1);
      }
      console.error(`Verifying implementation against approved mockup...`);
      const verifyResult = await verifyAgainstMockup(mockup, screenshot);
      console.error(`Match: ${verifyResult.matchScore}/100 — ${verifyResult.pass ? "PASS" : "FAIL"}`);
      console.log(JSON.stringify(verifyResult, null, 2));
      break;
    }

    case "evolve":
      await evolve({
        screenshot: flags.screenshot as string,
        brief: flags.brief as string,
        output: (flags.output as string) || "/tmp/gstack-evolved.png",
      });
      break;

    case "gallery":
      gallery({
        designsDir: flags["designs-dir"] as string,
        output: (flags.output as string) || "/tmp/gstack-design-gallery.html",
      });
      break;

    case "serve":
      await serve({
        html: flags.html as string,
        timeout: flags.timeout ? parseInt(flags.timeout as string) : 600,
      });
      break;
  }
}

/**
 * Resolve image paths from a glob pattern or comma-separated list.
 */
async function resolveImagePaths(input: string): Promise<string[]> {
  if (!input) {
    console.error("--images is required. Provide glob pattern or comma-separated paths.");
    process.exit(1);
  }

  // Check if it's a glob pattern
  if (input.includes("*")) {
    const glob = new Bun.Glob(input);
    const paths: string[] = [];
    for await (const match of glob.scan({ absolute: true })) {
      if (match.endsWith(".png") || match.endsWith(".jpg") || match.endsWith(".jpeg")) {
        paths.push(match);
      }
    }
    return paths.sort();
  }

  // Comma-separated or single path
  return input.split(",").map(p => p.trim());
}

main().catch(err => {
  console.error(err.message || err);
  process.exit(1);
});
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall