pixelmuse 0.2.1 → 0.4.0

package/README.md

@@ -31,15 +31,12 @@
 
 ## Get Started
 
-The fastest way to start generating images is with npm — one install, one login, and you're creating:
-
 ```bash
 npm install -g pixelmuse
-pixelmuse login
-pixelmuse "a cat floating through space"
+pixelmuse setup
 ```
 
-Sign up at [pixelmuse.studio/sign-up](https://www.pixelmuse.studio/sign-up) — new accounts include **15 free credits**.
+The setup wizard creates your account (opens browser), configures your API key, and optionally sets up the MCP server for Claude Code, Cursor, or Windsurf. New accounts include **15 free credits**.
 
 > Requires Node.js 20+. For terminal image previews, install [chafa](https://hpjansson.org/chafa/) (`brew install chafa` / `sudo apt install chafa`).
 
@@ -210,6 +207,7 @@ Pixelmuse ships four interfaces. Pick the one that fits your workflow — they a
 
 | Command | Description |
 |---------|-------------|
+| `pixelmuse setup` | First-time setup wizard (account, MCP, defaults) |
 | `pixelmuse "prompt"` | Generate an image (default command) |
 | `pixelmuse models` | List available models with costs |
 | `pixelmuse account` | Account balance and usage stats |

package/dist/{chunk-MZZY4JXW.js → chunk-M4N6UFDD.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   PATHS
-} from "./chunk-7ARYEFAH.js";
+} from "./chunk-PSHBBAJV.js";
 
 // src/core/image.ts
 import { execSync } from "child_process";

package/dist/{chunk-7ARYEFAH.js → chunk-PSHBBAJV.js}

@@ -18,6 +18,7 @@ var DEFAULT_SETTINGS = {
   defaultModel: "nano-banana-2",
   defaultAspectRatio: "1:1",
   defaultStyle: "none",
+  defaultVisibility: "private",
   autoPreview: true,
   autoSave: true
 };

package/dist/{chunk-3BR2BNXV.js → chunk-Q5SB7WKR.js}

@@ -2,7 +2,7 @@
 import {
   PATHS,
   ensureDirs
-} from "./chunk-7ARYEFAH.js";
+} from "./chunk-PSHBBAJV.js";
 
 // src/core/types.ts
 var ApiError = class extends Error {
@@ -17,7 +17,7 @@ var ApiError = class extends Error {
 };
 
 // src/core/client.ts
-var CLI_VERSION = "0.2.1";
+var CLI_VERSION = "0.4.0";
 var BASE_URL = "https://www.pixelmuse.studio/api/v1";
 var CLIENT_HEADERS = {
   "User-Agent": `pixelmuse-cli/${CLI_VERSION}`,

package/dist/{chunk-LOW6S5UO.js → chunk-STJDWR4Q.js}

@@ -2,12 +2,12 @@
 import {
   pollGeneration,
   slugify
-} from "./chunk-3BR2BNXV.js";
+} from "./chunk-Q5SB7WKR.js";
 import {
   autoSave,
   imageToBuffer,
   saveImage
-} from "./chunk-MZZY4JXW.js";
+} from "./chunk-M4N6UFDD.js";
 
 // src/core/generate.ts
 import { existsSync } from "fs";
@@ -29,6 +29,7 @@ async function generateImage(client, options) {
     model = "nano-banana-2",
     aspectRatio = "1:1",
     style,
+    visibility,
     output,
     noSave = false,
     onProgress
@@ -38,7 +39,8 @@ async function generateImage(client, options) {
     prompt,
     model,
     aspect_ratio: aspectRatio,
-    style: style === "none" ? void 0 : style
+    style: style === "none" ? void 0 : style,
+    visibility
   });
   if (gen.status === "processing" || gen.status === "pending") {
     gen = await pollGeneration(client, gen.id, { onProgress });

package/dist/cli.js

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
 import {
   generateImage
-} from "./chunk-LOW6S5UO.js";
+} from "./chunk-STJDWR4Q.js";
 import {
+  CLI_VERSION,
   PixelmuseClient,
   deleteApiKey,
   extractVariables,
@@ -14,19 +15,20 @@ import {
   saveApiKey,
   saveTemplate,
   slugify
-} from "./chunk-3BR2BNXV.js";
+} from "./chunk-Q5SB7WKR.js";
 import {
   renderImageDirect
-} from "./chunk-MZZY4JXW.js";
+} from "./chunk-M4N6UFDD.js";
 import {
-  readSettings
-} from "./chunk-7ARYEFAH.js";
+  readSettings,
+  writeSettings
+} from "./chunk-PSHBBAJV.js";
 
 // src/cli.ts
 import meow from "meow";
 import chalk from "chalk";
 import ora from "ora";
