@nearform/fling 0.1.2 → 0.2.0

package/dist/cli.js

@@ -1,10 +1,11 @@
 #!/usr/bin/env node
 
 // src/cli.ts
+import chalk9 from "chalk";
 import { Command } from "commander";
 
 // src/commands/auth.ts
-import chalk4 from "chalk";
+import chalk5 from "chalk";
 
 // src/auth.ts
 import { randomBytes } from "node:crypto";
@@ -24,7 +25,7 @@ var MAX_FILES = 5e3;
 var MAX_PATH_LENGTH = 1024;
 
 // ../../packages/shared/src/secrets.ts
-var SECRET_SCAN_MAX_FILE_BYTES = 5 * 1024 * 1024;
+var SECRET_SCAN_MAX_FILE_BYTES = MAX_FILE_BYTES;
 var BINARY_SNIFF_BYTES = 8192;
 var SECRET_EXTENSIONS = [
   ".pem",
@@ -160,18 +161,18 @@ function lineAt(starts, index) {
   }
   return lo + 1;
 }
-function scanForSecrets(text, path) {
+function scanForSecrets(text2, path) {
   let starts;
   const findings = [];
   const seen = /* @__PURE__ */ new Set();
   for (const rule of RULES) {
     rule.re.lastIndex = 0;
-    for (let m = rule.re.exec(text); m !== null; m = rule.re.exec(text)) {
+    for (let m = rule.re.exec(text2); m !== null; m = rule.re.exec(text2)) {
       if (m[0].length === 0) rule.re.lastIndex++;
       if (rule.allow?.(m)) continue;
       if (!starts) {
         starts = [0];
-        for (let i = text.indexOf("\n"); i !== -1; i = text.indexOf("\n", i + 1)) starts.push(i + 1);
+        for (let i = text2.indexOf("\n"); i !== -1; i = text2.indexOf("\n", i + 1)) starts.push(i + 1);
       }
       const line = lineAt(starts, m.index);
       const key = `${rule.id}:${line}`;
@@ -655,7 +656,7 @@ function describeVersionFiles(name, files, opts) {
 var READY_TIMEOUT_MS = 15e3;
 var NOT_READY_NOTE = "it can take a few more seconds to appear everywhere; reload if you see a 404";
 var isReachableStatus = (status) => status >= 200 && status < 400 || status === 401 || status === 403;
-var defaultSleep = (ms) => new Promise((resolve3) => setTimeout(resolve3, ms));
+var defaultSleep = (ms) => new Promise((resolve5) => setTimeout(resolve5, ms));
 async function waitUntilReachable(url, opts = {}) {
   const timeoutMs = opts.timeoutMs ?? READY_TIMEOUT_MS;
   const doFetch = opts.fetch ?? ((u, init) => fetch(u, init));
@@ -729,7 +730,7 @@ function exitCodeFor(error) {
 // package.json
 var package_default = {
   name: "@nearform/fling",
-  version: "0.1.2",
+  version: "0.2.0",
   license: "MIT",
   description: "Fling a folder of static files at fling.labs.nearform.com and get a link back. CLI + MCP server.",
   type: "module",
@@ -760,6 +761,7 @@ var package_default = {
     test: "vitest run"
   },
   dependencies: {
+    "@clack/prompts": "^1.8.1",
     "@modelcontextprotocol/sdk": "^1.20.0",
     chalk: "^5.6.2",
     commander: "^15.0.0",
@@ -893,12 +895,12 @@ async function putUpload(fetchImpl, url, headers, body, timeoutMs = 5 * 6e4) {
 }
 async function readBody(response) {
   if (response.status === 204) return void 0;
-  const text = await response.text();
-  if (text === "") return void 0;
+  const text2 = await response.text();
+  if (text2 === "") return void 0;
   try {
-    return JSON.parse(text);
+    return JSON.parse(text2);
   } catch {
-    return text;
+    return text2;
   }
 }
 function errorFromResponse(status, body, method, path) {
@@ -1101,8 +1103,8 @@ async function startCallbackServer(options = {}) {
   const timeoutMs = options.timeoutMs ?? LOGIN_TIMEOUT_MS;
   let settle;
   let timer;
-  const result = new Promise((resolve3, reject) => {
-    settle = { resolve: resolve3, reject };
+  const result = new Promise((resolve5, reject) => {
+    settle = { resolve: resolve5, reject };
   }).finally(() => clearTimeout(timer));
   result.catch(() => {
   });
@@ -1163,7 +1165,7 @@ ${close ? "<script>setTimeout(function(){window.close()},800)</script>" : ""}
   res.end(html);
 }
 function listenOnFreePort(server) {
-  return new Promise((resolve3, reject) => {
+  return new Promise((resolve5, reject) => {
     let port = CALLBACK_PORT_START;
     const tryNext = () => {
       if (port > CALLBACK_PORT_END) {
@@ -1185,18 +1187,18 @@ function listenOnFreePort(server) {
       });
       server.listen(port, "127.0.0.1", () => {
         server.removeAllListeners("error");
-        resolve3(port);
+        resolve5(port);
       });
     };
     tryNext();
   });
 }
-function escapeHtml2(text) {
-  return text.replace(/[&<>"']/g, (ch) => `&#${ch.charCodeAt(0)};`);
+function escapeHtml2(text2) {
+  return text2.replace(/[&<>"']/g, (ch) => `&#${ch.charCodeAt(0)};`);
 }
 
 // src/context.ts
-import { createInterface } from "node:readline/promises";
+import { confirm, isCancel, text } from "@clack/prompts";
 
 // src/ready.ts
 import chalk from "chalk";
@@ -1232,20 +1234,83 @@ async function waitWithSpinner(waiter, url, paths, io) {
 }
 
 // src/utils/logger.ts
+import chalk3 from "chalk";
+
+// src/ui/theme.ts
 import chalk2 from "chalk";
-var PREFIX = chalk2.cyan("fling");
+var STOPS = [
+  [0, 229, 255],
+  [124, 77, 255],
+  [255, 78, 205]
+];
+var WORDMARK = [
+  "\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557     \u2588\u2588\u2557\u2588\u2588\u2588\u2557   \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 ",
+  "\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2551     \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D ",
+  "\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551     \u2588\u2588\u2551\u2588\u2588\u2554\u2588\u2588\u2557 \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2588\u2557",
+  "\u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2551     \u2588\u2588\u2551\u2588\u2588\u2551\u255A\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551",
+  "\u2588\u2588\u2551     \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2588\u2551\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D",
+  "\u255A\u2550\u255D     \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D "
+];
+var TRAILS = ["      ", "  \u2501\u2501\u2501 ", " \u2501\u2501\u2501\u2501 ", "   \u2501\u2501 ", "      ", "      "];
+var LOGO_WIDTH = TRAILS[0].length + WORDMARK[0].length;
+var brand = {
+  primary: chalk2.hex("#7C4DFF"),
+  accent: chalk2.hex("#00E5FF"),
+  url: (url) => chalk2.bold.hex("#00E5FF")(url)
+};
+var symbols = {
+  info: chalk2.hex("#7C4DFF")("\u25C6"),
+  success: chalk2.green("\u2714"),
+  warn: chalk2.yellow("\u25B2"),
+  error: chalk2.red("\u2716"),
+  step: chalk2.dim("\u2502")
+};
+function colourAt(t) {
+  const scaled = Math.min(Math.max(t, 0), 1) * (STOPS.length - 1);
+  const i = Math.min(Math.floor(scaled), STOPS.length - 2);
+  const f = scaled - i;
+  const a = STOPS[i];
+  const b = STOPS[i + 1];
+  return [0, 1, 2].map((k) => Math.round(a[k] + (b[k] - a[k]) * f));
+}
+function gradient(text2, width = text2.length, offset = 0) {
+  if (chalk2.level === 0) return text2;
+  return [...text2].map((ch, i) => ch === " " ? ch : chalk2.rgb(...colourAt((offset + i) / (width - 1)))(ch)).join("");
+}
+function logo(options = {}) {
+  const columns = options.columns || process.stderr.columns || 80;
+  const tagline = options.tagline ?? "throw static files at the web, get a link back";
+  if (columns < LOGO_WIDTH + 2) return `${gradient("\u25B6\u25B6 fling")}  ${chalk2.dim(tagline)}`;
+  const lines = WORDMARK.map(
+    (row, i) => chalk2.dim(TRAILS[i] ?? "") + gradient(row, WORDMARK[0].length)
+  );
+  return ["", ...lines, `${" ".repeat(TRAILS[0].length)}${chalk2.dim(tagline)}`, ""].join("\n");
+}
+var ANSI = /\x1b\[[0-9;]*m/g;
+var visibleLength = (s) => s.replace(ANSI, "").length;
+function box(lines, title) {
+  const width = Math.max(...lines.map(visibleLength), title ? visibleLength(title) + 2 : 0);
+  const border = chalk2.dim;
+  const top = title ? `${border("\u256D\u2500")} ${title} ${border(`${"\u2500".repeat(width - visibleLength(title) - 1)}\u256E`)}` : border(`\u256D${"\u2500".repeat(width + 2)}\u256E`);
+  const body = lines.map(
+    (line) => `${border("\u2502")} ${line}${" ".repeat(width - visibleLength(line))} ${border("\u2502")}`
+  );
+  return [top, ...body, border(`\u2570${"\u2500".repeat(width + 2)}\u256F`)].join("\n");
+}
+
+// src/utils/logger.ts
 function createLogger(options = {}) {
   const write = options.write ?? ((line) => process.stderr.write(`${line}
 `));
   const debugEnabled = options.debug ?? false;
   return {
-    info: (message) => write(`${PREFIX} ${message}`),
-    success: (message) => write(`${PREFIX} ${chalk2.green("\u2713")} ${message}`),
-    warn: (message) => write(`${PREFIX} ${chalk2.yellow("!")} ${message}`),
-    error: (message) => write(`${PREFIX} ${chalk2.red("\u2717")} ${message}`),
-    hint: (message) => write(chalk2.dim(`  ${message}`)),
+    info: (message) => write(`${symbols.info} ${message}`),
+    success: (message) => write(`${symbols.success} ${message}`),
+    warn: (message) => write(`${symbols.warn} ${chalk3.yellow(message)}`),
+    error: (message) => write(`${symbols.error} ${chalk3.red(message)}`),
+    hint: (message) => write(chalk3.dim(`  ${message}`)),
     debug: (message) => {
-      if (debugEnabled) write(chalk2.dim(`[debug] ${message}`));
+      if (debugEnabled) write(chalk3.dim(`[debug] ${message}`));
     }
   };
 }
@@ -1265,12 +1330,13 @@ var silentLogger = {
 };
 
 // src/utils/output.ts
-import chalk3 from "chalk";
+import chalk4 from "chalk";
 function createOutput(options = {}) {
   const json = options.json ?? false;
   const write = options.write ?? ((chunk) => process.stdout.write(chunk));
   return {
     json,
+    tty: options.tty ?? (options.write ? false : Boolean(process.stdout.isTTY)),
     data: (raw, human) => write(`${json ? formatJson(raw) : human()}
 `),
     text: (line) => {
@@ -1283,15 +1349,15 @@ function formatJson(value) {
   return JSON.stringify(value, null, 2);
 }
 function renderTable(rows, columns) {
-  if (rows.length === 0) return chalk3.dim("(no results)");
+  if (rows.length === 0) return chalk4.dim("(no results)");
   const cells = rows.map((row) => columns.map((column) => formatCell(column.value(row))));
   const widths = columns.map(
     (column, i) => Math.max(column.header.length, ...cells.map((line) => line[i]?.length ?? 0))
   );
-  const pad = (text, i) => i === columns.length - 1 ? text : text.padEnd(widths[i] ?? 0);
+  const pad = (text2, i) => i === columns.length - 1 ? text2 : text2.padEnd(widths[i] ?? 0);
   const header = columns.map((column, i) => pad(column.header, i)).join("  ");
   const body = cells.map((line) => line.map(pad).join("  "));
-  return [chalk3.bold(header), ...body].join("\n");
+  return [chalk4.bold(header), ...body].join("\n");
 }
 function formatCell(value) {
   if (value === null || value === void 0 || value === "") return "-";
@@ -1341,16 +1407,14 @@ async function createContext(options = {}) {
   };
 }
 async function ttyConfirm(question) {
-  const answer = await ttyPrompt(`${question} [y/N] `);
-  return /^y(es)?$/i.test(answer.trim());
+  const answer = await confirm({ message: question, initialValue: false, output: process.stderr });
+  if (isCancel(answer)) throw new CliError("Cancelled");
+  return answer;
 }
 async function ttyPrompt(question) {
-  const rl = createInterface({ input: process.stdin, output: process.stderr });
-  try {
-    return await rl.question(question);
-  } finally {
-    rl.close();
-  }
+  const answer = await text({ message: question.trim(), output: process.stderr });
+  if (isCancel(answer)) throw new CliError("Cancelled");
+  return answer ?? "";
 }
 function ttyProgress(line) {
   process.stderr.write(`\r\x1B[2K${line ?? ""}`);
@@ -1505,16 +1569,18 @@ async function runWhoami(ctx) {
       apiKeySource: ctx.config.apiKeySource
     },
     () => [
-      `${chalk4.bold("User:")}    ${me.name} <${me.email}>`,
-      `${chalk4.bold("Sites:")}   ${sitesPattern(base)} ${chalk4.dim("(names are first come, first served)")}`,
-      `${chalk4.bold("Server:")}  ${ctx.config.serverUrl}`,
-      `${chalk4.bold("API key:")} ${redactKey(ctx.config.apiKey)} ${chalk4.dim(`(from ${ctx.config.apiKeySource})`)}`
+      `${chalk5.bold("User:")}    ${me.name} <${me.email}>`,
+      `${chalk5.bold("Sites:")}   ${sitesPattern(base)} ${chalk5.dim("(names are first come, first served)")}`,
+      `${chalk5.bold("Server:")}  ${ctx.config.serverUrl}`,
+      `${chalk5.bold("API key:")} ${redactKey(ctx.config.apiKey)} ${chalk5.dim(`(from ${ctx.config.apiKeySource})`)}`
     ].join("\n")
   );
 }
 
 // src/commands/deploy.ts
-import chalk5 from "chalk";
+import { stat as stat4 } from "node:fs/promises";
+import { resolve as resolve3 } from "node:path";
+import chalk6 from "chalk";
 
 // src/deploy.ts
 import { readFile as readFile4 } from "node:fs/promises";
@@ -1534,7 +1600,7 @@ import { join as join2, relative, sep } from "node:path";
 import ignore from "ignore";
 var GIT_TIMEOUT_MS = 2e4;
 function git(cwd, args, input) {
-  return new Promise((resolve3) => {
+  return new Promise((resolve5) => {
     try {
       const child = execFile(
         "git",
@@ -1542,14 +1608,14 @@ function git(cwd, args, input) {
         { timeout: GIT_TIMEOUT_MS, maxBuffer: 256 * 1024 * 1024, encoding: "utf8" },
         (error, stdout) => {
           const code = error?.code;
-          if (error && !(args[0] === "check-ignore" && code === 1)) resolve3(null);
-          else resolve3(stdout);
+          if (error && !(args[0] === "check-ignore" && code === 1)) resolve5(null);
+          else resolve5(stdout);
         }
       );
-      child.on("error", () => resolve3(null));
+      child.on("error", () => resolve5(null));
       if (input !== void 0) child.stdin?.end(input);
     } catch {
-      resolve3(null);
+      resolve5(null);
     }
   });
 }
@@ -1598,13 +1664,13 @@ function nestedMode() {
       return false;
     },
     async enterDir(absDir, relDir) {
-      let text;
+      let text2;
       try {
-        text = await readFile2(join2(absDir, ".gitignore"), "utf8");
+        text2 = await readFile2(join2(absDir, ".gitignore"), "utf8");
       } catch {
         return;
       }
-      levels.push({ base: relDir, ig: ignore().add(text) });
+      levels.push({ base: relDir, ig: ignore().add(text2) });
     }
   };
 }
@@ -2297,428 +2363,342 @@ function wrapperPage(file) {
 `;
 }
 
-// src/locate.ts
-import { lstat, readdir as readdir2, readFile as readFile6, realpath as realpath3, stat as stat4 } from "node:fs/promises";
-import { posix, win32 } from "node:path";
-import { fileURLToPath } from "node:url";
-var DOWNLOADS_DIR_ENV = "FLING_DOWNLOADS_DIR";
-var FOUND_AS_GIVEN = "path";
-var SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", "__MACOSX", "Library", "AppData", "$RECYCLE.BIN"]);
-var SESSION_SKIP_DIRS = /* @__PURE__ */ new Set(["skills-plugin", "rpm", "uploads", "memory"]);
-var SESSIONS_DEPTH = 4;
-var OUTPUTS_DEPTH = 4;
-var SANDBOX_PATH_RE = /^\/(mnt\/user-data|mnt\/data|sessions|home\/claude|tmp\/outputs)(\/|$)/;
-var nodeFs = {
-  async stat(path) {
-    try {
-      const s = await stat4(path);
-      return { isFile: s.isFile(), isDirectory: s.isDirectory(), mtimeMs: s.mtimeMs, size: s.size };
-    } catch {
-      return null;
-    }
-  },
-  async readdir(path) {
-    try {
-      const entries = await readdir2(path, { withFileTypes: true });
-      const out = [];
-      for (const e of entries) {
-        if (e.isSymbolicLink()) {
-          const s = await stat4(`${path}/${e.name}`).catch(() => null);
-          out.push({ name: e.name, isFile: Boolean(s?.isFile()), isDirectory: false });
-        } else out.push({ name: e.name, isFile: e.isFile(), isDirectory: e.isDirectory() });
+// src/commands/deploy.ts
+async function runDeploy(ctx, input, opts) {
+  const client = requireClient(ctx);
+  const ask = ctx.interactive && !opts.yes;
+  const base = ask ? await discoverSitesBase(client) : sitesBaseFor(client.serverUrl);
+  const path = resolve3(input ?? ".");
+  if (!await stat4(path).catch(() => null))
+    throw new CliError(`No such file or folder: ${input ?? "."}`, {
+      hint: `Give the path to a folder, .html, .zip or other file, e.g. \`${ctx.binName} deploy ./dist\`.`
+    });
+  const prepared = await prepareInput(path);
+  try {
+    await deployPrepared(ctx, client, base, prepared, opts, ask);
+  } finally {
+    await prepared.cleanup();
+  }
+}
+async function deployPrepared(ctx, client, base, prepared, opts, ask) {
+  let local = await buildManifest(prepared.dir);
+  local.skipped.dotfiles.unshift(...prepared.skippedDotfiles);
+  for (const line of describeSkipped(local.skipped)) ctx.log.info(line);
+  let name = opts.name !== void 0 ? resolveSiteName(prepared.dir, opts.name) : prepared.defaultName;
+  if (opts.name === void 0 && ask) name = await confirmSiteName(ctx, client, name, base);
+  if (!hasRootIndex(local)) {
+    const pages = htmlPages(local).length;
+    const root = base ? siteUrlFor(name, base) : "the site root";
+    const warning = `No index.html at the root \u2014 ${root} will show a 404.`;
+    const choice = opts.listHtml === true ? "list" : opts.listHtml === false ? "fling" : ask ? await askNoIndex(ctx, pages) : pages > 0 ? "list" : "fling";
+    if (choice === "list") {
+      local = await withHtmlListing(local, name);
+      ctx.log.info(`Generated index.html listing ${pages} HTML page${pages === 1 ? "" : "s"}`);
+    } else ctx.log.warn(warning);
+  }
+  let progressShown = false;
+  const result = await deploy(
+    { client, fetch: ctx.fetch },
+    {
+      dir: prepared.dir,
+      name,
+      manifest: local,
+      spa: opts.spa ? true : void 0,
+      public: opts.public,
+      onProgress: (p) => {
+        if (p.total === 0) return;
+        progressShown = true;
+        ctx.progress(
+          `${progressBar(p.totalBytes ? p.bytes / p.totalBytes : p.uploaded / p.total)} uploading ${p.uploaded}/${p.total} files \xB7 ${formatBytes(p.bytes)}/${formatBytes(p.totalBytes)}`
+        );
       }
-      return out;
-    } catch {
-      return [];
     }
-  },
-  async realpath(path) {
-    return realpath3(path).catch(() => null);
-  },
-  async readText(path) {
-    try {
-      if (!(await lstat(path)).isFile()) return null;
-      return await readFile6(path, "utf8");
-    } catch {
-      return null;
+  ).finally(() => {
+    if (progressShown) ctx.progress(null);
+  });
+  for (const warning of result.warnings) if (warning !== NO_INDEX_WARNING) ctx.log.warn(warning);
+  const summary = `${result.fileCount} files, ${formatBytes(result.totalBytes)}`;
+  if (result.status === "unchanged") ctx.log.info(`Unchanged ${chalk6.dim(`(${summary})`)}`);
+  else if (result.status === "repointed")
+    ctx.log.success(`Restored version ${result.versionId} ${chalk6.dim(`(${summary})`)}`);
+  else
+    ctx.log.success(
+      `Deployed ${result.name} ${chalk6.dim(`(${summary}; uploaded ${result.uploaded}, version ${result.versionId})`)}`
+    );
+  const ready = result.status === "unchanged" ? true : (await waitWithSpinner(
+    ctx.waitReady,
+    result.url,
+    local.files.map((f) => f.path),
+    { progress: ctx.progress, warn: (m) => ctx.log.warn(m) }
+  )).ready;
+  const privateNote = `Private: Nearform sign-in required. Share publicly with \`${ctx.binName} share ${result.name}\`.`;
+  ctx.out.data({ status: result.status, site: result.site, ready, skipped: local.skipped }, () => {
+    const isPrivate = result.site.visibility === "private";
+    if (ctx.out.tty)
+      return box(
+        [brand.url(result.url), ...isPrivate ? [chalk6.dim(privateNote)] : []],
+        isPrivate ? chalk6.bold("flung \xB7 private") : chalk6.bold("flung \xB7 public")
+      );
+    const lines = [chalk6.bold(result.url)];
+    if (isPrivate) lines.push(chalk6.dim(privateNote));
+    return lines.join("\n");
+  });
+}
+var BAR_WIDTH = 20;
+function progressBar(fraction) {
+  const done = Math.round(Math.min(Math.max(fraction, 0), 1) * BAR_WIDTH);
+  return brand.primary("\u2501".repeat(done)) + chalk6.dim("\u2500".repeat(BAR_WIDTH - done));
+}
+async function askNoIndex(ctx, pages) {
+  const question = pages > 0 ? "No index.html at the root. [L]ist the HTML pages on a generated index page / [f]ling anyway (the root will 404) / [a]bort " : "No index.html at the root (and no HTML pages to list). [f]ling anyway (the root will 404) / [A]bort ";
+  for (; ; ) {
+    const answer = (await ctx.prompt(question)).trim().toLowerCase();
+    if (pages > 0 && (answer === "" || answer === "l" || answer === "list")) return "list";
+    if (answer === "f" || answer === "fling") return "fling";
+    if (answer === "a" || answer === "abort" || answer === "n" || answer === "no" || answer === "")
+      throw new CliError("Not flung: no index.html at the root", {
+        hint: "Fling the folder that contains index.html (your build output, e.g. ./dist), or pass --list-html / --no-list-html."
+      });
+  }
+}
+async function confirmSiteName(ctx, client, generated, base) {
+  const where = (n) => base ? ` \u2192 ${siteUrlFor(n, base)}` : "";
+  const describe = (n, note) => ctx.log.info(`Site name: ${chalk6.bold(n)}${where(n)}  ${chalk6.dim(`(${note})`)}`);
+  let candidate = generated;
+  for (; ; ) {
+    const check2 = await checkName(client, candidate);
+    let proposal;
+    if (check2.status === "available" || check2.status === "yours") {
+      proposal = candidate;
+      describe(candidate, check2.status === "yours" ? "updates your existing site" : "new");
+    } else {
+      const why = check2.status === "taken" ? "is taken" : "is not a valid site name";
+      const alternatives = check2.suggestions.length ? ` Suggestions: ${check2.suggestions.join(", ")}` : "";
+      ctx.log.warn(`${candidate} ${why}.${alternatives}`);
+      proposal = check2.suggestions[0];
+      if (proposal) describe(proposal, "new");
+    }
+    for (; ; ) {
+      const question = proposal ? `Use "${proposal}"? [Y/n or type another name] ` : "Type a site name (or n to abort): ";
+      const answer = (await ctx.prompt(question)).trim();
+      if (proposal && (answer === "" || /^y(es)?$/i.test(answer))) return proposal;
+      if (/^no?$/i.test(answer))
+        throw new CliError("Aborted \u2014 nothing was flung", {
+          hint: "Pass --name <name> to choose the site name up front."
+        });
+      if (answer === "") continue;
+      if (!isValidSiteName(answer)) {
+        ctx.log.warn(
+          `"${answer}" is not a valid site name: use lowercase letters, digits and single hyphens (max ${SITE_NAME_MAX}); some names are reserved.`
+        );
+        continue;
+      }
+      candidate = answer;
+      break;
     }
   }
-};
-var pathFor = (platform) => platform === "win32" ? win32 : posix;
-var usable = (value) => Boolean(value?.trim()) && !value?.trim().startsWith("${");
-async function xdgUserDir(key, opts, fs) {
-  const fromEnv2 = opts.env[`XDG_${key}_DIR`];
-  if (usable(fromEnv2)) return fromEnv2;
-  const configHome = opts.env.XDG_CONFIG_HOME || posix.join(opts.home, ".config");
-  const text = await fs.readText(posix.join(configHome, "user-dirs.dirs"));
-  const match = text?.match(new RegExp(`^XDG_${key}_DIR="([^"]*)"`, "m"));
-  if (!match?.[1]) return void 0;
-  return match[1].replace(/^\$HOME(?=\/|$)/, opts.home);
 }
-async function searchRoots(opts) {
-  const fs = opts.fs ?? nodeFs;
-  const p = pathFor(opts.platform);
-  const { home, env, platform } = opts;
-  const userHome = platform === "win32" && usable(env.USERPROFILE) ? env.USERPROFILE : home;
-  const roots = [];
-  const add = (label, path, depth, sessions = false) => {
-    if (!path) return;
-    const norm = p.resolve(path);
-    if (roots.some((r) => r.path === norm)) return;
-    roots.push({ label, path: norm, depth, ...sessions ? { sessions } : {} });
-  };
-  const cwd = p.resolve(opts.cwd);
-  if (cwd !== p.parse(cwd).root && cwd !== p.resolve(userHome)) add("current folder", cwd, 4);
-  const configured = usable(opts.downloadsDir) ? opts.downloadsDir : usable(env[DOWNLOADS_DIR_ENV]) ? env[DOWNLOADS_DIR_ENV] : void 0;
-  const defaultDownloads = platform === "linux" ? await xdgUserDir("DOWNLOAD", opts, fs) ?? p.join(home, "Downloads") : p.join(userHome, "Downloads");
-  add("Downloads", configured ? expandHome(configured, home, platform) : defaultDownloads, 3);
-  add("Downloads", defaultDownloads, 3);
-  const desktop = platform === "linux" ? await xdgUserDir("DESKTOP", opts, fs) ?? p.join(home, "Desktop") : p.join(userHome, "Desktop");
-  add("Desktop", desktop, 3);
-  if (platform === "win32" && usable(env.OneDrive))
-    add("Desktop", p.join(env.OneDrive, "Desktop"), 3);
-  const documents = platform === "linux" ? await xdgUserDir("DOCUMENTS", opts, fs) ?? p.join(home, "Documents") : p.join(userHome, "Documents");
-  add("Documents/Claude", p.join(documents, "Claude"), 4);
-  add("~/Claude", p.join(userHome, "Claude"), 4);
-  const claudeConfig = platform === "darwin" ? p.join(home, "Library", "Application Support", "Claude") : platform === "win32" ? p.join(
-    usable(env.APPDATA) ? env.APPDATA : p.join(userHome, "AppData", "Roaming"),
-    "Claude"
-  ) : p.join(env.XDG_CONFIG_HOME || p.join(home, ".config"), "Claude");
-  add(
-    "Claude Desktop outputs",
-    p.join(claudeConfig, "local-agent-mode-sessions"),
-    SESSIONS_DEPTH,
-    true
+
+// src/commands/setup.ts
+import { intro, outro, spinner } from "@clack/prompts";
+import chalk7 from "chalk";
+
+// src/claude.ts
+import { execFile as execFile2 } from "node:child_process";
+import { access, mkdtemp as mkdtemp2, writeFile as writeFile3 } from "node:fs/promises";
+import { homedir as homedir3, tmpdir as tmpdir2 } from "node:os";
+import { join as join5 } from "node:path";
+var MARKETPLACE_SOURCE = "nearform/fling";
+var MARKETPLACE_NAME = "fling";
+var PLUGIN_NAME = "fling";
+var PLUGIN_ID = `${PLUGIN_NAME}@${MARKETPLACE_NAME}`;
+var MCPB_PATH = "/downloads/fling.mcpb";
+var runClaude = (args) => new Promise((resolve5) => {
+  execFile2(
+    "claude",
+    [...args],
+    { timeout: 12e4, maxBuffer: 16 * 1024 * 1024, shell: process.platform === "win32" },
+    (error, stdout, stderr) => {
+      const missing = error?.code === "ENOENT";
+      const code = !error ? 0 : missing ? -1 : typeof error.code === "number" ? error.code : 1;
+      resolve5({ code, stdout: String(stdout), stderr: String(stderr) });
+    }
   );
-  if (!fs.realpath) return roots;
-  const real = [];
-  for (const root of roots) {
-    const path = await fs.realpath(root.path) ?? root.path;
-    if (!real.some((r) => r.path === path)) real.push({ ...root, path });
+});
+async function claudeCodeStatus(run) {
+  const version = await run(["--version"]);
+  if (version.code !== 0) return { claude: "missing" };
+  const claude = version.stdout.trim().split(/\s+/)[0] ?? "unknown";
+  const list = await run(["plugin", "list", "--json"]);
+  let plugins = [];
+  try {
+    plugins = JSON.parse(list.stdout);
+  } catch {
   }
-  return real;
+  const fling = Array.isArray(plugins) ? plugins.find((p) => p.id === PLUGIN_ID) : void 0;
+  if (!fling) return { claude, installed: false };
+  return {
+    claude,
+    installed: true,
+    version: fling.version,
+    scope: fling.scope,
+    enabled: fling.enabled
+  };
 }
-function expandHome(input, home, platform) {
-  if (input === "~") return home;
-  if (input.startsWith("~/") || platform === "win32" && input.startsWith("~\\"))
-    return pathFor(platform).join(home, input.slice(2));
-  return input;
+async function installPlugin(run, scope) {
+  check(
+    await run(["plugin", "install", PLUGIN_NAME, "--marketplace", MARKETPLACE_SOURCE, "-s", scope]),
+    "install the Fling plugin"
+  );
 }
-async function walk(roots, opts, visit) {
-  const fs = opts.fs ?? nodeFs;
-  const p = pathFor(opts.platform);
-  const now = opts.now ?? Date.now;
-  const deadline = now() + (opts.timeBudgetMs ?? 4e3);
-  let budget = opts.entryBudget ?? 6e4;
-  const skip = (name) => name.startsWith(".") || SKIP_DIRS.has(name);
-  const expanded = [];
-  for (const root of roots) {
-    if (!root.sessions) {
-      expanded.push(root);
-      continue;
+async function updatePlugin(run, scope) {
+  check(await run(["plugin", "marketplace", "update", MARKETPLACE_NAME]), "update the marketplace");
+  check(
+    await run(["plugin", "update", PLUGIN_ID, ...scope ? ["-s", scope] : []]),
+    "update the Fling plugin"
+  );
+}
+function check(result, what) {
+  if (result.code === 0) return;
+  const detail = (result.stderr || result.stdout).trim().split("\n").at(-1);
+  throw new Error(`Could not ${what}${detail ? `: ${detail}` : ""}`);
+}
+async function findClaudeDesktop(platform = process.platform, env = process.env, exists = (path) => access(path).then(
+  () => true,
+  () => false
+)) {
+  const candidates = platform === "darwin" ? ["/Applications/Claude.app", join5(homedir3(), "Applications", "Claude.app")] : platform === "win32" && env.LOCALAPPDATA ? [join5(env.LOCALAPPDATA, "AnthropicClaude"), join5(env.LOCALAPPDATA, "Programs", "Claude")] : [];
+  for (const path of candidates) if (await exists(path)) return path;
+  return null;
+}
+async function downloadExtension(serverUrl, fetch2) {
+  const url = new URL(MCPB_PATH, serverUrl).toString();
+  const response = await fetch2(url);
+  if (!response.ok) throw new Error(`Could not download ${url} (HTTP ${response.status})`);
+  const dir = await mkdtemp2(join5(tmpdir2(), "fling-mcpb-"));
+  const file = join5(dir, "fling.mcpb");
+  await writeFile3(file, Buffer.from(await response.arrayBuffer()));
+  return file;
+}
+
+// src/commands/setup.ts
+var SCOPES = ["user", "project", "local"];
+async function runSetup(baseCtx, opts, deps = {}) {
+  const scope = opts.scope ?? "user";
+  if (!SCOPES.includes(scope))
+    throw new CliError(`--scope must be one of ${SCOPES.join(", ")}, not "${opts.scope}"`);
+  const run = deps.runClaude ?? runClaude;
+  const ask = baseCtx.interactive && !opts.yes;
+  const fancy = baseCtx.interactive && !baseCtx.json;
+  const ctx = fancy ? {
+    ...baseCtx,
+    log: createLogger({
+      debug: baseCtx.config.debug,
+      write: (line) => process.stderr.write(`${chalk7.gray("\u2502")}  ${line}
+`)
+    })
+  } : baseCtx;
+  if (fancy) {
+    process.stderr.write(`${logo()}
+`);
+    intro(chalk7.bold(" fling setup "), { output: process.stderr });
+  }
+  const results = {
+    login: await stepLogin(ctx),
+    claudeCode: "skipped",
+    claudeDesktop: "skipped"
+  };
+  results.claudeCode = await stepClaudeCode(ctx, run, scope, ask, fancy);
+  results.claudeDesktop = await stepClaudeDesktop(ctx, deps, ask, fancy);
+  const failed = Object.values(results).includes("failed");
+  if (fancy)
+    outro(
+      failed ? chalk7.yellow("Setup finished with problems \u2014 see above, then run `fling setup` again.") : `You're set. Try ${chalk7.bold(`${ctx.binName} deploy ./dist`)}, or ask Claude to \u201Cfling this\u201D.`,
+      { output: process.stderr }
+    );
+  ctx.out.data(results, () => "");
+  if (failed) process.exitCode = 1;
+}
+async function stepLogin(ctx) {
+  if (ctx.config.apiKey) {
+    try {
+      const me = await whoami(requireClient(ctx));
+      ctx.log.success(`Signed in as ${chalk7.bold(me.name)} ${chalk7.dim(`<${me.email}>`)}`);
+      return "already";
+    } catch (error) {
+      if (exitCodeFor(error) !== 2) {
+        ctx.log.error(error instanceof Error ? error.message : String(error));
+        return "failed";
+      }
+      ctx.log.warn("The stored API key no longer works \u2014 signing in again");
     }
-    let level = [root.path];
-    for (let depth = 0; depth < root.depth && level.length; depth++) {
-      const next = [];
-      for (const dir of level) {
-        for (const e of await fs.readdir(dir)) {
-          if (!e.isDirectory || skip(e.name) || SESSION_SKIP_DIRS.has(e.name)) continue;
-          const child = p.join(dir, e.name);
-          if (e.name === "outputs")
-            expanded.push({ label: root.label, path: child, depth: OUTPUTS_DEPTH });
-          else next.push(child);
-        }
-      }
-      level = next;
-    }
-  }
-  for (const root of expanded) {
-    let level = [root.path];
-    for (let depth = 0; depth <= root.depth && level.length; depth++) {
-      const next = [];
-      for (const dir of level) {
-        if (now() > deadline || budget <= 0) return { complete: false };
-        const entries = await fs.readdir(dir);
-        budget -= entries.length;
-        for (const entry of entries) {
-          if (entry.name.startsWith(".")) continue;
-          const path = p.join(dir, entry.name);
-          const result = await visit({ root, path, entry, siblings: entries });
-          if (entry.isDirectory && !skip(entry.name) && result !== "skip" && depth < root.depth)
-            next.push(path);
-        }
-      }
-      level = next;
-    }
-  }
-  return { complete: true };
-}
-function withoutDuplicateSuffix(name) {
-  return name.replace(/ \(\d+\)(?=\.[^.]+$|$)/, "");
-}
-function namesMatch(candidate, wanted) {
-  const a = candidate.toLowerCase();
-  const b = wanted.toLowerCase();
-  return a === b || withoutDuplicateSuffix(a) === withoutDuplicateSuffix(b);
-}
-var splitSegments = (path) => path.split(/[\\/]+/).filter((s) => s !== "" && s !== "." && s !== "~");
-function suffixScore(path, wanted) {
-  const have = splitSegments(path);
-  let score = 1;
-  for (let i = 2; i <= Math.min(have.length, wanted.length); i++) {
-    if (have[have.length - i]?.toLowerCase() !== wanted[wanted.length - i]?.toLowerCase()) break;
-    score++;
-  }
-  return score;
-}
-var looksLikeSandboxPath = (input) => SANDBOX_PATH_RE.test(input.replace(/\\/g, "/"));
-function normaliseInput(raw, opts) {
-  let input = raw.trim().replace(/^(["'])(.*)\1$/, "$2");
-  if (input.startsWith("file://")) {
-    try {
-      input = fileURLToPath(input, { windows: opts.platform === "win32" });
-    } catch {
-      input = decodeURIComponent(input.slice("file://".length));
-    }
-  }
-  return expandHome(input, opts.home, opts.platform);
-}
-async function resolveInput(input, opts) {
-  const fs = opts.fs ?? nodeFs;
-  const p = pathFor(opts.platform);
-  const given = normaliseInput(input, opts);
-  if (!given) throw new CliError("No path given");
-  const direct = p.isAbsolute(given) ? p.normalize(given) : p.resolve(opts.cwd, given);
-  const directStat = await fs.stat(direct);
-  if (directStat && (directStat.isFile || directStat.isDirectory)) {
-    return {
-      path: direct,
-      foundIn: FOUND_AS_GIVEN,
-      isDirectory: directStat.isDirectory,
-      alternatives: []
-    };
-  }
-  const wanted = splitSegments(given);
-  const name = wanted.at(-1);
-  const roots = await searchRoots(opts);
-  if (!name) throw notFound(input, roots);
-  const found = [];
-  const seen = /* @__PURE__ */ new Set();
-  await walk(roots, opts, async ({ root, path, entry }) => {
-    if (!(entry.isFile || entry.isDirectory) || !namesMatch(entry.name, name)) return;
-    if (seen.has(path)) return;
-    seen.add(path);
-    const s = await fs.stat(path);
-    if (!s) return;
-    found.push({
-      path,
-      foundIn: root.label,
-      kind: s.isDirectory ? "folder" : "file",
-      modified: new Date(s.mtimeMs).toISOString(),
-      size: s.size,
-      score: suffixScore(path, wanted),
-      mtimeMs: s.mtimeMs,
-      isDirectory: s.isDirectory
-    });
-    return void 0;
-  });
-  if (found.length === 0) throw notFound(input, roots);
-  found.sort((a, b) => b.score - a.score || b.mtimeMs - a.mtimeMs);
-  const strip = ({ score: _s, mtimeMs: _m, isDirectory: _d, ...c }) => c;
-  const [best, ...rest] = found;
-  return {
-    path: best.path,
-    foundIn: best.foundIn,
-    isDirectory: best.isDirectory,
-    alternatives: rest.slice(0, 5).map(strip)
-  };
-}
-function notFound(input, roots) {
-  const where = roots.map((r) => `${r.label} (${r.path})`).join(", ");
-  const sandbox = looksLikeSandboxPath(input) ? " That looks like a path inside Claude\u2019s sandbox, which this computer cannot see: publish the content inline with fling_publish, or save/download the file to this computer first." : "";
-  return new CliError(`Could not find "${input}". Looked for it by name in: ${where}.${sandbox}`, {
-    hint: "Pass the full path, or save the file to your Downloads folder and use just its name."
-  });
-}
-var LISTED_EXT = /\.(html?|zip)$/i;
-async function findFiles(opts, find = {}) {
-  const fs = opts.fs ?? nodeFs;
-  const p = pathFor(opts.platform);
-  const now = (opts.now ?? Date.now)();
-  const since = now - (find.days ?? 14) * 24 * 60 * 60 * 1e3;
-  const query = find.query?.trim().toLowerCase();
-  const roots = await searchRoots(opts);
-  const found = /* @__PURE__ */ new Map();
-  const rootPaths = new Set(roots.map((r) => r.path));
-  const { complete } = await walk(roots, opts, async ({ root, path, entry }) => {
-    if (entry.isDirectory) {
-      if (rootPaths.has(path)) return;
-      const index = (await fs.readdir(path)).find((e) => e.isFile && /^index\.html?$/i.test(e.name));
-      if (!index) return;
-      const s2 = await fs.stat(p.join(path, index.name));
-      if (s2 && s2.mtimeMs >= since && (!query || entry.name.toLowerCase().includes(query)))
-        found.set(path, {
-          path,
-          foundIn: root.label,
-          kind: "folder",
-          modified: new Date(s2.mtimeMs).toISOString(),
-          size: s2.size,
-          mtimeMs: s2.mtimeMs
-        });
-      return "skip";
-    }
-    if (!entry.isFile || !LISTED_EXT.test(entry.name)) return;
-    if (query && !entry.name.toLowerCase().includes(query)) return;
-    const s = await fs.stat(path);
-    if (!s || s.mtimeMs < since || found.has(path)) return;
-    found.set(path, {
-      path,
-      foundIn: root.label,
-      kind: "file",
-      modified: new Date(s.mtimeMs).toISOString(),
-      size: s.size,
-      mtimeMs: s.mtimeMs
-    });
-    return void 0;
-  });
-  const files = [...found.values()].sort((a, b) => b.mtimeMs - a.mtimeMs).slice(0, find.limit ?? 20).map(({ mtimeMs: _m, ...c }) => c);
-  return { files, searched: roots, complete };
-}
-
-// src/commands/deploy.ts
-async function runDeploy(ctx, input, opts) {
-  const client = requireClient(ctx);
-  const ask = ctx.interactive && !opts.yes;
-  const base = ask ? await discoverSitesBase(client) : sitesBaseFor(client.serverUrl);
-  const located = await resolveInput(input ?? ".", ctx.locate ?? systemLocateOptions());
-  if (located.foundIn !== FOUND_AS_GIVEN) {
-    ctx.log.info(`Found in ${located.foundIn}: ${located.path}`);
-    if (located.alternatives.length)
-      ctx.log.hint(
-        `Also found (older): ${located.alternatives.map((a) => a.path).join(", ")} \u2014 pass the full path to fling another.`
-      );
   }
-  const prepared = await prepareInput(located.path);
   try {
-    await deployPrepared(ctx, client, base, prepared, opts, ask);
-  } finally {
-    await prepared.cleanup();
+    await runLogin({ ...ctx, json: false });
+    return "done";
+  } catch (error) {
+    ctx.log.error(error instanceof Error ? error.message : String(error));
+    return "failed";
   }
 }
-async function deployPrepared(ctx, client, base, prepared, opts, ask) {
-  let local = await buildManifest(prepared.dir);
-  local.skipped.dotfiles.unshift(...prepared.skippedDotfiles);
-  for (const line of describeSkipped(local.skipped)) ctx.log.info(line);
-  let name = opts.name !== void 0 ? resolveSiteName(prepared.dir, opts.name) : prepared.defaultName;
-  if (opts.name === void 0 && ask) name = await confirmSiteName(ctx, client, name, base);
-  if (!hasRootIndex(local)) {
-    const pages = htmlPages(local).length;
-    const root = base ? siteUrlFor(name, base) : "the site root";
-    const warning = `No index.html at the root \u2014 ${root} will show a 404.`;
-    const choice = opts.listHtml === true ? "list" : opts.listHtml === false ? "fling" : ask ? await askNoIndex(ctx, pages) : pages > 0 ? "list" : "fling";
-    if (choice === "list") {
-      local = await withHtmlListing(local, name);
-      ctx.log.info(`Generated index.html listing ${pages} HTML page${pages === 1 ? "" : "s"}`);
-    } else ctx.log.warn(warning);
-  }
-  let progressShown = false;
-  const result = await deploy(
-    { client, fetch: ctx.fetch },
-    {
-      dir: prepared.dir,
-      name,
-      manifest: local,
-      spa: opts.spa ? true : void 0,
-      public: opts.public,
-      onProgress: (p) => {
-        if (p.total === 0) return;
-        progressShown = true;
-        ctx.progress(
-          `${chalk5.cyan("fling")} uploading ${p.uploaded}/${p.total} files \xB7 ${formatBytes(p.bytes)}/${formatBytes(p.totalBytes)}`
-        );
-      }
-    }
-  ).finally(() => {
-    if (progressShown) ctx.progress(null);
-  });
-  for (const warning of result.warnings) if (warning !== NO_INDEX_WARNING) ctx.log.warn(warning);
-  const summary = `${result.fileCount} files, ${formatBytes(result.totalBytes)}`;
-  if (result.status === "unchanged") ctx.log.info(`Unchanged ${chalk5.dim(`(${summary})`)}`);
-  else if (result.status === "repointed")
-    ctx.log.success(`Restored version ${result.versionId} ${chalk5.dim(`(${summary})`)}`);
-  else
-    ctx.log.success(
-      `Deployed ${result.name} ${chalk5.dim(`(${summary}; uploaded ${result.uploaded}, version ${result.versionId})`)}`
+async function stepClaudeCode(ctx, run, scope, ask, fancy) {
+  const status = await claudeCodeStatus(run);
+  if (status.claude === "missing") {
+    ctx.log.info(`Claude Code not found ${chalk7.dim("(no `claude` on your PATH) \u2014 skipped")}`);
+    ctx.log.hint(
+      `Once it is installed, run \`${ctx.binName} setup\` again, or in Claude Code: /plugin marketplace add ${MARKETPLACE_SOURCE} then /plugin install ${PLUGIN_ID}`
     );
-  const ready = result.status === "unchanged" ? true : (await waitWithSpinner(
-    ctx.waitReady,
-    result.url,
-    local.files.map((f) => f.path),
-    { progress: ctx.progress, warn: (m) => ctx.log.warn(m) }
-  )).ready;
-  ctx.out.data({ status: result.status, site: result.site, ready, skipped: local.skipped }, () => {
-    const lines = [chalk5.bold(result.url)];
-    if (result.site.visibility === "private")
-      lines.push(
-        chalk5.dim(
-          `Private: Nearform sign-in required. Share publicly with \`${ctx.binName} share ${result.name}\`.`
-        )
-      );
-    return lines.join("\n");
-  });
-}
-async function askNoIndex(ctx, pages) {
-  const question = pages > 0 ? "No index.html at the root. [L]ist the HTML pages on a generated index page / [f]ling anyway (the root will 404) / [a]bort " : "No index.html at the root (and no HTML pages to list). [f]ling anyway (the root will 404) / [A]bort ";
-  for (; ; ) {
-    const answer = (await ctx.prompt(question)).trim().toLowerCase();
-    if (pages > 0 && (answer === "" || answer === "l" || answer === "list")) return "list";
-    if (answer === "f" || answer === "fling") return "fling";
-    if (answer === "a" || answer === "abort" || answer === "n" || answer === "no" || answer === "")
-      throw new CliError("Not flung: no index.html at the root", {
-        hint: "Fling the folder that contains index.html (your build output, e.g. ./dist), or pass --list-html / --no-list-html."
-      });
+    return "missing";
   }
-}
-async function confirmSiteName(ctx, client, generated, base) {
-  const where = (n) => base ? ` \u2192 ${siteUrlFor(n, base)}` : "";
-  const describe = (n, note) => ctx.log.info(`Site name: ${chalk5.bold(n)}${where(n)}  ${chalk5.dim(`(${note})`)}`);
-  let candidate = generated;
-  for (; ; ) {
-    const check = await checkName(client, candidate);
-    let proposal;
-    if (check.status === "available" || check.status === "yours") {
-      proposal = candidate;
-      describe(candidate, check.status === "yours" ? "updates your existing site" : "new");
-    } else {
-      const why = check.status === "taken" ? "is taken" : "is not a valid site name";
-      const alternatives = check.suggestions.length ? ` Suggestions: ${check.suggestions.join(", ")}` : "";
-      ctx.log.warn(`${candidate} ${why}.${alternatives}`);
-      proposal = check.suggestions[0];
-      if (proposal) describe(proposal, "new");
-    }
-    for (; ; ) {
-      const question = proposal ? `Use "${proposal}"? [Y/n or type another name] ` : "Type a site name (or n to abort): ";
-      const answer = (await ctx.prompt(question)).trim();
-      if (proposal && (answer === "" || /^y(es)?$/i.test(answer))) return proposal;
-      if (/^no?$/i.test(answer))
-        throw new CliError("Aborted \u2014 nothing was flung", {
-          hint: "Pass --name <name> to choose the site name up front."
-        });
-      if (answer === "") continue;
-      if (!isValidSiteName(answer)) {
-        ctx.log.warn(
-          `"${answer}" is not a valid site name: use lowercase letters, digits and single hyphens (max ${SITE_NAME_MAX}); some names are reserved.`
-        );
-        continue;
-      }
-      candidate = answer;
-      break;
-    }
+  const installed = "installed" in status && status.installed;
+  const question = installed ? `The Fling plugin is installed in Claude Code${status.version ? ` (${status.version})` : ""}. Update it to the latest?` : "Install the Fling plugin (skill + MCP server) into Claude Code?";
+  if (ask && !await ctx.confirm(question)) {
+    ctx.log.info(chalk7.dim("Claude Code plugin: skipped"));
+    return installed ? "already" : "skipped";
+  }
+  const s = fancy ? spinner({ output: process.stderr }) : null;
+  s?.start(installed ? "Updating the Claude Code plugin" : "Installing the Claude Code plugin");
+  try {
+    if (installed) await updatePlugin(run, status.scope);
+    else await installPlugin(run, scope);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (s) s.error(message);
+    else ctx.log.error(message);
+    return "failed";
+  }
+  const done = installed ? `Claude Code plugin ${PLUGIN_NAME} is up to date` : `Claude Code plugin ${PLUGIN_NAME} installed ${chalk7.dim(`(${scope} scope)`)}`;
+  if (s) s.stop(done);
+  else ctx.log.success(done);
+  ctx.log.hint("Restart Claude Code (or run /reload-plugins) to pick it up.");
+  return installed ? "updated" : "done";
+}
+async function stepClaudeDesktop(ctx, deps, ask, fancy) {
+  const app = await (deps.findClaudeDesktop ?? findClaudeDesktop)();
+  if (!app) return "missing";
+  if (ask && !await ctx.confirm("Add the Fling extension to Claude Desktop too?")) {
+    ctx.log.info(chalk7.dim("Claude Desktop extension: skipped"));
+    return "skipped";
+  }
+  const s = fancy ? spinner({ output: process.stderr }) : null;
+  s?.start("Downloading the Claude Desktop extension");
+  try {
+    const file = await (deps.downloadExtension ?? ((serverUrl) => downloadExtension(serverUrl, ctx.fetch)))(ctx.config.serverUrl);
+    await ctx.open(file);
+    const done = "Opened fling.mcpb in Claude Desktop \u2014 click Install there to finish";
+    if (s) s.stop(done);
+    else ctx.log.success(done);
+    return "done";
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (s) s.error(message);
+    else ctx.log.error(message);
+    return "failed";
   }
 }
 
 // src/commands/sites.ts
-import chalk6 from "chalk";
+import chalk8 from "chalk";
 async function runList(ctx, opts) {
   const sites = await listSites(requireClient(ctx), opts);
   ctx.out.data(
@@ -2736,11 +2716,11 @@ async function runList(ctx, opts) {
   );
 }
 function describeSite(site) {
-  const row = (label, value) => `${chalk6.bold(`${label}:`.padEnd(12))}${value}`;
+  const row = (label, value) => `${chalk8.bold(`${label}:`.padEnd(12))}${value}`;
   return [
     row("Name", site.name),
     row("URL", site.url),
-    row("Visibility", site.visibility + (site.archived ? chalk6.yellow(" (archived)") : "")),
+    row("Visibility", site.visibility + (site.archived ? chalk8.yellow(" (archived)") : "")),
     row("SPA", site.spa ? "yes" : "no"),
     row("Share link", site.shareUrl ?? "-"),
     row("Version", site.currentVersionId ?? "-"),
@@ -2755,118 +2735,408 @@ function filesRow(site, row) {
   const n = current.fileCount;
   return [row("Files", `${n} file${n === 1 ? "" : "s"}, ${formatBytes(current.totalBytes)}`)];
 }
-async function runInfo(ctx, name) {
-  const site = await getSite(requireClient(ctx), name);
-  ctx.out.data(
-    site,
-    () => [
-      ...describeSite(site),
-      "",
-      chalk6.dim(
-        `${site.versions.length} version(s) \u2014 \`fling versions ${name}\`; files \u2014 \`fling files ${name}\``
-      )
-    ].join("\n")
-  );
+async function runInfo(ctx, name) {
+  const site = await getSite(requireClient(ctx), name);
+  ctx.out.data(
+    site,
+    () => [
+      ...describeSite(site),
+      "",
+      chalk8.dim(
+        `${site.versions.length} version(s) \u2014 \`fling versions ${name}\`; files \u2014 \`fling files ${name}\``
+      )
+    ].join("\n")
+  );
+}
+async function runVersions(ctx, name) {
+  const site = await getSite(requireClient(ctx), name);
+  ctx.out.data(
+    { name: site.name, currentVersionId: site.currentVersionId, versions: site.versions },
+    () => renderTable(site.versions, [
+      { header: "", value: (v) => v.id === site.currentVersionId ? "*" : " " },
+      { header: "VERSION", value: (v) => v.id },
+      { header: "FILES", value: (v) => v.fileCount },
+      { header: "SIZE", value: (v) => formatBytes(v.totalBytes) },
+      { header: "CREATED", value: (v) => formatDate(v.createdAt) }
+    ])
+  );
+}
+async function runFiles(ctx, name, versionId) {
+  const result = await versionFiles(requireClient(ctx), name, versionId);
+  if (!result.files.some((f) => f.path === "index.html")) {
+    ctx.log.warn("No index.html at the root \u2014 the site root URL will 404");
+  }
+  ctx.out.data(result, () => {
+    const n = result.files.length;
+    const header = chalk8.dim(
+      `${result.versionId}${result.current ? " (current)" : " (not served)"} \u2014 ${n} file${n === 1 ? "" : "s"}, ${formatBytes(result.totalBytes)}${result.generatedIndex ? ", generated index.html" : ""}`
+    );
+    const table = renderTable(result.files, [
+      { header: "PATH", value: (f) => f.path },
+      { header: "SIZE", value: (f) => formatBytes(f.size) },
+      { header: "TYPE", value: (f) => f.contentType }
+    ]);
+    return `${header}
+${table}`;
+  });
+}
+async function runRollback(ctx, name, versionId) {
+  const site = await rollback(requireClient(ctx), name, versionId);
+  ctx.log.success(`${name} now serves version ${site.currentVersionId ?? versionId}`);
+  ctx.out.data(site, () => site.url);
+}
+async function runShare(ctx, name, opts) {
+  if (opts.refresh && opts.revoke) throw new CliError("Use either --refresh or --revoke, not both");
+  const client = requireClient(ctx);
+  const result = await share(client, name, opts);
+  let ready;
+  if (result.action === "created" || result.action === "refreshed") {
+    const files = ctx.waitReady ? await versionFiles(client, name).catch(() => null) : null;
+    ready = (await waitWithSpinner(ctx.waitReady, result.shareUrl, files?.files.map((f) => f.path) ?? [], {
+      progress: ctx.progress,
+      warn: (m) => ctx.log.warn(m)
+    })).ready;
+  }
+  if (result.action === "revoked") ctx.log.success(`Share link for ${name} revoked`);
+  else if (result.action === "refreshed")
+    ctx.log.success("New share link \u2014 the old one no longer works");
+  else if (result.action === "created")
+    ctx.log.success("Share link created \u2014 anyone with it can view the site");
+  ctx.out.data(
+    ready === void 0 ? result : { ...result, ready },
+    () => result.shareUrl ? result.shareUrl : chalk8.dim("(no share link)")
+  );
+}
+async function runVisibility(ctx, name, visibility) {
+  if (visibility !== "private" && visibility !== "public") {
+    throw new CliError(`Visibility must be "private" or "public", not "${visibility}"`);
+  }
+  const site = await setVisibility(requireClient(ctx), name, visibility);
+  ctx.log.success(
+    site.visibility === "public" ? `${name} is public \u2014 no sign-in needed` : `${name} is private \u2014 Nearform sign-in required`
+  );
+  ctx.out.data(site, () => site.url);
+}
+async function runArchive(ctx, name, unarchive = false) {
+  const site = await archiveSite(requireClient(ctx), name, { unarchive });
+  ctx.log.success(
+    unarchive ? `${name} restored` : `${name} archived \u2014 it 404s until \`fling unarchive ${name}\``
+  );
+  if (ctx.json) ctx.out.data(site, () => "");
+  else if (unarchive) ctx.out.text(site.url);
+}
+async function runRemove(ctx, name, opts) {
+  if (!opts.yes) {
+    if (!ctx.interactive) {
+      throw new CliError(`Refusing to delete ${name} without confirmation`, {
+        hint: "Pass --yes to delete."
+      });
+    }
+    const ok = await ctx.confirm(`Delete ${name} and every version of it? This cannot be undone.`);
+    if (!ok) throw new CliError("Cancelled");
+  }
+  const result = await deleteSite(requireClient(ctx), name);
+  ctx.log.success(`${name} deleted`);
+  if (ctx.json) ctx.out.data(result, () => "");
+}
+
+// src/mcp.ts
+import { mkdir as mkdir3, mkdtemp as mkdtemp3, rm as rm2, writeFile as writeFile4 } from "node:fs/promises";
+import { tmpdir as tmpdir3 } from "node:os";
+import { basename as basename3, dirname as dirname2, join as join6 } from "node:path";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z as z7 } from "zod";
+
+// src/locate.ts
+import { lstat, readdir as readdir2, readFile as readFile6, realpath as realpath3, stat as stat5 } from "node:fs/promises";
+import { posix, win32 } from "node:path";
+import { fileURLToPath } from "node:url";
+var DOWNLOADS_DIR_ENV = "FLING_DOWNLOADS_DIR";
+var FOUND_AS_GIVEN = "path";
+var SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", "__MACOSX", "Library", "AppData", "$RECYCLE.BIN"]);
+var SESSION_SKIP_DIRS = /* @__PURE__ */ new Set(["skills-plugin", "rpm", "uploads", "memory"]);
+var SESSIONS_DEPTH = 4;
+var OUTPUTS_DEPTH = 4;
+var SANDBOX_PATH_RE = /^\/(mnt\/user-data|mnt\/data|sessions|home\/claude|tmp\/outputs)(\/|$)/;
+var nodeFs = {
+  async stat(path) {
+    try {
+      const s = await stat5(path);
+      return { isFile: s.isFile(), isDirectory: s.isDirectory(), mtimeMs: s.mtimeMs, size: s.size };
+    } catch {
+      return null;
+    }
+  },
+  async readdir(path) {
+    try {
+      const entries = await readdir2(path, { withFileTypes: true });
+      const out = [];
+      for (const e of entries) {
+        if (e.isSymbolicLink()) {
+          const s = await stat5(`${path}/${e.name}`).catch(() => null);
+          out.push({ name: e.name, isFile: Boolean(s?.isFile()), isDirectory: false });
+        } else out.push({ name: e.name, isFile: e.isFile(), isDirectory: e.isDirectory() });
+      }
+      return out;
+    } catch {
+      return [];
+    }
+  },
+  async realpath(path) {
+    return realpath3(path).catch(() => null);
+  },
+  async readText(path) {
+    try {
+      if (!(await lstat(path)).isFile()) return null;
+      return await readFile6(path, "utf8");
+    } catch {
+      return null;
+    }
+  }
+};
+var pathFor = (platform) => platform === "win32" ? win32 : posix;
+var usable = (value) => Boolean(value?.trim()) && !value?.trim().startsWith("${");
+async function xdgUserDir(key, opts, fs) {
+  const fromEnv2 = opts.env[`XDG_${key}_DIR`];
+  if (usable(fromEnv2)) return fromEnv2;
+  const configHome = opts.env.XDG_CONFIG_HOME || posix.join(opts.home, ".config");
+  const text2 = await fs.readText(posix.join(configHome, "user-dirs.dirs"));
+  const match = text2?.match(new RegExp(`^XDG_${key}_DIR="([^"]*)"`, "m"));
+  if (!match?.[1]) return void 0;
+  return match[1].replace(/^\$HOME(?=\/|$)/, opts.home);
+}
+async function searchRoots(opts) {
+  const fs = opts.fs ?? nodeFs;
+  const p = pathFor(opts.platform);
+  const { home, env, platform } = opts;
+  const userHome = platform === "win32" && usable(env.USERPROFILE) ? env.USERPROFILE : home;
+  const roots = [];
+  const add = (label, path, depth, sessions = false) => {
+    if (!path) return;
+    const norm = p.resolve(path);
+    if (roots.some((r) => r.path === norm)) return;
+    roots.push({ label, path: norm, depth, ...sessions ? { sessions } : {} });
+  };
+  const cwd = p.resolve(opts.cwd);
+  if (cwd !== p.parse(cwd).root && cwd !== p.resolve(userHome)) add("current folder", cwd, 4);
+  const configured = usable(opts.downloadsDir) ? opts.downloadsDir : usable(env[DOWNLOADS_DIR_ENV]) ? env[DOWNLOADS_DIR_ENV] : void 0;
+  const defaultDownloads = platform === "linux" ? await xdgUserDir("DOWNLOAD", opts, fs) ?? p.join(home, "Downloads") : p.join(userHome, "Downloads");
+  add("Downloads", configured ? expandHome(configured, home, platform) : defaultDownloads, 3);
+  add("Downloads", defaultDownloads, 3);
+  const desktop = platform === "linux" ? await xdgUserDir("DESKTOP", opts, fs) ?? p.join(home, "Desktop") : p.join(userHome, "Desktop");
+  add("Desktop", desktop, 3);
+  if (platform === "win32" && usable(env.OneDrive))
+    add("Desktop", p.join(env.OneDrive, "Desktop"), 3);
+  const documents = platform === "linux" ? await xdgUserDir("DOCUMENTS", opts, fs) ?? p.join(home, "Documents") : p.join(userHome, "Documents");
+  add("Documents/Claude", p.join(documents, "Claude"), 4);
+  add("~/Claude", p.join(userHome, "Claude"), 4);
+  const claudeConfig = platform === "darwin" ? p.join(home, "Library", "Application Support", "Claude") : platform === "win32" ? p.join(
+    usable(env.APPDATA) ? env.APPDATA : p.join(userHome, "AppData", "Roaming"),
+    "Claude"
+  ) : p.join(env.XDG_CONFIG_HOME || p.join(home, ".config"), "Claude");
+  add(
+    "Claude Desktop outputs",
+    p.join(claudeConfig, "local-agent-mode-sessions"),
+    SESSIONS_DEPTH,
+    true
+  );
+  if (!fs.realpath) return roots;
+  const real = [];
+  for (const root of roots) {
+    const path = await fs.realpath(root.path) ?? root.path;
+    if (!real.some((r) => r.path === path)) real.push({ ...root, path });
+  }
+  return real;
+}
+function expandHome(input, home, platform) {
+  if (input === "~") return home;
+  if (input.startsWith("~/") || platform === "win32" && input.startsWith("~\\"))
+    return pathFor(platform).join(home, input.slice(2));
+  return input;
+}
+async function walk(roots, opts, visit) {
+  const fs = opts.fs ?? nodeFs;
+  const p = pathFor(opts.platform);
+  const now = opts.now ?? Date.now;
+  const deadline = now() + (opts.timeBudgetMs ?? 4e3);
+  let budget = opts.entryBudget ?? 6e4;
+  const skip = (name) => name.startsWith(".") || SKIP_DIRS.has(name);
+  const expanded = [];
+  for (const root of roots) {
+    if (!root.sessions) {
+      expanded.push(root);
+      continue;
+    }
+    let level = [root.path];
+    for (let depth = 0; depth < root.depth && level.length; depth++) {
+      const next = [];
+      for (const dir of level) {
+        for (const e of await fs.readdir(dir)) {
+          if (!e.isDirectory || skip(e.name) || SESSION_SKIP_DIRS.has(e.name)) continue;
+          const child = p.join(dir, e.name);
+          if (e.name === "outputs")
+            expanded.push({ label: root.label, path: child, depth: OUTPUTS_DEPTH });
+          else next.push(child);
+        }
+      }
+      level = next;
+    }
+  }
+  for (const root of expanded) {
+    let level = [root.path];
+    for (let depth = 0; depth <= root.depth && level.length; depth++) {
+      const next = [];
+      for (const dir of level) {
+        if (now() > deadline || budget <= 0) return { complete: false };
+        const entries = await fs.readdir(dir);
+        budget -= entries.length;
+        for (const entry of entries) {
+          if (entry.name.startsWith(".")) continue;
+          const path = p.join(dir, entry.name);
+          const result = await visit({ root, path, entry, siblings: entries });
+          if (entry.isDirectory && !skip(entry.name) && result !== "skip" && depth < root.depth)
+            next.push(path);
+        }
+      }
+      level = next;
+    }
+  }
+  return { complete: true };
+}
+function withoutDuplicateSuffix(name) {
+  return name.replace(/ \(\d+\)(?=\.[^.]+$|$)/, "");
 }
-async function runVersions(ctx, name) {
-  const site = await getSite(requireClient(ctx), name);
-  ctx.out.data(
-    { name: site.name, currentVersionId: site.currentVersionId, versions: site.versions },
-    () => renderTable(site.versions, [
-      { header: "", value: (v) => v.id === site.currentVersionId ? "*" : " " },
-      { header: "VERSION", value: (v) => v.id },
-      { header: "FILES", value: (v) => v.fileCount },
-      { header: "SIZE", value: (v) => formatBytes(v.totalBytes) },
-      { header: "CREATED", value: (v) => formatDate(v.createdAt) }
-    ])
-  );
+function namesMatch(candidate, wanted) {
+  const a = candidate.toLowerCase();
+  const b = wanted.toLowerCase();
+  return a === b || withoutDuplicateSuffix(a) === withoutDuplicateSuffix(b);
 }
-async function runFiles(ctx, name, versionId) {
-  const result = await versionFiles(requireClient(ctx), name, versionId);
-  if (!result.files.some((f) => f.path === "index.html")) {
-    ctx.log.warn("No index.html at the root \u2014 the site root URL will 404");
+var splitSegments = (path) => path.split(/[\\/]+/).filter((s) => s !== "" && s !== "." && s !== "~");
+function suffixScore(path, wanted) {
+  const have = splitSegments(path);
+  let score = 1;
+  for (let i = 2; i <= Math.min(have.length, wanted.length); i++) {
+    if (have[have.length - i]?.toLowerCase() !== wanted[wanted.length - i]?.toLowerCase()) break;
+    score++;
   }
-  ctx.out.data(result, () => {
-    const n = result.files.length;
-    const header = chalk6.dim(
-      `${result.versionId}${result.current ? " (current)" : " (not served)"} \u2014 ${n} file${n === 1 ? "" : "s"}, ${formatBytes(result.totalBytes)}${result.generatedIndex ? ", generated index.html" : ""}`
-    );
-    const table = renderTable(result.files, [
-      { header: "PATH", value: (f) => f.path },
-      { header: "SIZE", value: (f) => formatBytes(f.size) },
-      { header: "TYPE", value: (f) => f.contentType }
-    ]);
-    return `${header}
-${table}`;
-  });
-}
-async function runRollback(ctx, name, versionId) {
-  const site = await rollback(requireClient(ctx), name, versionId);
-  ctx.log.success(`${name} now serves version ${site.currentVersionId ?? versionId}`);
-  ctx.out.data(site, () => site.url);
+  return score;
 }
-async function runShare(ctx, name, opts) {
-  if (opts.refresh && opts.revoke) throw new CliError("Use either --refresh or --revoke, not both");
-  const client = requireClient(ctx);
-  const result = await share(client, name, opts);
-  let ready;
-  if (result.action === "created" || result.action === "refreshed") {
-    const files = ctx.waitReady ? await versionFiles(client, name).catch(() => null) : null;
-    ready = (await waitWithSpinner(ctx.waitReady, result.shareUrl, files?.files.map((f) => f.path) ?? [], {
-      progress: ctx.progress,
-      warn: (m) => ctx.log.warn(m)
-    })).ready;
+var looksLikeSandboxPath = (input) => SANDBOX_PATH_RE.test(input.replace(/\\/g, "/"));
+function normaliseInput(raw, opts) {
+  let input = raw.trim().replace(/^(["'])(.*)\1$/, "$2");
+  if (input.startsWith("file://")) {
+    try {
+      input = fileURLToPath(input, { windows: opts.platform === "win32" });
+    } catch {
+      input = decodeURIComponent(input.slice("file://".length));
+    }
   }
-  if (result.action === "revoked") ctx.log.success(`Share link for ${name} revoked`);
-  else if (result.action === "refreshed")
-    ctx.log.success("New share link \u2014 the old one no longer works");
-  else if (result.action === "created")
-    ctx.log.success("Share link created \u2014 anyone with it can view the site");
-  ctx.out.data(
-    ready === void 0 ? result : { ...result, ready },
-    () => result.shareUrl ? result.shareUrl : chalk6.dim("(no share link)")
-  );
+  return expandHome(input, opts.home, opts.platform);
 }
-async function runVisibility(ctx, name, visibility) {
-  if (visibility !== "private" && visibility !== "public") {
-    throw new CliError(`Visibility must be "private" or "public", not "${visibility}"`);
+async function resolveInput(input, opts) {
+  const fs = opts.fs ?? nodeFs;
+  const p = pathFor(opts.platform);
+  const given = normaliseInput(input, opts);
+  if (!given) throw new CliError("No path given");
+  const direct = p.isAbsolute(given) ? p.normalize(given) : p.resolve(opts.cwd, given);
+  const directStat = await fs.stat(direct);
+  if (directStat && (directStat.isFile || directStat.isDirectory)) {
+    return {
+      path: direct,
+      foundIn: FOUND_AS_GIVEN,
+      isDirectory: directStat.isDirectory,
+      alternatives: []
+    };
   }
-  const site = await setVisibility(requireClient(ctx), name, visibility);
-  ctx.log.success(
-    site.visibility === "public" ? `${name} is public \u2014 no sign-in needed` : `${name} is private \u2014 Nearform sign-in required`
-  );
-  ctx.out.data(site, () => site.url);
+  const wanted = splitSegments(given);
+  const name = wanted.at(-1);
+  const roots = await searchRoots(opts);
+  if (!name) throw notFound(input, roots);
+  const found = [];
+  const seen = /* @__PURE__ */ new Set();
+  await walk(roots, opts, async ({ root, path, entry }) => {
+    if (!(entry.isFile || entry.isDirectory) || !namesMatch(entry.name, name)) return;
+    if (seen.has(path)) return;
+    seen.add(path);
+    const s = await fs.stat(path);
+    if (!s) return;
+    found.push({
+      path,
+      foundIn: root.label,
+      kind: s.isDirectory ? "folder" : "file",
+      modified: new Date(s.mtimeMs).toISOString(),
+      size: s.size,
+      score: suffixScore(path, wanted),
+      mtimeMs: s.mtimeMs,
+      isDirectory: s.isDirectory
+    });
+    return void 0;
+  });
+  if (found.length === 0) throw notFound(input, roots);
+  found.sort((a, b) => b.score - a.score || b.mtimeMs - a.mtimeMs);
+  const strip = ({ score: _s, mtimeMs: _m, isDirectory: _d, ...c }) => c;
+  const [best, ...rest] = found;
+  return {
+    path: best.path,
+    foundIn: best.foundIn,
+    isDirectory: best.isDirectory,
+    alternatives: rest.slice(0, 5).map(strip)
+  };
 }
-async function runArchive(ctx, name, unarchive = false) {
-  const site = await archiveSite(requireClient(ctx), name, { unarchive });
-  ctx.log.success(
-    unarchive ? `${name} restored` : `${name} archived \u2014 it 404s until \`fling unarchive ${name}\``
-  );
-  if (ctx.json) ctx.out.data(site, () => "");
-  else if (unarchive) ctx.out.text(site.url);
+function notFound(input, roots) {
+  const where = roots.map((r) => `${r.label} (${r.path})`).join(", ");
+  const sandbox = looksLikeSandboxPath(input) ? " That looks like a path inside Claude\u2019s sandbox, which this computer cannot see: publish the content inline with fling_publish, or save/download the file to this computer first." : "";
+  return new CliError(`Could not find "${input}". Looked for it by name in: ${where}.${sandbox}`, {
+    hint: "Pass the full path, or save the file to your Downloads folder and use just its name."
+  });
 }
-async function runRemove(ctx, name, opts) {
-  if (!opts.yes) {
-    if (!ctx.interactive) {
-      throw new CliError(`Refusing to delete ${name} without confirmation`, {
-        hint: "Pass --yes to delete."
-      });
+var LISTED_EXT = /\.(html?|zip)$/i;
+async function findFiles(opts, find = {}) {
+  const fs = opts.fs ?? nodeFs;
+  const p = pathFor(opts.platform);
+  const now = (opts.now ?? Date.now)();
+  const since = now - (find.days ?? 14) * 24 * 60 * 60 * 1e3;
+  const query = find.query?.trim().toLowerCase();
+  const roots = await searchRoots(opts);
+  const found = /* @__PURE__ */ new Map();
+  const rootPaths = new Set(roots.map((r) => r.path));
+  const { complete } = await walk(roots, opts, async ({ root, path, entry }) => {
+    if (entry.isDirectory) {
+      if (rootPaths.has(path)) return;
+      const index = (await fs.readdir(path)).find((e) => e.isFile && /^index\.html?$/i.test(e.name));
+      if (!index) return;
+      const s2 = await fs.stat(p.join(path, index.name));
+      if (s2 && s2.mtimeMs >= since && (!query || entry.name.toLowerCase().includes(query)))
+        found.set(path, {
+          path,
+          foundIn: root.label,
+          kind: "folder",
+          modified: new Date(s2.mtimeMs).toISOString(),
+          size: s2.size,
+          mtimeMs: s2.mtimeMs
+        });
+      return "skip";
     }
-    const ok = await ctx.confirm(`Delete ${name} and every version of it? This cannot be undone.`);
-    if (!ok) throw new CliError("Cancelled");
-  }
-  const result = await deleteSite(requireClient(ctx), name);
-  ctx.log.success(`${name} deleted`);
-  if (ctx.json) ctx.out.data(result, () => "");
+    if (!entry.isFile || !LISTED_EXT.test(entry.name)) return;
+    if (query && !entry.name.toLowerCase().includes(query)) return;
+    const s = await fs.stat(path);
+    if (!s || s.mtimeMs < since || found.has(path)) return;
+    found.set(path, {
+      path,
+      foundIn: root.label,
+      kind: "file",
+      modified: new Date(s.mtimeMs).toISOString(),
+      size: s.size,
+      mtimeMs: s.mtimeMs
+    });
+    return void 0;
+  });
+  const files = [...found.values()].sort((a, b) => b.mtimeMs - a.mtimeMs).slice(0, find.limit ?? 20).map(({ mtimeMs: _m, ...c }) => c);
+  return { files, searched: roots, complete };
 }
 
 // src/mcp.ts
-import { mkdir as mkdir3, mkdtemp as mkdtemp2, rm as rm2, writeFile as writeFile3 } from "node:fs/promises";
-import { tmpdir as tmpdir2 } from "node:os";
-import { basename as basename3, dirname as dirname2, join as join5 } from "node:path";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { z as z7 } from "zod";
 var LOGIN_HINT = `Not logged in to Fling. Call fling_login (it opens the browser to sign in with Nearform Google), or ask the user to run \`${NPX_COMMAND} login\` in a terminal (in Claude Code: \`! ${NPX_COMMAND} login\`), then try again.`;
 var MCP_LOCAL_INSTRUCTIONS = [
   "Fling publishes static sites (HTML/CSS/JS, images, documents) for Nearform staff at https://<name>.fling.labs.nearform.com. This server runs on the user's computer.",
@@ -3080,7 +3350,7 @@ ${JSON.stringify(data, null, 2)}` }]
     },
     (args) => run(async (c) => {
       const name = resolveSiteName(".", args.name);
-      const tmp = await mkdtemp2(join5(tmpdir2(), "fling-publish-"));
+      const tmp = await mkdtemp3(join6(tmpdir3(), "fling-publish-"));
       try {
         const { skippedDotfiles } = await writeInlineFiles(tmp, args.files);
         const outcome = await deployFolder(c, tmp, {
@@ -3117,20 +3387,20 @@ ${JSON.stringify(data, null, 2)}` }]
         source = await resolveInput(args.path, locate);
         name = defaultNameFor(source.path, source.isDirectory);
       }
-      const check = await checkName(c, name);
-      const base = check.status === "invalid" ? null : await discoverSitesBase(c);
+      const check2 = await checkName(c, name);
+      const base = check2.status === "invalid" ? null : await discoverSitesBase(c);
       const url = base ? siteUrlFor(name, base) : null;
-      const suggestions = check.suggestions.length ? ` Suggestions: ${check.suggestions.join(", ")}.` : "";
+      const suggestions = check2.suggestions.length ? ` Suggestions: ${check2.suggestions.join(", ")}.` : "";
       const summary = {
         available: `"${name}" is available${url ? ` \u2192 ${url}` : ""}.`,
         yours: `"${name}" is the user's existing site${url ? ` (${url})` : ""} \u2014 deploying updates it.`,
         taken: `"${name}" is taken by someone else.${suggestions}`,
         invalid: `"${name}" is not a valid site name.${suggestions}`
-      }[check.status];
+      }[check2.status];
       return {
         summary,
         data: {
-          ...check,
+          ...check2,
           url,
           ...source ? { generated: true, source: { path: source.path, foundIn: source.foundIn } } : {}
         }
@@ -3298,7 +3568,7 @@ ${JSON.stringify(data, null, 2)}` }]
   );
   return server;
 }
-var textResult = (text) => ({ content: [{ type: "text", text }] });
+var textResult = (text2) => ({ content: [{ type: "text", text: text2 }] });
 async function writeInlineFiles(dir, files) {
   const seen = /* @__PURE__ */ new Set();
   const skippedDotfiles = [];
@@ -3322,9 +3592,9 @@ async function writeInlineFiles(dir, files) {
     total += bytes.length;
     if (total > MAX_DEPLOY_BYTES)
       throw new CliError(`The site is larger than ${formatBytes(MAX_DEPLOY_BYTES)}`);
-    const target = join5(dir, ...path.split("/"));
+    const target = join6(dir, ...path.split("/"));
     await mkdir3(dirname2(target), { recursive: true });
-    await writeFile3(target, bytes);
+    await writeFile4(target, bytes);
   }
   if (secretFiles.length > 0) throw new SecretFilesError(secretFiles);
   return { skippedDotfiles };
@@ -3342,24 +3612,83 @@ async function runMcpServer(deps = {}) {
   await server.connect(new StdioServerTransport());
 }
 
+// src/route.ts
+import { stat as stat6 } from "node:fs/promises";
+import { resolve as resolve4 } from "node:path";
+var PASS_THROUGH = /* @__PURE__ */ new Set(["-h", "--help", "-V", "--version"]);
+var pathExists = (path) => stat6(resolve4(path)).then(
+  () => true,
+  () => false
+);
+async function routeArgs(args, opts) {
+  const exists = opts.exists ?? pathExists;
+  let first;
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === "--") {
+      first = args[i + 1];
+      break;
+    }
+    if (arg.startsWith("-")) {
+      if (PASS_THROUGH.has(arg)) return { kind: "run", args: [...args] };
+      if (opts.valueFlags.has(arg)) i++;
+      continue;
+    }
+    first = arg;
+    break;
+  }
+  if (first === void 0) return { kind: "help" };
+  if (await exists(first)) return { kind: "run", args: ["deploy", ...args] };
+  if (opts.commands.has(first)) return { kind: "run", args: [...args] };
+  return { kind: "unknown", arg: first };
+}
+function routeOptionsFor(program2) {
+  const commands = /* @__PURE__ */ new Set(["help"]);
+  const valueFlags = /* @__PURE__ */ new Set();
+  const addFlags = (command) => {
+    for (const option of command.options)
+      if (option.required || option.optional) {
+        for (const flag of [option.short, option.long]) if (flag) valueFlags.add(flag);
+      }
+  };
+  addFlags(program2);
+  for (const command of program2.commands) {
+    commands.add(command.name());
+    for (const alias of command.aliases()) commands.add(alias);
+    addFlags(command);
+  }
+  return { commands, valueFlags };
+}
+
 // src/cli.ts
 var program = new Command();
 program.name(BIN_NAME).description("Fling a folder of static files at Fling and get a link back").version(VERSION).option(
   "--server <url>",
   `server URL (default: $${ENV.url} or config, else ${DEFAULT_SERVER_URL})`
-).option("--json", "print JSON instead of human output", false).showHelpAfterError().addHelpText(
+).option("--json", "print JSON instead of human output", false).showHelpAfterError().configureHelp({
+  sortSubcommands: false,
+  styleTitle: (title) => chalk9.bold(brand.primary(title)),
+  styleCommandText: (text2) => chalk9.bold(text2),
+  styleSubcommandText: (text2) => brand.accent(text2),
+  styleOptionText: (text2) => brand.accent(text2),
+  styleArgumentText: (text2) => chalk9.dim(text2)
+}).addHelpText(
+  "before",
+  () => process.stdout.isTTY ? logo({ columns: process.stdout.columns }) : ""
+).addHelpText(
   "after",
-  `
-Examples:
-  $ ${BIN_NAME} login
-  $ ${BIN_NAME} ./dist --name my-app     deploy \u2192 https://my-app.fling.labs.nearform.com
-  $ ${BIN_NAME} ./dist --yes             no prompts (CI): use the generated name, fail if it is taken
-  $ ${BIN_NAME} "Pitch Deck.html"        a single page; found in Downloads if it is not here
-  $ ${BIN_NAME} site.zip                 a zip of a site
-  $ ${BIN_NAME} share my-app             public link for people outside Nearform
+  () => `
+${chalk9.bold(brand.primary("Examples:"))}
+  $ ${BIN_NAME} setup                      sign in and add Fling to Claude Code / Claude Desktop
+  $ ${BIN_NAME} deploy ./dist --name my-app \u2192 https://my-app.fling.labs.nearform.com
+  $ ${BIN_NAME} ./dist                     the same: an existing path deploys
+  $ ${BIN_NAME} ./dist --yes               no prompts (CI): use the generated name, fail if it is taken
+  $ ${BIN_NAME} "Pitch Deck.html"          a single page
+  $ ${BIN_NAME} site.zip                   a zip of a site
+  $ ${BIN_NAME} share my-app               public link for people outside Nearform
 
-Exit codes: 0 ok \xB7 1 error \xB7 2 not logged in \xB7 3 forbidden
-Env:        ${ENV.apiKey} \xB7 ${ENV.url} \xB7 ${ENV.configDir} \xB7 ${ENV.debug}`
+${chalk9.dim(`Exit codes: 0 ok \xB7 1 error \xB7 2 not logged in \xB7 3 forbidden
+Env:        ${ENV.apiKey} \xB7 ${ENV.url} \xB7 ${ENV.configDir} \xB7 ${ENV.debug}`)}`
 );
 function action(handler) {
   return async (...args) => {
@@ -3397,8 +3726,8 @@ function report(error, ctx) {
     );
   }
 }
-program.command("deploy [path]", { isDefault: true }).description(
-  "deploy a folder (default: .), a single .html file, a .zip or any file \u2014 the default command, so `fling ./dist` works. A path that does not exist is looked up by name in Downloads, Desktop and Claude output folders"
+program.command("deploy [path]").helpGroup("Deploy:").description(
+  "deploy a folder (default: .), a single .html file, a .zip or any file. `fling <path>` is short for it"
 ).option(
   "-n, --name <name>",
   "site name \u2014 names are global, first come first served (default: generated from the project and folder, e.g. rocketpod-docs; you confirm it on a terminal)"
@@ -3410,28 +3739,54 @@ program.command("deploy [path]", { isDefault: true }).description(
     (ctx, path, opts) => runDeploy(ctx, path, opts)
   )
 );
-program.command("login").description("sign in through the browser and store an API key").action(action((ctx) => runLogin(ctx)));
-program.command("logout").description("remove the stored API key").action(action((ctx) => runLogout(ctx)));
-program.command("whoami").description("show the signed-in user").action(action((ctx) => runWhoami(ctx)));
-program.command("ls").alias("list").description("list your sites").option("--archived", "list archived sites").action(action((ctx, opts) => runList(ctx, opts)));
-program.command("info <name>").description("show a site").action(action((ctx, name) => runInfo(ctx, name)));
-program.command("versions <name>").description("list a site's versions (* = live)").action(action((ctx, name) => runVersions(ctx, name)));
-program.command("files <name> [versionId]").description("list the files in a site's live version (or in versionId)").action(
+program.command("setup").helpGroup("Setup:").description(
+  "sign in, then add the Fling plugin to Claude Code and the extension to Claude Desktop"
+).option("-y, --yes", "do every step without asking").option("-s, --scope <scope>", "Claude Code plugin scope: user, project or local", "user").action(action((ctx, opts) => runSetup(ctx, opts)));
+program.command("login").helpGroup("Setup:").description("sign in through the browser and store an API key").action(
+  action(async (ctx) => {
+    await runLogin(ctx);
+    ctx.log.hint(`Next: \`${BIN_NAME} setup\` adds Fling to Claude Code and Claude Desktop.`);
+  })
+);
+program.command("logout").helpGroup("Setup:").description("remove the stored API key").action(action((ctx) => runLogout(ctx)));
+program.command("whoami").helpGroup("Setup:").description("show the signed-in user").action(action((ctx) => runWhoami(ctx)));
+program.commandsGroup("Setup:").helpCommand("help [command]", "show help for a command");
+program.command("ls").helpGroup("Sites:").alias("list").description("list your sites").option("--archived", "list archived sites").action(action((ctx, opts) => runList(ctx, opts)));
+program.command("info <name>").helpGroup("Sites:").description("show a site").action(action((ctx, name) => runInfo(ctx, name)));
+program.command("versions <name>").helpGroup("Sites:").description("list a site's versions (* = live)").action(action((ctx, name) => runVersions(ctx, name)));
+program.command("files <name> [versionId]").helpGroup("Sites:").description("list the files in a site's live version (or in versionId)").action(
   action((ctx, name, versionId) => runFiles(ctx, name, versionId))
 );
-program.command("rollback <name> <versionId>").description("serve an earlier version again").action(action((ctx, name, versionId) => runRollback(ctx, name, versionId)));
-program.command("share <name>").description("print (or create) a public share link \u2014 anyone with it can view the site").option("--refresh", "replace the link; the old one stops working").option("--revoke", "remove the link").action(
+program.command("rollback <name> <versionId>").helpGroup("Sites:").description("serve an earlier version again").action(action((ctx, name, versionId) => runRollback(ctx, name, versionId)));
+program.command("share <name>").helpGroup("Sites:").description("print (or create) a public share link \u2014 anyone with it can view the site").option("--refresh", "replace the link; the old one stops working").option("--revoke", "remove the link").action(
   action(
     (ctx, name, opts) => runShare(ctx, name, opts)
   )
 );
-program.command("visibility <name> <visibility>").description("private (Nearform sign-in) or public (anyone)").action(action((ctx, name, visibility) => runVisibility(ctx, name, visibility)));
-program.command("archive <name>").description("take a site offline (404) but keep its files; undo with unarchive").action(action((ctx, name) => runArchive(ctx, name)));
-program.command("unarchive <name>").description("bring an archived site back").action(action((ctx, name) => runArchive(ctx, name, true)));
-program.command("rm <name>").alias("delete").description("delete a site and all its versions (asks first unless --yes)").option("-y, --yes", "do not ask for confirmation").action(action((ctx, name, opts) => runRemove(ctx, name, opts)));
-program.command("mcp").description("run the MCP server on stdio (used by the Claude Code plugin)").action(async (_opts, command) => {
+program.command("visibility <name> <visibility>").helpGroup("Sites:").description("private (Nearform sign-in) or public (anyone)").action(action((ctx, name, visibility) => runVisibility(ctx, name, visibility)));
+program.command("archive <name>").helpGroup("Sites:").description("take a site offline (404) but keep its files; undo with unarchive").action(action((ctx, name) => runArchive(ctx, name)));
+program.command("unarchive <name>").helpGroup("Sites:").description("bring an archived site back").action(action((ctx, name) => runArchive(ctx, name, true)));
+program.command("rm <name>").helpGroup("Sites:").alias("delete").description("delete a site and all its versions (asks first unless --yes)").option("-y, --yes", "do not ask for confirmation").action(action((ctx, name, opts) => runRemove(ctx, name, opts)));
+program.command("mcp").helpGroup("Agents:").description("run the MCP server on stdio (used by the Claude Code plugin)").action(async (_opts, command) => {
   const globals = command.optsWithGlobals();
   await runMcpServer({ server: globals.server });
 });
-program.parseAsync(process.argv);
+async function main() {
+  const route = await routeArgs(process.argv.slice(2), routeOptionsFor(program));
+  if (route.kind === "help") {
+    program.outputHelp();
+    return;
+  }
+  if (route.kind === "unknown") {
+    const log = createLogger();
+    log.error(`"${route.arg}" is not a command, file or folder`);
+    log.hint(
+      `Run \`${BIN_NAME} --help\` for the commands, or \`${BIN_NAME} deploy <path>\` to deploy.`
+    );
+    process.exitCode = 1;
+    return;
+  }
+  await program.parseAsync(route.args, { from: "user" });
+}
+await main();
 //# sourceMappingURL=cli.js.map