-import { readFileSync, watchFile, unwatchFile } from "fs";
+import { readFileSync as readFileSync2, watchFile, unwatchFile } from "fs";
 import { resolve } from "path";
 
 // src/core/utils.ts
@@ -39,6 +41,128 @@ function timeAgo(date) {
   return date.toLocaleDateString();
 }
 
+// src/core/device-auth.ts
+var BASE_URL = "https://www.pixelmuse.studio/api/v1";
+async function initiateDeviceAuth() {
+  const res = await fetch(`${BASE_URL}/auth/device`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "User-Agent": `pixelmuse-cli/${CLI_VERSION}`
+    },
+    body: JSON.stringify({
+      client_info: {
+        platform: process.platform,
+        cli_version: CLI_VERSION
+      }
+    })
+  });
+  if (!res.ok) {
+    const body = await res.text().catch(() => "");
+    throw new Error(`Failed to initiate device auth (HTTP ${res.status}): ${body}`);
+  }
+  const data = await res.json();
+  return {
+    deviceCode: data.device_code,
+    userCode: data.user_code,
+    verificationUri: data.verification_uri,
+    verificationUriComplete: data.verification_uri_complete,
+    expiresIn: data.expires_in,
+    interval: data.interval
+  };
+}
+async function pollForToken(deviceCode, options) {
+  const deadline = Date.now() + options.expiresIn * 1e3;
+  let intervalMs = options.interval * 1e3;
+  while (Date.now() < deadline) {
+    await new Promise((r) => setTimeout(r, intervalMs));
+    options.onPoll?.();
+    try {
+      const res = await fetch(`${BASE_URL}/auth/device/token`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "User-Agent": `pixelmuse-cli/${CLI_VERSION}`
+        },
+        body: JSON.stringify({
+          device_code: deviceCode,
+          grant_type: "urn:ietf:params:oauth:grant-type:device_code"
+        })
+      });
+      const data = await res.json();
+      if (data.api_key) {
+        return {
+          apiKey: data.api_key,
+          keyPrefix: data.key_prefix
+        };
+      }
+      if (data.error === "slow_down") {
+        intervalMs = (data.interval ?? 10) * 1e3;
+        continue;
+      }
+      if (data.error === "expired_token") {
+        throw new Error("Authorization timed out. Run `pixelmuse setup` to try again.");
+      }
+      if (data.error === "access_denied") {
+        throw new Error("Authorization was denied.");
+      }
+    } catch (err) {
+      if (err instanceof Error && (err.message.includes("timed out") || err.message.includes("denied"))) {
+        throw err;
+      }
+    }
+  }
+  throw new Error("Authorization timed out. Run `pixelmuse setup` to try again.");
+}
+
+// src/core/mcp-config.ts
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
+import { dirname, join } from "path";
+import { homedir } from "os";
+var HOME = homedir();
+var EDITORS = [
+  {
+    name: "Claude Code",
+    id: "claude-code",
+    configPath: join(HOME, ".claude", "mcp.json")
+  },
+  {
+    name: "Cursor",
+    id: "cursor",
+    configPath: join(HOME, ".cursor", "mcp.json")
+  },
+  {
+    name: "Windsurf",
+    id: "windsurf",
+    configPath: join(HOME, ".codeium", "windsurf", "mcp_config.json")
+  }
+];
+function detectEditors() {
+  return EDITORS.map((editor) => ({
+    ...editor,
+    installed: existsSync(dirname(editor.configPath))
+  }));
+}
+function configureMcp(editor, apiKey) {
+  const entry = {
+    command: "npx",
+    args: ["-y", "pixelmuse-mcp"],
+    env: { PIXELMUSE_API_KEY: apiKey }
+  };
+  let config = {};
+  if (existsSync(editor.configPath)) {
+    try {
+      config = JSON.parse(readFileSync(editor.configPath, "utf-8"));
+    } catch {
+    }
+  } else {
+    mkdirSync(dirname(editor.configPath), { recursive: true });
+  }
+  config.mcpServers = config.mcpServers ?? {};
+  config.mcpServers.pixelmuse = entry;
+  writeFileSync(editor.configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+}
+
 // src/cli.ts
 var cli = meow(
   `
@@ -50,6 +174,7 @@ var cli = meow(
     $ echo "prompt" | pixelmuse             Pipe from stdin
 
   ${chalk.bold("Commands")}
+    pixelmuse setup                          First-time setup wizard
     pixelmuse models                         List available models
     pixelmuse account                        View balance & usage
     pixelmuse history                        Recent generations
@@ -68,6 +193,7 @@ var cli = meow(
     --no-preview         Skip image preview
     --open               Open result in system viewer
     --watch <file>       Watch a prompt file and regenerate on save
+    --public             Make image public (default: private)
     --no-save            Don't save image to disk
     --clipboard          Copy image to clipboard
     -h, --help           Show this help
@@ -90,6 +216,7 @@ var cli = meow(
       preview: { type: "boolean", default: true },
       open: { type: "boolean", default: false },
       watch: { type: "string" },
+      public: { type: "boolean", default: false },
       save: { type: "boolean", default: true },
       clipboard: { type: "boolean", default: false },
       var: { type: "string", isMultiple: true }
@@ -132,6 +259,7 @@ async function handleGenerate(prompt) {
   const model = cli.flags.model ?? settings.defaultModel;
   const aspectRatio = cli.flags.aspectRatio ?? settings.defaultAspectRatio;
   const style = cli.flags.style ?? settings.defaultStyle;
+  const visibility = cli.flags.public ? "public" : settings.defaultVisibility;
   let balance = null;
   let creditCost = null;
   try {
@@ -150,6 +278,7 @@ async function handleGenerate(prompt) {
         model,
         aspectRatio,
         style,
+        visibility,
         output: cli.flags.output,
         noSave: !cli.flags.save
       });
@@ -160,6 +289,7 @@ async function handleGenerate(prompt) {
           model: result.generation.model,
           prompt: result.generation.prompt,
           credits_charged: result.generation.credits_charged,
+          visibility: result.generation.visibility,
           elapsed_seconds: Math.round(result.elapsed * 10) / 10,
           output_path: result.imagePath
         })
@@ -179,6 +309,7 @@ async function handleGenerate(prompt) {
       model,
       aspectRatio,
       style,
+      visibility,
       output: cli.flags.output,
       noSave: !cli.flags.save,
       onProgress: (elapsed) => {
@@ -188,8 +319,9 @@ async function handleGenerate(prompt) {
     const charged = result.generation.credits_charged;
     const remaining = balance !== null ? balance - charged : null;
     const remainStr = remaining !== null ? ` (remaining: ${remaining})` : "";
+    const visLabel = result.generation.visibility === "public" ? chalk.green("public") : chalk.gray("private");
     spinner.succeed(
-      `Generated in ${result.elapsed.toFixed(1)}s \xB7 ${charged} credit${charged > 1 ? "s" : ""} charged${remainStr}`
+      `Generated in ${result.elapsed.toFixed(1)}s \xB7 ${charged} credit${charged > 1 ? "s" : ""} charged${remainStr} \xB7 ${visLabel}`
     );
     if (result.imagePath) {
       console.log(chalk.gray(`  Saved to ${result.imagePath}`));
@@ -220,7 +352,7 @@ async function handleWatch(filePath) {
   const generate = async () => {
     if (generating) return;
     generating = true;
-    const prompt = readFileSync(absPath, "utf-8").trim();
+    const prompt = readFileSync2(absPath, "utf-8").trim();
     if (!prompt) {
       generating = false;
       return;
@@ -228,6 +360,7 @@ async function handleWatch(filePath) {
     const model = cli.flags.model ?? settings.defaultModel;
     const aspectRatio = cli.flags.aspectRatio ?? settings.defaultAspectRatio;
     const style = cli.flags.style ?? settings.defaultStyle;
+    const watchVisibility = cli.flags.public ? "public" : settings.defaultVisibility;
     const time = (/* @__PURE__ */ new Date()).toLocaleTimeString("en-US", { hour12: false });
     const spinner = ora(`[${time}] Generating... (${model})`).start();
     try {
@@ -236,6 +369,7 @@ async function handleWatch(filePath) {
         model,
         aspectRatio,
         style,
+        visibility: watchVisibility,
         output: cli.flags.output
       });
       spinner.succeed(`[${time}] Saved to ${result.imagePath} (${result.elapsed.toFixed(1)}s)`);
@@ -315,8 +449,9 @@ async function handleHistory() {
       const prompt = gen.prompt.length > 30 ? gen.prompt.slice(0, 30) + "..." : gen.prompt;
       const date = timeAgo(new Date(gen.created_at));
       const status = gen.status === "succeeded" ? chalk.green("\u25CF") : gen.status === "failed" ? chalk.red("\u2717") : chalk.yellow("\u25CC");
+      const vis = gen.visibility === "private" ? chalk.gray(" \u{1F512}") : "";
       console.log(
-        chalk.gray(id.padEnd(idW)) + `${status} ${gen.model}`.padEnd(modelW + status.length - 1) + prompt.padEnd(promptW) + chalk.gray(date)
+        chalk.gray(id.padEnd(idW)) + `${status} ${gen.model}${vis}`.padEnd(modelW + status.length - 1 + vis.length) + prompt.padEnd(promptW) + chalk.gray(date)
       );
     }
   } catch (err) {
@@ -331,11 +466,11 @@ async function handleOpen(id) {
     const gen = await client.getGeneration(id);
     spinner.stop();
     if (gen.output?.[0]) {
-      const { imageToBuffer: imageToBuffer2, saveImage: saveImage2 } = await import("./image-2H3GUQI6.js");
-      const { PATHS: PATHS2 } = await import("./config-RMVFR3GN.js");
-      const { join } = await import("path");
+      const { imageToBuffer: imageToBuffer2, saveImage: saveImage2 } = await import("./image-GQSNVWNN.js");
+      const { PATHS: PATHS2 } = await import("./config-Z76UJLDX.js");
+      const { join: join2 } = await import("path");
       const buf = await imageToBuffer2(gen.output[0]);
-      const path = join(PATHS2.generations, `${gen.id}.png`);
+      const path = join2(PATHS2.generations, `${gen.id}.png`);
       saveImage2(buf, path);
       const { default: open } = await import("open");
       await open(path);
@@ -349,10 +484,53 @@ async function handleOpen(id) {
   }
 }
 async function handleLogin() {
+  console.log(chalk.bold("Pixelmuse Login"));
+  console.log();
+  const spinner = ora("Preparing login...").start();
+  try {
+    const init = await initiateDeviceAuth();
+    spinner.stop();
+    console.log(`  Your code: ${chalk.bold.cyan(init.userCode)}`);
+    console.log();
+    console.log(`  Opening ${chalk.underline(init.verificationUriComplete)}`);
+    console.log(`  ${chalk.gray("Or visit")} ${chalk.underline(init.verificationUri)} ${chalk.gray("and enter the code manually")}`);
+    console.log();
+    const { default: open } = await import("open");
+    await open(init.verificationUriComplete);
+    const pollSpinner = ora("Waiting for authorization...").start();
+    let dots = 0;
+    const result = await pollForToken(init.deviceCode, {
+      interval: init.interval,
+      expiresIn: init.expiresIn,
+      onPoll: () => {
+        dots = (dots + 1) % 4;
+        pollSpinner.text = `Waiting for authorization${".".repeat(dots)}`;
+      }
+    });
+    await saveApiKey(result.apiKey);
+    pollSpinner.stop();
+    const client = new PixelmuseClient(result.apiKey);
+    const account = await client.getAccount();
+    console.log(chalk.green("\u2713") + ` Authenticated as ${chalk.bold(account.email)} (${chalk.green(`${account.credits.total} credits`)})`);
+    return result.apiKey;
+  } catch (err) {
+    spinner.stop();
+    if (err instanceof Error && !err.message.includes("timed out") && !err.message.includes("denied")) {
+      console.log(chalk.gray("Browser login unavailable. Enter your API key manually."));
+    } else if (err instanceof Error) {
+      console.log(chalk.yellow(err.message));
+    }
+    return handleManualLogin();
+  }
+}
+async function handleManualLogin() {
+  console.log();
+  console.log(`  Get your key at: ${chalk.underline("https://www.pixelmuse.studio/settings/api-keys")}`);
+  console.log();
   const { createInterface } = await import("readline");
   const rl = createInterface({ input: process.stdin, output: process.stdout });
   const key = await new Promise((resolve2) => {
-    rl.question("API key (from pixelmuse.studio/settings/api-keys): ", (answer) => {
+    rl.question("API key: ", (answer) => {
       rl.close();
       resolve2(answer.trim());
     });
@@ -367,11 +545,103 @@ async function handleLogin() {
     const account = await client.getAccount();
     await saveApiKey(key);
     spinner.succeed(`Authenticated as ${chalk.bold(account.email)} (${chalk.green(`${account.credits.total} credits`)})`);
+    return key;
   } catch (err) {
     spinner.fail(err instanceof Error ? err.message : "Authentication failed");
     process.exit(1);
   }
 }
+async function handleSetup() {
+  console.log();
+  console.log(chalk.bold("  Pixelmuse Setup"));
+  console.log(chalk.gray("  AI image generation from the terminal"));
+  console.log();
+  const existingKey = await getApiKey();
+  let apiKey;
+  if (existingKey) {
+    const spinner = ora("Checking existing credentials...").start();
+    try {
+      const client = new PixelmuseClient(existingKey);
+      const account = await client.getAccount();
+      spinner.succeed(`Already authenticated as ${chalk.bold(account.email)} (${chalk.green(`${account.credits.total} credits`)})`);
+      apiKey = existingKey;
+    } catch {
+      spinner.warn("Existing credentials invalid. Re-authenticating...");
+      apiKey = await handleLogin();
+    }
+  } else {
+    console.log(chalk.bold("Step 1:") + " Authenticate");
+    console.log();
+    apiKey = await handleLogin();
+  }
+  console.log();
+  const editors = detectEditors();
+  const available = editors.filter((e) => e.installed);
+  if (available.length > 0) {
+    console.log(chalk.bold("Step 2:") + " MCP Server (AI agent integration)");
+    console.log();
+    const { createInterface } = await import("readline");
+    for (const editor of available) {
+      const rl2 = createInterface({ input: process.stdin, output: process.stdout });
+      const answer = await new Promise((resolve2) => {
+        rl2.question(`  Configure ${chalk.bold(editor.name)}? ${chalk.gray("[Y/n]")} `, (a) => {
+          rl2.close();
+          resolve2(a.trim().toLowerCase());
+        });
+      });
+      if (answer === "" || answer === "y" || answer === "yes") {
+        configureMcp(editor, apiKey);
+        console.log(chalk.green("  \u2713") + ` ${editor.name} MCP configured`);
+      } else {
+        console.log(chalk.gray(`  Skipped ${editor.name}`));
+      }
+    }
+    console.log();
+  }
+  console.log(chalk.bold(available.length > 0 ? "Step 3:" : "Step 2:") + " Defaults");
+  console.log();
+  const { createInterface: createRl } = await import("readline");
+  const rl = createRl({ input: process.stdin, output: process.stdout });
+  const customize = await new Promise((resolve2) => {
+    rl.question(`  Customize default model and settings? ${chalk.gray("[y/N]")} `, (a) => {
+      rl.close();
+      resolve2(a.trim().toLowerCase());
+    });
+  });
+  if (customize === "y" || customize === "yes") {
+    const settings = readSettings();
+    const updated = {};
+    const models = ["nano-banana-2", "nano-banana-pro", "flux-schnell", "imagen-3", "recraft-v4", "recraft-v4-pro"];
+    const aspects = ["1:1", "16:9", "9:16", "4:3", "3:4", "21:9"];
+    const styles = ["none", "realistic", "anime", "artistic"];
+    const pick = async (label, options, current) => {
+      const { createInterface } = await import("readline");
+      const rl2 = createInterface({ input: process.stdin, output: process.stdout });
+      console.log(`  ${label}: ${options.map((o) => o === current ? chalk.bold.cyan(o) : chalk.gray(o)).join(" | ")}`);
+      const answer = await new Promise((resolve2) => {
+        rl2.question(`  Choice ${chalk.gray(`[${current}]`)}: `, (a) => {
+          rl2.close();
+          resolve2(a.trim() || current);
+        });
+      });
+      return options.includes(answer) ? answer : current;
+    };
+    updated.defaultModel = await pick("Model", models, settings.defaultModel);
+    updated.defaultAspectRatio = await pick("Aspect ratio", aspects, settings.defaultAspectRatio);
+    updated.defaultStyle = await pick("Style", styles, settings.defaultStyle);
+    writeSettings({ ...settings, ...updated });
+    console.log(chalk.green("  \u2713") + " Defaults saved");
+  } else {
+    console.log(chalk.gray("  Using defaults (nano-banana-2, 1:1, no style)"));
+  }
+  console.log();
+  console.log(chalk.green.bold("  Setup complete!"));
+  console.log();
+  console.log(`  Try it: ${chalk.cyan('pixelmuse "a cat floating through space"')}`);
+  console.log(`  TUI:    ${chalk.cyan("pixelmuse ui")}`);
+  console.log(`  Help:   ${chalk.cyan("pixelmuse --help")}`);
+  console.log();
+}
 async function handleTemplate() {
   const [, templateCmd, ...templateArgs] = cli.input;
   switch (templateCmd) {
@@ -433,7 +703,7 @@ ${chalk.bold("Prompt:")} ${template.prompt}`);
         tags: []
       };
       saveTemplate(template);
-      const { PATHS: PATHS2 } = await import("./config-RMVFR3GN.js");
+      const { PATHS: PATHS2 } = await import("./config-Z76UJLDX.js");
       const path = `${PATHS2.prompts}/${slugify(name)}.yaml`;
       console.log(`Created template: ${chalk.bold(path)}`);
       console.log(chalk.gray("Edit the YAML file to customize your template."));
@@ -490,8 +760,11 @@ async function main() {
         process.exit(1);
       }
       return handleOpen(rest[0]);
+    case "setup":
+      return handleSetup();
     case "login":
-      return handleLogin();
+      await handleLogin();
+      return;
     case "logout":
       await deleteApiKey();
       console.log("Logged out.");

package/dist/{config-RMVFR3GN.js → config-Z76UJLDX.js}

@@ -4,7 +4,7 @@ import {
   ensureDirs,
   readSettings,
   writeSettings
-} from "./chunk-7ARYEFAH.js";
+} from "./chunk-PSHBBAJV.js";
 export {
   PATHS,
   ensureDirs,

package/dist/{image-2H3GUQI6.js → image-GQSNVWNN.js}

@@ -5,8 +5,8 @@ import {
   imageToBuffer,
   renderImageDirect,
   saveImage
-} from "./chunk-MZZY4JXW.js";
-import "./chunk-7ARYEFAH.js";
+} from "./chunk-M4N6UFDD.js";
+import "./chunk-PSHBBAJV.js";
 export {
   autoSave,
   hasChafa,

package/dist/mcp/server.js

@@ -1,16 +1,16 @@
 #!/usr/bin/env node
 import {
   generateImage
-} from "../chunk-LOW6S5UO.js";
+} from "../chunk-STJDWR4Q.js";
 import {
   CLI_VERSION,
   PixelmuseClient,
   getApiKey
-} from "../chunk-3BR2BNXV.js";
-import "../chunk-MZZY4JXW.js";
+} from "../chunk-Q5SB7WKR.js";
+import "../chunk-M4N6UFDD.js";
 import {
   readSettings
-} from "../chunk-7ARYEFAH.js";
+} from "../chunk-PSHBBAJV.js";
 
 // src/mcp/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -43,7 +43,8 @@ server.tool(
     model: z.enum(MODELS).optional().default("nano-banana-2").describe("Model to use"),
     aspect_ratio: z.enum(ASPECT_RATIOS).optional().default("1:1").describe("Image aspect ratio"),
     style: z.enum(STYLES).optional().default("none").describe("Visual style"),
-    output_path: z.string().optional().describe("Where to save the image (default: current directory)")
+    output_path: z.string().optional().describe("Where to save the image (default: current directory)"),
+    visibility: z.enum(["public", "private"]).optional().describe("Image visibility (default: private)")
   },
   async (args) => {
     const client = await getClient();
@@ -53,6 +54,7 @@ server.tool(
       model: args.model ?? settings.defaultModel,
       aspectRatio: args.aspect_ratio ?? settings.defaultAspectRatio,
       style: args.style ?? settings.defaultStyle,
+      visibility: args.visibility ?? settings.defaultVisibility,
       output: args.output_path
     });
     return {
@@ -65,6 +67,7 @@ server.tool(
             model: result.generation.model,
             prompt: result.generation.prompt,
             credits_charged: result.generation.credits_charged,
+            visibility: result.generation.visibility,
             elapsed_seconds: Math.round(result.elapsed * 10) / 10,
             output_path: result.imagePath
           }, null, 2)

package/dist/tui.js

@@ -11,17 +11,17 @@ import {
   pollGeneration,
   saveApiKey,
   saveTemplate
-} from "./chunk-3BR2BNXV.js";
+} from "./chunk-Q5SB7WKR.js";
 import {
   autoSave,
   hasChafa,
   imageToBuffer,
   renderImageDirect
-} from "./chunk-MZZY4JXW.js";
+} from "./chunk-M4N6UFDD.js";
 import {
   readSettings,
   writeSettings
-} from "./chunk-7ARYEFAH.js";
+} from "./chunk-PSHBBAJV.js";
 
 // src/tui.tsx
 import { render } from "ink";
@@ -330,7 +330,8 @@ function Generate({
   initialStyle,
   defaultModel = "nano-banana-2",
   defaultAspectRatio = "1:1",
-  defaultStyle = "none"
+  defaultStyle = "none",
+  defaultVisibility = "private"
 }) {
   const { exit } = useApp();
   const [step, setStep] = useState4(initialPrompt ? "model" : "prompt");
@@ -367,7 +368,8 @@ function Generate({
         prompt,
         model,
         aspect_ratio: aspectRatio,
-        style: style === "none" ? void 0 : style
+        style: style === "none" ? void 0 : style,
+        visibility: defaultVisibility
       });
       if (gen.status === "processing" || gen.status === "pending") {
         gen = await pollGeneration(client, gen.id, {
@@ -523,7 +525,8 @@ function ImageGrid({ generations, columns = 3, onSelect }) {
             /* @__PURE__ */ jsxs7(Text7, { color: gen.status === "succeeded" ? "green" : gen.status === "failed" ? "red" : "yellow", children: [
               gen.status === "succeeded" ? "\u25CF" : gen.status === "failed" ? "\u2717" : "\u25CC",
               " ",
-              gen.model
+              gen.model,
+              gen.visibility === "private" ? " \u{1F512}" : ""
             ] }),
             /* @__PURE__ */ jsx7(Text7, { color: "gray", wrap: "truncate", children: gen.prompt.slice(0, cellWidth - 4) }),
             /* @__PURE__ */ jsx7(Text7, { color: "gray", dimColor: true, children: new Date(gen.created_at).toLocaleDateString() })
@@ -1154,7 +1157,8 @@ function App({ initialRoute }) {
             initialStyle: route.style,
             defaultModel: settings.defaultModel,
             defaultAspectRatio: settings.defaultAspectRatio,
-            defaultStyle: settings.defaultStyle
+            defaultStyle: settings.defaultStyle,
+            defaultVisibility: settings.defaultVisibility
           }
         );
       case "gallery":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pixelmuse",
-  "version": "0.2.1",
+  "version": "0.4.0",
   "description": "AI image generation from the terminal — CLI, TUI, and MCP server for text-to-image with Flux, Imagen, Recraft, and more",
   "homepage": "https://pixelmuse.studio",
   "repository": {
@@ -19,17 +19,6 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "start": "node dist/cli.js",
-    "typecheck": "tsc --noEmit",
-    "lint": "eslint src/",
-    "lint:fix": "eslint src/ --fix",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "ci": "pnpm lint && pnpm typecheck && pnpm build && pnpm test"
-  },
   "keywords": [
     "cli",
     "image-generation",
@@ -83,12 +72,15 @@
   "engines": {
     "node": ">=20"
   },
-  "pnpm": {
-    "onlyBuiltDependencies": [
-      "esbuild"
-    ],
-    "overrides": {
-      "phin@<3.7.1": ">=3.7.1"
-    }
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "start": "node dist/cli.js",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "ci": "pnpm lint && pnpm typecheck && pnpm build && pnpm test"
   }
-}
+}