@amdahl/cli 0.2.4 → 0.3.0

package/README.md

@@ -56,10 +56,48 @@ amdahl login
 `npx @amdahl/cli ...`. That package ([packages/amdahl](packages/amdahl)) has no
 code of its own: it depends on `@amdahl/cli` at the same version and runs it.
 
-To connect an AI client, run `amdahl install claude-code` (or `codex`,
+The quickest way to start is `npx amdahl` with nothing after it, in a
+terminal. It walks you through setup:
+
+```
+Amdahl, predictive ML for GTM
+Found on this machine: Claude Code ✓  Cursor ✓  Codex –
+Set up Amdahl in:
+> [x] Claude Code
+  [x] Cursor
+  [ ] Codex
+(Use the arrow keys, Space to tick or untick, then Enter)
+```
+
+It finds Claude Code, Cursor and Codex by their command on your PATH
+(`claude`, `cursor`, `codex`) or their folder in your home folder (`.claude`,
+`.cursor`, `.codex`), and ticks the ones it finds. Enter accepts. If you are
+not signed in, it signs you in through the browser first; otherwise it prints
+`Signed in as <email> (workspace: <name>)`. If the server rejects a key set in
+`AMDAHL_KEY` (or `AMDAHL_API_KEY`, `AMDAHL_ACCESS_TOKEN`, `--api-key`), it says
+so and skips the browser sign-in, since that key would still win. Then it
+runs `amdahl install` for each client you ticked. A client that fails prints
+its error and the rest still run; the exit code is the first failure's. It
+ends with something to try, such as
+`Try it: open Claude Code and say "make this email sound less like AI"`
+(for Codex, it first says to run `codex mcp login amdahl`).
+Run it again once you are set up and it says `You're set up in Claude Code
+and Cursor.` with the same line to try, and asks nothing; if it cannot reach
+Amdahl to check your sign-in, it still says so. Ctrl+C at the question stops
+it with nothing written (exit 130).
+
+It only does this for a person at a terminal. When stdin, stdout or stderr
+(where the menu draws) is not a terminal, `CI` is set, an agent runs it (`CLAUDECODE` or `CURSOR_AGENT` is
+set), `AMDAHL_NO_PROMPT=1` is set, or any flag is given (such as `--json`),
+bare `amdahl` prints the usage to stderr and exits 2, as before.
+
+To connect one AI client yourself, run `amdahl install claude-code` (or `codex`,
 `cursor`). It adds the Amdahl MCP server and also installs the Amdahl skill,
 a map of everything Amdahl can do, so your agent knows which tool fits each
-job. The skill goes to the client's user skills folder:
+job. If the client already points at Amdahl, `install` leaves that as it is
+(for Claude Code it skips `claude mcp add` when `claude mcp get amdahl`
+shows the same URL) and still installs the skill. If it cannot write the
+client's config file, it exits 1 with `write_failed` and names the file. The skill goes to the client's user skills folder:
 
 | client | skill file |
 |---|---|
@@ -77,6 +115,7 @@ https://docs.amdahl.ai/skills/amdahl/SKILL.md.
 ## Quick start
 
 ```sh
+amdahl                       # in a terminal: guided setup for Claude Code, Cursor and Codex
 amdahl login                 # sign in through the browser with your console account
 amdahl whoami                # the account, workspace and role you are signed in as
 amdahl status                # can this workspace optimize, and what blocks it
@@ -93,6 +132,7 @@ On a server or in CI, skip `login` and set an API key in `AMDAHL_KEY`.
 ## Commands
 
 ```
+amdahl                                                           (guided setup, in a terminal)
 amdahl login   [--workspace <slug>] [--no-browser] [--port <n>]   (alias: auth login)
 amdahl logout  [--all]                                           (alias: auth logout)
 amdahl whoami  [--show-token]                                    (alias: auth status)

package/dist/amdahl.js

@@ -7371,26 +7371,25 @@ import { createInterface } from "readline";
 // src/select.ts
 import { emitKeypressEvents } from "readline";
 var HINT = "(Use the arrow keys, then Enter)";
+var MULTI_HINT = "(Use the arrow keys, Space to tick or untick, then Enter)";
+var OFF = "\x1B[0m";
 var HIDE_CURSOR = "\x1B[?25l";
 var SHOW_CURSOR = "\x1B[?25h";
 var CLEAR_LINE = "\x1B[2K";
 var CLEAR_DOWN = "\x1B[0J";
 var up = (n) => `\x1B[${n}A`;
-function selectMenu(input, output, question, choices, options = {}) {
-  let current = Math.min(Math.max(options.initial ?? 0, 0), choices.length - 1);
-  const on = options.color ? options.trueColor ? "\x1B[1;38;2;253;75;3m" : "\x1B[1;38;5;202m" : "\x1B[1m";
-  const off = "\x1B[0m";
-  const row = (i) => i === current ? `${on}> ${choices[i]}${off}` : `  ${choices[i]}`;
-  const draw = () => choices.map((_, i) => `${CLEAR_LINE}\r${row(i)}
-`).join("") + `${CLEAR_LINE}\r${HINT}
+function runMenu(input, output, question, hint, rows, onKey) {
+  const draw = () => rows().map((r) => `${CLEAR_LINE}\r${r}
+`).join("") + `${CLEAR_LINE}\r${hint}
 `;
+  const height = rows().length;
   const wasRaw = input.isRaw === true;
   return new Promise((resolve, reject) => {
     let done = false;
     const finish = (outcome) => {
       if (done) return;
       done = true;
-      input.removeListener("keypress", onKey);
+      input.removeListener("keypress", onKeypress);
       input.removeListener("error", onError);
       process.removeListener("SIGINT", onSigint);
       try {
@@ -7399,7 +7398,7 @@ function selectMenu(input, output, question, choices, options = {}) {
       }
       input.pause();
       if ("pick" in outcome) {
-        output.write(`${up(choices.length + 2)}\r${CLEAR_DOWN}${question} ${choices[outcome.pick]}
+        output.write(`${up(height + 2)}\r${CLEAR_DOWN}${question} ${outcome.summary}
 ${SHOW_CURSOR}`);
         resolve(outcome.pick);
       } else {
@@ -7407,17 +7406,12 @@ ${SHOW_CURSOR}`);
         reject(outcome.error);
       }
     };
-    const onKey = (text, key) => {
+    const onKeypress = (text, key) => {
       const name = key?.name ?? text;
       if (key?.ctrl && (name === "c" || name === "d")) return finish({ error: new PromptCancelled() });
-      if (name === "return" || name === "enter") return finish({ pick: current });
-      let next = current;
-      if (name === "up" || name === "k") next = (current - 1 + choices.length) % choices.length;
-      else if (name === "down" || name === "j") next = (current + 1) % choices.length;
-      else if (text && /^[1-9]$/.test(text) && Number(text) <= choices.length) next = Number(text) - 1;
-      if (next === current) return;
-      current = next;
-      output.write(`${up(choices.length + 1)}${draw()}`);
+      const result = onKey(text, name);
+      if (result === "redraw") output.write(`${up(height + 1)}${draw()}`);
+      else if (result) finish(result);
     };
     const onError = (err) => finish({ error: err });
     const onSigint = () => finish({ error: new PromptCancelled() });
@@ -7426,7 +7420,7 @@ ${SHOW_CURSOR}`);
       input.setRawMode?.(true);
       output.write(`${HIDE_CURSOR}${question}
 ${draw()}`);
-      input.on("keypress", onKey);
+      input.on("keypress", onKeypress);
       input.on("error", onError);
       process.on("SIGINT", onSigint);
       input.resume();
@@ -7435,6 +7429,55 @@ ${draw()}`);
     }
   });
 }
+function marker(options) {
+  return options.color ? options.trueColor ? "\x1B[1;38;2;253;75;3m" : "\x1B[1;38;5;202m" : "\x1B[1m";
+}
+function move(current, count, text, name) {
+  if (name === "up" || name === "k") return (current - 1 + count) % count;
+  if (name === "down" || name === "j") return (current + 1) % count;
+  if (text && /^[1-9]$/.test(text) && Number(text) <= count) return Number(text) - 1;
+  return null;
+}
+function selectMenu(input, output, question, choices, options = {}) {
+  let current = Math.min(Math.max(options.initial ?? 0, 0), choices.length - 1);
+  const on = marker(options);
+  const rows = () => choices.map((c, i) => i === current ? `${on}> ${c}${OFF}` : `  ${c}`);
+  return runMenu(input, output, question, HINT, rows, (text, name) => {
+    if (name === "return" || name === "enter") return { pick: current, summary: choices[current] ?? "" };
+    const next = move(current, choices.length, text, name);
+    if (next === null || next === current) return null;
+    current = next;
+    return "redraw";
+  });
+}
+function multiSelectMenu(input, output, question, choices, options = {}) {
+  let current = 0;
+  const ticked = choices.map((_, i) => options.ticked?.[i] === true);
+  const on = marker(options);
+  const rows = () => choices.map((c, i) => {
+    const row = `[${ticked[i] ? "x" : " "}] ${c}`;
+    return i === current ? `${on}> ${row}${OFF}` : `  ${row}`;
+  });
+  return runMenu(input, output, question, MULTI_HINT, rows, (text, name) => {
+    if (name === "return" || name === "enter") {
+      const picks = choices.flatMap((_, i) => ticked[i] ? [i] : []);
+      return { pick: picks, summary: picks.map((i) => choices[i]).join(", ") || "none" };
+    }
+    if (name === "space") {
+      ticked[current] = !ticked[current];
+      return "redraw";
+    }
+    if (text && /^[1-9]$/.test(text) && Number(text) <= choices.length) {
+      current = Number(text) - 1;
+      ticked[current] = !ticked[current];
+      return "redraw";
+    }
+    const next = move(current, choices.length, text, name);
+    if (next === null || next === current) return null;
+    current = next;
+    return "redraw";
+  });
+}
 
 // src/io.ts
 var PromptCancelled = class extends Error {
@@ -7516,6 +7559,10 @@ function realIo() {
       ...options,
       trueColor: /^(truecolor|24bit)$/i.test(process.env.COLORTERM ?? "")
     }),
+    multiSelect: (question, choices, options) => multiSelectMenu(process.stdin, process.stderr, question, choices, {
+      ...options,
+      trueColor: /^(truecolor|24bit)$/i.test(process.env.COLORTERM ?? "")
+    }),
     uninterruptible,
     run: runProcess,
     openUrl: async (url) => {
@@ -7704,6 +7751,8 @@ function strictParse(argv, options) {
 var USAGE = `Usage: amdahl <command> [options]
 
 What you can do:
+  amdahl                         Set up Claude Code, Cursor or Codex, in a terminal: it asks
+                                 which, signs you in, and runs install for each one
   amdahl optimize draft.md       Rewrite an outbound email or LinkedIn message
   amdahl status                  Check that this workspace is set up to optimize
   amdahl keys create --name ci   Make an API key for a server or CI
@@ -8623,6 +8672,12 @@ function skillPath(client, home) {
 
 // src/commands/install.ts
 var CLIENTS = ["claude-code", "codex", "cursor"];
+function codexConfigPath(home) {
+  return join4(home, ".codex", "config.toml");
+}
+function cursorConfigPath(home) {
+  return join4(home, ".cursor", "mcp.json");
+}
 function codexBlock(mcpUrl) {
   return `[mcp_servers.amdahl]
 url = "${mcpUrl}"
@@ -8637,6 +8692,50 @@ async function onPath(ctx, command) {
   const res = await ctx.io.run(probe, [command]);
   return res.code === 0;
 }
+var CLIENT_SIGNS = {
+  "claude-code": { command: "claude", dir: ".claude" },
+  codex: { command: "codex", dir: ".codex" },
+  cursor: { command: "cursor", dir: ".cursor" }
+};
+async function detectClients(ctx) {
+  const found = await Promise.all(
+    CLIENTS.map(async (client) => {
+      const { command, dir } = CLIENT_SIGNS[client];
+      return existsSync3(join4(ctx.io.homedir, dir)) || await onPath(ctx, command);
+    })
+  );
+  return Object.fromEntries(CLIENTS.map((client, i) => [client, found[i]]));
+}
+async function claudeHasAmdahl(ctx, mcpUrl) {
+  const res = await ctx.io.run("claude", ["mcp", "get", "amdahl"]);
+  return res.code === 0 && res.stdout.split("\n").some((line) => line.trim() === `URL: ${mcpUrl}`);
+}
+function updateConfig(path, fn) {
+  try {
+    return fn();
+  } catch (err) {
+    if (err instanceof CliError) throw err;
+    const reason = err instanceof Error ? err.message : String(err);
+    throw new CliError("write_failed", `Could not update ${path} (${reason}).`, EXIT.general);
+  }
+}
+async function isInstalled(ctx, client) {
+  const skill = skillPath(client, ctx.io.homedir);
+  const current = existsSync3(skill) ? readFileSync3(skill, "utf8") : null;
+  if (current === null || current !== SKILL_TEXT && isShippedSkill(current)) return false;
+  const mcpUrl = `${ctx.apiUrl}/mcp`;
+  if (client === "claude-code") return await onPath(ctx, "claude") && await claudeHasAmdahl(ctx, mcpUrl);
+  if (client === "codex") {
+    const path = codexConfigPath(ctx.io.homedir);
+    return existsSync3(path) && codexHasAmdahl(readFileSync3(path, "utf8"));
+  }
+  try {
+    const config = JSON.parse(readFileSync3(cursorConfigPath(ctx.io.homedir), "utf8"));
+    return JSON.stringify(config.mcpServers?.amdahl) === JSON.stringify({ url: mcpUrl });
+  } catch {
+    return false;
+  }
+}
 async function install(ctx, args) {
   const client = args[0];
   if (!client || args.length > 1 || !CLIENTS.includes(client)) {
@@ -8685,6 +8784,9 @@ async function installMcp(ctx, client, print) {
       const notes = print ? [] : ["`claude` is not on your PATH. Run the command above once it is installed."];
       return { data: { ok: true, client, action: "printed", command }, human: command, notes };
     }
+    if (await claudeHasAmdahl(ctx, mcpUrl)) {
+      return { data: { ok: true, client, action: "unchanged", command }, human: `Claude Code already has Amdahl at ${mcpUrl}; nothing changed.`, notes: [] };
+    }
     const res = await io.run("claude", args);
     if (res.code !== 0) {
       throw new CliError("install_failed", `\`${command}\` failed: ${res.stderr.trim() || `exit ${res.code}`}`, EXIT.general);
@@ -8692,47 +8794,51 @@ async function installMcp(ctx, client, print) {
     return { data: { ok: true, client, action: "ran", command }, human: `Added Amdahl to Claude Code for all your projects. Run /mcp in Claude Code to sign in. If amdahl is not listed there, restart Claude Code first.`, notes: [] };
   }
   if (client === "codex") {
-    const path2 = join4(io.homedir, ".codex", "config.toml");
+    const path2 = codexConfigPath(io.homedir);
     const block = codexBlock(mcpUrl);
     if (print) {
       return { data: { ok: true, client, action: "printed", path: path2 }, human: `# ${path2}
 ${block}`, notes: [] };
     }
-    const current = existsSync3(path2) ? readFileSync3(path2, "utf8") : "";
-    if (codexHasAmdahl(current)) {
-      return { data: { ok: true, client, action: "unchanged", path: path2 }, human: `${path2} already has [mcp_servers.amdahl]; nothing changed.`, notes: [] };
-    }
-    mkdirSync2(dirname(path2), { recursive: true });
-    const sep2 = current.length === 0 ? "" : current.endsWith("\n\n") ? "" : current.endsWith("\n") ? "\n" : "\n\n";
-    writeFileSync2(path2, `${current}${sep2}${block}`);
-    return { data: { ok: true, client, action: "wrote", path: path2 }, human: `Added Amdahl to ${path2}. Run \`codex mcp login amdahl\` to sign in.`, notes: [] };
+    return updateConfig(path2, () => {
+      const current = existsSync3(path2) ? readFileSync3(path2, "utf8") : "";
+      if (codexHasAmdahl(current)) {
+        return { data: { ok: true, client, action: "unchanged", path: path2 }, human: `${path2} already has [mcp_servers.amdahl]; nothing changed.`, notes: [] };
+      }
+      mkdirSync2(dirname(path2), { recursive: true });
+      const sep2 = current.length === 0 ? "" : current.endsWith("\n\n") ? "" : current.endsWith("\n") ? "\n" : "\n\n";
+      writeFileSync2(path2, `${current}${sep2}${block}`);
+      return { data: { ok: true, client, action: "wrote", path: path2 }, human: `Added Amdahl to ${path2}. Run \`codex mcp login amdahl\` to sign in.`, notes: [] };
+    });
   }
-  const path = join4(io.homedir, ".cursor", "mcp.json");
+  const path = cursorConfigPath(io.homedir);
   const entry = { url: mcpUrl };
   if (print) {
     return { data: { ok: true, client, action: "printed", path }, human: `# ${path}
 ${JSON.stringify({ mcpServers: { amdahl: entry } }, null, 2)}`, notes: [] };
   }
-  let config = {};
-  if (existsSync3(path)) {
-    const raw = readFileSync3(path, "utf8");
-    if (raw.trim()) {
-      try {
-        config = JSON.parse(raw);
-      } catch {
-        throw new CliError("invalid_config", `${path} is not valid JSON; not changing it.`, EXIT.general);
+  return updateConfig(path, () => {
+    let config = {};
+    if (existsSync3(path)) {
+      const raw = readFileSync3(path, "utf8");
+      if (raw.trim()) {
+        try {
+          config = JSON.parse(raw);
+        } catch {
+          throw new CliError("invalid_config", `${path} is not valid JSON; not changing it.`, EXIT.general);
+        }
       }
     }
-  }
-  const servers = config.mcpServers && typeof config.mcpServers === "object" ? config.mcpServers : {};
-  if (JSON.stringify(servers.amdahl) === JSON.stringify(entry)) {
-    return { data: { ok: true, client, action: "unchanged", path }, human: `${path} already points at ${mcpUrl}; nothing changed.`, notes: [] };
-  }
-  config.mcpServers = { ...servers, amdahl: entry };
-  mkdirSync2(dirname(path), { recursive: true });
-  writeFileSync2(path, `${JSON.stringify(config, null, 2)}
+    const servers = config.mcpServers && typeof config.mcpServers === "object" ? config.mcpServers : {};
+    if (JSON.stringify(servers.amdahl) === JSON.stringify(entry)) {
+      return { data: { ok: true, client, action: "unchanged", path }, human: `${path} already points at ${mcpUrl}; nothing changed.`, notes: [] };
+    }
+    config.mcpServers = { ...servers, amdahl: entry };
+    mkdirSync2(dirname(path), { recursive: true });
+    writeFileSync2(path, `${JSON.stringify(config, null, 2)}
 `);
-  return { data: { ok: true, client, action: "wrote", path }, human: `Added Amdahl to ${path}. Cursor asks you to sign in on first use.`, notes: [] };
+    return { data: { ok: true, client, action: "wrote", path }, human: `Added Amdahl to ${path}. Cursor asks you to sign in on first use.`, notes: [] };
+  });
 }
 
 // src/keygen.ts
@@ -9008,337 +9114,120 @@ async function optimize(ctx, args) {
   return exit;
 }
 
-// src/commands/skills.ts
-var import_yaml = __toESM(require_dist(), 1);
-import { createHash as createHash4 } from "crypto";
+// src/commands/skills-guide.ts
+import { existsSync as existsSync4 } from "fs";
+import { dirname as dirname3, join as join6, relative, sep } from "path";
 
-// src/output.ts
-var CONTROL_RE = /[\u0000-\u001f\u007f-\u009f]/g;
-function printable(text) {
-  return text.replace(CONTROL_RE, "");
+// src/commands/skills-install.ts
+import { randomBytes as randomBytes3 } from "crypto";
+import { chmodSync as chmodSync2, lstatSync, mkdirSync as mkdirSync3, mkdtempSync, readdirSync, readFileSync as readFileSync5, renameSync as renameSync2, rmSync as rmSync2, writeFileSync as writeFileSync3 } from "fs";
+import { dirname as dirname2, join as join5 } from "path";
+function skillDirs(targets, name) {
+  const dirs = [];
+  if (targets.claude) dirs.push(join5(targets.base, ".claude", "skills", name));
+  if (targets.agents) dirs.push(join5(targets.base, ".agents", "skills", name));
+  return dirs;
 }
-function createOutput(io, json, noColor) {
-  const color = !noColor && !io.env.NO_COLOR && io.env.TERM !== "dumb" && io.stderrIsTTY && !json;
-  return {
-    json,
-    color,
-    result(data, human) {
-      if (json) {
-        io.stdout(`${JSON.stringify(data)}
-`);
-      } else if (human !== void 0) {
-        io.stdout(human.endsWith("\n") ? human : `${human}
-`);
+var message = (err) => err instanceof Error ? err.message : String(err);
+function plainReason(err) {
+  const code = err.code;
+  if (code === "EACCES" || code === "EPERM") return "you do not have permission to write there";
+  if (code === "ENOSPC") return "the disk is full";
+  if (code === "EROFS") return "that disk is read-only";
+  if (code === "ENOTDIR" || code === "EEXIST") return "a file is in the way";
+  return message(err);
+}
+var leftBehind = (written) => written.length > 0 ? `It wrote ${written.join(" and ")} first.` : "Nothing was written.";
+function writeFailure(path, err, written = []) {
+  const code = err.code;
+  const left = leftBehind(written);
+  const fix = code === "EACCES" || code === "EPERM" ? " Run the command from a folder you can write to." : "";
+  return new CliError("write_failed", `Could not write ${path}: ${plainReason(err)}`, EXIT.general, `${left}${fix}`);
+}
+function sameFolder(dir, archive) {
+  let top;
+  try {
+    top = lstatSync(dir);
+  } catch (err) {
+    if (err.code === "ENOENT") return null;
+    throw writeFailure(dir, err);
+  }
+  if (!top.isDirectory()) return false;
+  const want = new Map(archive.files.map((f) => [f.path, f]));
+  const wantDirs = new Set(archive.dirs);
+  let found = 0;
+  const walk = (rel) => {
+    for (const entry of readdirSync(join5(dir, rel), { withFileTypes: true })) {
+      const path = rel ? `${rel}/${entry.name}` : entry.name;
+      if (++found > want.size + wantDirs.size) return false;
+      if (entry.isDirectory()) {
+        if (!wantDirs.has(path) || !walk(path)) return false;
+      } else if (entry.isFile()) {
+        const file = want.get(path);
+        if (!file) return false;
+        const full = join5(dir, path);
+        if (process.platform !== "win32" && (lstatSync(full).mode & 73 ? 493 : 420) !== file.mode) return false;
+        if (!readFileSync5(full).equals(file.bytes)) return false;
+      } else {
+        return false;
       }
-    },
-    info(text) {
-      io.stderr(text.endsWith("\n") ? text : `${text}
-`);
-    },
-    event(data) {
-      if (json) io.stderr(`${JSON.stringify(data)}
-`);
-    },
-    bold(text) {
-      return color ? `\x1B[1m${text}\x1B[22m` : text;
     }
+    return true;
   };
-}
-
-// src/tar-gz.ts
-import { inflateRawSync } from "zlib";
-var MAX_ARCHIVE_FILES = 200;
-var MAX_UNPACKED_BYTES = 4 * 1024 * 1024;
-var MAX_TAR_BYTES = MAX_UNPACKED_BYTES + 1024 * 1024;
-var BLOCK = 512;
-var FILE_MODES = /* @__PURE__ */ new Set([420, 493]);
-var CONTROL_RE2 = /[\u0000-\u001f\u007f-\u009f]/;
-var ArchiveError = class extends Error {
-  tooLarge;
-  constructor(message2, tooLarge = false) {
-    super(message2);
-    this.name = "ArchiveError";
-    this.tooLarge = tooLarge;
+  try {
+    return walk("") && found === want.size + wantDirs.size;
+  } catch (err) {
+    throw writeFailure(dir, err);
   }
-};
-var crcTable = null;
-function crc32(data) {
-  if (!crcTable) {
-    crcTable = new Uint32Array(256);
-    for (let n = 0; n < 256; n += 1) {
-      let c = n;
-      for (let k = 0; k < 8; k += 1) c = c & 1 ? 3988292384 ^ c >>> 1 : c >>> 1;
-      crcTable[n] = c >>> 0;
+}
+function refuseLinks(dir, file, written = []) {
+  const path = file ?? dir;
+  for (const part of [dirname2(dirname2(dir)), dirname2(dir), dir, ...file ? [file] : []]) {
+    let stat;
+    try {
+      stat = lstatSync(part);
+    } catch (err) {
+      if (err.code === "ENOENT") return;
+      throw writeFailure(path, err, written);
+    }
+    const why = stat.isSymbolicLink() ? "is a link" : part === file && !stat.isFile() ? "is not a file" : "";
+    if (why) {
+      throw new CliError(
+        "link_in_the_way",
+        `Could not write ${path}: ${part} ${why}.`,
+        EXIT.general,
+        `${leftBehind(written)} Remove it, or install somewhere else.`
+      );
     }
   }
-  let crc = 4294967295;
-  for (let i = 0; i < data.length; i += 1) crc = crcTable[(crc ^ data[i]) & 255] ^ crc >>> 8;
-  return (crc ^ 4294967295) >>> 0;
 }
-function gunzipChecked(gz) {
-  if (gz.length < 18 || gz[0] !== 31 || gz[1] !== 139) throw new ArchiveError("it is not gzip");
-  if (gz[2] !== 8) throw new ArchiveError("its gzip method is not deflate");
-  const flags = gz[3];
-  if (flags & 224) throw new ArchiveError("its gzip header sets reserved flags");
-  let at = 10;
-  if (flags & 4) at += 2 + gz.readUInt16LE(Math.min(at, gz.length - 2));
-  for (const flag of [8, 16]) {
-    if (!(flags & flag)) continue;
-    const end = gz.indexOf(0, at);
-    if (end < 0) throw new ArchiveError("its gzip header is cut short");
-    at = end + 1;
-  }
-  if (flags & 2) at += 2;
-  if (at > gz.length - 8) throw new ArchiveError("its gzip header is cut short");
-  let tar;
-  let used;
-  try {
-    const out = inflateRawSync(gz.subarray(at), { info: true, maxOutputLength: MAX_TAR_BYTES });
-    tar = out.buffer;
-    used = out.engine.bytesWritten;
-  } catch (err) {
-    if (err.code === "ERR_BUFFER_TOO_LARGE") {
-      throw new ArchiveError(`it unpacks to more than ${MAX_TAR_BYTES / 1024 / 1024} MB`, true);
+function planInstall(dirs, payload) {
+  return dirs.map((dir) => {
+    if (payload.type === "archive") {
+      refuseLinks(dir);
+      const same = sameFolder(dir, payload.archive);
+      return { path: dir, action: same === null ? "wrote" : same ? "unchanged" : "replaced" };
     }
-    throw new ArchiveError(`its gzip data is broken (${err instanceof Error ? err.message : String(err)})`);
-  }
-  const trailer = at + used;
-  if (gz.length - trailer < 8) throw new ArchiveError("its gzip trailer is cut short");
-  if (gz.length - trailer > 8) throw new ArchiveError("it has bytes after its gzip trailer");
-  if (gz.readUInt32LE(trailer) !== crc32(tar)) throw new ArchiveError("its gzip CRC-32 does not match its contents");
-  if (gz.readUInt32LE(trailer + 4) !== tar.length % 2 ** 32) throw new ArchiveError("its gzip length does not match its contents");
-  return tar;
+    const path = join5(dir, "SKILL.md");
+    refuseLinks(dir, path);
+    let current;
+    try {
+      current = lstatSync(path, { throwIfNoEntry: false }) ? readFileSync5(path) : null;
+    } catch (err) {
+      throw writeFailure(path, err);
+    }
+    return { path, action: current === null ? "wrote" : current.equals(payload.body) ? "unchanged" : "replaced" };
+  });
 }
-function field(header, start, length) {
-  const raw = header.subarray(start, start + length);
-  const end = raw.indexOf(0);
-  try {
-    return new TextDecoder("utf-8", { fatal: true }).decode(end < 0 ? raw : raw.subarray(0, end));
-  } catch {
-    throw new ArchiveError("it has a path that is not UTF-8");
-  }
-}
-function octal(header, start, length) {
-  const text = header.toString("latin1", start, start + length).replace(/[\0 ]+$/, "").replace(/^ +/, "");
-  return /^[0-7]{1,12}$/.test(text) ? parseInt(text, 8) : null;
-}
-function checkPath(path) {
-  const shown = JSON.stringify(path);
-  if (path === "") throw new ArchiveError("it has an entry with an empty path");
-  if (path.startsWith("/")) throw new ArchiveError(`it has an absolute path, ${shown}`);
-  if (path.includes("\\")) throw new ArchiveError(`it has a path with a backslash, ${shown}`);
-  if (CONTROL_RE2.test(path)) throw new ArchiveError(`it has a path with a control character, ${shown}`);
-  for (const segment of path.split("/")) {
-    if (segment === "") throw new ArchiveError(`it has a path with an empty segment, ${shown}`);
-    if (segment === ".." || segment === ".") throw new ArchiveError(`it has a path with "${segment}" in it, ${shown}`);
-  }
-}
-var TYPE_NAMES = {
-  "1": "a hard link",
-  "2": "a symbolic link",
-  "3": "a character device",
-  "4": "a block device",
-  "6": "a fifo",
-  "7": "a contiguous file",
-  x: "a pax header",
-  g: "a pax global header",
-  L: "a GNU long name",
-  K: "a GNU long link name"
-};
-function readTar(tar) {
-  if (tar.length % BLOCK !== 0) throw new ArchiveError("its tar is not a whole number of 512-byte blocks");
-  const files = [];
-  const dirs = [];
-  const seen = /* @__PURE__ */ new Map();
-  let unpacked = 0;
-  let at = 0;
-  for (; ; ) {
-    if (at >= tar.length) throw new ArchiveError("its tar has no end marker");
-    const header = tar.subarray(at, at + BLOCK);
-    if (header.every((b) => b === 0)) {
-      if (!tar.subarray(at).every((b) => b === 0)) throw new ArchiveError("it has data after its tar end marker");
-      break;
-    }
-    let sum = 0;
-    for (let i = 0; i < BLOCK; i += 1) sum += i >= 148 && i < 156 ? 32 : header[i];
-    if (octal(header, 148, 8) !== sum) throw new ArchiveError("it has a tar header with a wrong checksum");
-    if (header.toString("latin1", 257, 263) !== "ustar\0" || header.toString("latin1", 263, 265) !== "00") {
-      throw new ArchiveError("its tar is not ustar");
-    }
-    const name = field(header, 0, 100);
-    const prefix = field(header, 345, 155);
-    let path = prefix ? `${prefix}/${name}` : name;
-    const type = String.fromCharCode(header[156]);
-    const size = octal(header, 124, 12);
-    const mode = octal(header, 100, 8);
-    if (size === null || mode === null) throw new ArchiveError(`it has a tar header for ${JSON.stringify(path)} with a bad size or mode`);
-    const isDir = type === "5";
-    if (!isDir && type !== "0" && type !== "\0") {
-      const what = TYPE_NAMES[type] ?? `an entry of type ${JSON.stringify(type)}`;
-      throw new ArchiveError(`${JSON.stringify(path)} is ${what}; a skill archive holds only files and folders`);
-    }
-    if (isDir && path.endsWith("/")) path = path.slice(0, -1);
-    checkPath(path);
-    const key = path.toLowerCase();
-    const parts = key.split("/");
-    for (let i = 1; i < parts.length; i += 1) {
-      const parent = parts.slice(0, i).join("/");
-      const kind = seen.get(parent);
-      if (kind === "file") throw new ArchiveError(`it puts ${JSON.stringify(path)} inside a file`);
-      if (!kind) seen.set(parent, "implied");
-    }
-    const before = seen.get(key);
-    if (before === "file" || before === "dir" || before === "implied" && !isDir) {
-      throw new ArchiveError(`it lists ${JSON.stringify(path)} twice`);
-    }
-    const start = at + BLOCK;
-    if (isDir) {
-      if (size !== 0) throw new ArchiveError(`its folder ${JSON.stringify(path)} has a size`);
-      seen.set(key, "dir");
-      dirs.push(path);
-    } else {
-      if (!FILE_MODES.has(mode & 4095)) {
-        throw new ArchiveError(`${JSON.stringify(path)} has mode ${(mode & 4095).toString(8).padStart(4, "0")}; a file must be 0644 or 0755`);
-      }
-      if (files.length + 1 > MAX_ARCHIVE_FILES) throw new ArchiveError(`it has more than ${MAX_ARCHIVE_FILES} files`, true);
-      unpacked += size;
-      if (unpacked > MAX_UNPACKED_BYTES) throw new ArchiveError(`its files come to more than ${MAX_UNPACKED_BYTES / 1024 / 1024} MB`, true);
-      if (start + size > tar.length) throw new ArchiveError(`its tar is cut short inside ${JSON.stringify(path)}`);
-      seen.set(key, "file");
-      files.push({ path, bytes: Buffer.from(tar.subarray(start, start + size)), mode: mode & 4095 });
-    }
-    at = start + Math.ceil(size / BLOCK) * BLOCK;
-  }
-  const allDirs = /* @__PURE__ */ new Map();
-  const addDirsOf = (path, self) => {
-    const parts = path.split("/");
-    for (let i = 1; i <= parts.length - (self ? 0 : 1); i += 1) {
-      const dir = parts.slice(0, i).join("/");
-      if (!allDirs.has(dir.toLowerCase())) allDirs.set(dir.toLowerCase(), dir);
-    }
-  };
-  for (const dir of dirs) addDirsOf(dir, true);
-  for (const f of files) addDirsOf(f.path, false);
-  return { files, dirs: [...allDirs.values()].sort((a, b) => a.split("/").length - b.split("/").length) };
-}
-function readSkillArchive(gz) {
-  return readTar(gunzipChecked(gz));
-}
-
-// src/commands/skills-guide.ts
-import { existsSync as existsSync4 } from "fs";
-import { dirname as dirname3, join as join6, relative, sep } from "path";
-
-// src/commands/skills-install.ts
-import { randomBytes as randomBytes3 } from "crypto";
-import { chmodSync as chmodSync2, lstatSync, mkdirSync as mkdirSync3, mkdtempSync, readdirSync, readFileSync as readFileSync5, renameSync as renameSync2, rmSync as rmSync2, writeFileSync as writeFileSync3 } from "fs";
-import { dirname as dirname2, join as join5 } from "path";
-function skillDirs(targets, name) {
-  const dirs = [];
-  if (targets.claude) dirs.push(join5(targets.base, ".claude", "skills", name));
-  if (targets.agents) dirs.push(join5(targets.base, ".agents", "skills", name));
-  return dirs;
-}
-var message = (err) => err instanceof Error ? err.message : String(err);
-function plainReason(err) {
-  const code = err.code;
-  if (code === "EACCES" || code === "EPERM") return "you do not have permission to write there";
-  if (code === "ENOSPC") return "the disk is full";
-  if (code === "EROFS") return "that disk is read-only";
-  if (code === "ENOTDIR" || code === "EEXIST") return "a file is in the way";
-  return message(err);
-}
-var leftBehind = (written) => written.length > 0 ? `It wrote ${written.join(" and ")} first.` : "Nothing was written.";
-function writeFailure(path, err, written = []) {
-  const code = err.code;
-  const left = leftBehind(written);
-  const fix = code === "EACCES" || code === "EPERM" ? " Run the command from a folder you can write to." : "";
-  return new CliError("write_failed", `Could not write ${path}: ${plainReason(err)}`, EXIT.general, `${left}${fix}`);
-}
-function sameFolder(dir, archive) {
-  let top;
-  try {
-    top = lstatSync(dir);
-  } catch (err) {
-    if (err.code === "ENOENT") return null;
-    throw writeFailure(dir, err);
-  }
-  if (!top.isDirectory()) return false;
-  const want = new Map(archive.files.map((f) => [f.path, f]));
-  const wantDirs = new Set(archive.dirs);
-  let found = 0;
-  const walk = (rel) => {
-    for (const entry of readdirSync(join5(dir, rel), { withFileTypes: true })) {
-      const path = rel ? `${rel}/${entry.name}` : entry.name;
-      if (++found > want.size + wantDirs.size) return false;
-      if (entry.isDirectory()) {
-        if (!wantDirs.has(path) || !walk(path)) return false;
-      } else if (entry.isFile()) {
-        const file = want.get(path);
-        if (!file) return false;
-        const full = join5(dir, path);
-        if (process.platform !== "win32" && (lstatSync(full).mode & 73 ? 493 : 420) !== file.mode) return false;
-        if (!readFileSync5(full).equals(file.bytes)) return false;
-      } else {
-        return false;
-      }
-    }
-    return true;
-  };
-  try {
-    return walk("") && found === want.size + wantDirs.size;
-  } catch (err) {
-    throw writeFailure(dir, err);
-  }
-}
-function refuseLinks(dir, file, written = []) {
-  const path = file ?? dir;
-  for (const part of [dirname2(dirname2(dir)), dirname2(dir), dir, ...file ? [file] : []]) {
-    let stat;
-    try {
-      stat = lstatSync(part);
-    } catch (err) {
-      if (err.code === "ENOENT") return;
-      throw writeFailure(path, err, written);
-    }
-    const why = stat.isSymbolicLink() ? "is a link" : part === file && !stat.isFile() ? "is not a file" : "";
-    if (why) {
-      throw new CliError(
-        "link_in_the_way",
-        `Could not write ${path}: ${part} ${why}.`,
-        EXIT.general,
-        `${leftBehind(written)} Remove it, or install somewhere else.`
-      );
-    }
-  }
-}
-function planInstall(dirs, payload) {
-  return dirs.map((dir) => {
-    if (payload.type === "archive") {
-      refuseLinks(dir);
-      const same = sameFolder(dir, payload.archive);
-      return { path: dir, action: same === null ? "wrote" : same ? "unchanged" : "replaced" };
-    }
-    const path = join5(dir, "SKILL.md");
-    refuseLinks(dir, path);
-    let current;
-    try {
-      current = lstatSync(path, { throwIfNoEntry: false }) ? readFileSync5(path) : null;
-    } catch (err) {
-      throw writeFailure(path, err);
-    }
-    return { path, action: current === null ? "wrote" : current.equals(payload.body) ? "unchanged" : "replaced" };
-  });
-}
-function refuseClashes(plan, name, force) {
-  const clashes = plan.filter((p) => p.action === "replaced").map((p) => p.path);
-  if (clashes.length > 0 && !force) {
-    throw new CliError(
-      "skill_exists",
-      `A different ${name} skill is already at ${clashes.join(" and ")}.`,
-      EXIT.general,
-      "Nothing was written. Run again with --force to replace it."
-    );
+function refuseClashes(plan, name, force) {
+  const clashes = plan.filter((p) => p.action === "replaced").map((p) => p.path);
+  if (clashes.length > 0 && !force) {
+    throw new CliError(
+      "skill_exists",
+      `A different ${name} skill is already at ${clashes.join(" and ")}.`,
+      EXIT.general,
+      "Nothing was written. Run again with --force to replace it."
+    );
   }
 }
 function stage(target, name, archive, staged) {
@@ -9503,6 +9392,318 @@ function nextStep(ctx, targets, seen) {
   return `Open a new ${joinNames(names, "or")} chat ${where} to use it.`;
 }
 
+// src/commands/setup.ts
+var SHOWN = [
+  { client: "claude-code", name: "Claude Code" },
+  { client: "cursor", name: "Cursor" },
+  { client: "codex", name: "Codex" }
+];
+function tryItLine(name) {
+  const ask2 = 'say "make this email sound less like AI"';
+  return name === "Codex" ? `Try it: run \`codex mcp login amdahl\`, then open Codex and ${ask2}` : `Try it: open ${name} and ${ask2}`;
+}
+function shouldSetUp(io) {
+  const { env } = io;
+  const ci = Boolean(env.CI) && env.CI !== "false" && env.CI !== "0";
+  return io.stdinIsTTY && io.stdoutIsTTY && io.stderrIsTTY && env.AMDAHL_NO_PROMPT !== "1" && !ci && !env.CLAUDECODE && !env.CURSOR_AGENT;
+}
+async function signIn(ctx) {
+  let credential;
+  try {
+    credential = await resolveCredential(ctx);
+  } catch (err) {
+    if (err instanceof CliError && err.exit === EXIT.unauthenticated) return { kind: "out" };
+    throw err;
+  }
+  try {
+    const me = await call(() => apiClient(ctx, credential).cli.whoami());
+    return { kind: "in", email: me.email ?? me.user_id, workspace: me.workspace?.name ?? me.business_id };
+  } catch (err) {
+    if (!(err instanceof CliError && err.exit === EXIT.unauthenticated)) throw err;
+    return credential.source === "profile" ? { kind: "out" } : { kind: "rejected", source: credential.source };
+  }
+}
+async function setup(ctx) {
+  const { io, out } = ctx;
+  const say = (line) => io.stdout(`${line}
+`);
+  say(`${out.bold("Amdahl")}, predictive ML for GTM`);
+  const found = await detectClients(ctx);
+  const detected = SHOWN.filter((c) => found[c.client]);
+  let who;
+  if (detected.length > 0) {
+    const installed = await Promise.all(detected.map((c) => isInstalled(ctx, c.client)));
+    if (installed.every(Boolean)) {
+      let unreachable = false;
+      try {
+        who = await signIn(ctx);
+      } catch (err) {
+        if (!(err instanceof CliError && err.exit === EXIT.network)) throw err;
+        unreachable = true;
+      }
+      if (unreachable || who?.kind === "in") {
+        say(`You're set up in ${joinNames(detected.map((c) => c.name))}.${unreachable ? " (Could not reach Amdahl to check your sign-in.)" : ""}`);
+        say(tryItLine(detected[0]?.name ?? ""));
+        return EXIT.ok;
+      }
+    }
+  }
+  say(`Found on this machine: ${SHOWN.map((c) => `${c.name} ${found[c.client] ? "\u2713" : "\u2013"}`).join("  ")}`);
+  if (detected.length === 0) {
+    say("None of them found here. Tick the ones you use with Space, then press Enter.");
+  }
+  const picks = await io.multiSelect(
+    "Set up Amdahl in:",
+    SHOWN.map((c) => c.name),
+    { ticked: SHOWN.map((c) => found[c.client]), color: out.color }
+  );
+  if (picks.length === 0) {
+    say("Nothing picked, so nothing changed. To set one up later: amdahl install claude-code|codex|cursor");
+    return EXIT.ok;
+  }
+  who ??= await signIn(ctx);
+  if (who.kind === "in") say(`Signed in as ${who.email} (workspace: ${who.workspace})`);
+  else if (who.kind === "out") await login(ctx);
+  else {
+    const name = who.source === "flag" ? "--api-key" : who.source.slice("env:".length);
+    out.info(`Amdahl rejected the key in ${name}. Skipping the browser sign-in, because that key would still be used instead. Fix it, or unset it and run \`amdahl login\`.`);
+  }
+  let exit = EXIT.ok;
+  let ready = null;
+  for (const { client, name } of picks.flatMap((i) => SHOWN[i] ?? [])) {
+    try {
+      await install(ctx, [client]);
+    } catch (raw) {
+      const err = raw instanceof CliError ? raw : new CliError("install_failed", `Could not set up ${name}: ${raw instanceof Error ? raw.message : String(raw)}`, EXIT.general);
+      io.stderr(`Error: ${err.message}
+${err.hint ? `${err.hint}
+` : ""}`);
+      if (exit === EXIT.ok) exit = err.exit;
+      continue;
+    }
+    if (ready === null && (client !== "claude-code" || await onPath(ctx, "claude"))) ready = name;
+  }
+  if (ready) say(tryItLine(ready));
+  return exit;
+}
+
+// src/commands/skills.ts
+var import_yaml = __toESM(require_dist(), 1);
+import { createHash as createHash4 } from "crypto";
+
+// src/output.ts
+var CONTROL_RE = /[\u0000-\u001f\u007f-\u009f]/g;
+function printable(text) {
+  return text.replace(CONTROL_RE, "");
+}
+function createOutput(io, json, noColor) {
+  const color = !noColor && !io.env.NO_COLOR && io.env.TERM !== "dumb" && io.stderrIsTTY && !json;
+  return {
+    json,
+    color,
+    result(data, human) {
+      if (json) {
+        io.stdout(`${JSON.stringify(data)}
+`);
+      } else if (human !== void 0) {
+        io.stdout(human.endsWith("\n") ? human : `${human}
+`);
+      }
+    },
+    info(text) {
+      io.stderr(text.endsWith("\n") ? text : `${text}
+`);
+    },
+    event(data) {
+      if (json) io.stderr(`${JSON.stringify(data)}
+`);
+    },
+    bold(text) {
+      return color ? `\x1B[1m${text}\x1B[22m` : text;
+    }
+  };
+}
+
+// src/tar-gz.ts
+import { inflateRawSync } from "zlib";
+var MAX_ARCHIVE_FILES = 200;
+var MAX_UNPACKED_BYTES = 4 * 1024 * 1024;
+var MAX_TAR_BYTES = MAX_UNPACKED_BYTES + 1024 * 1024;
+var BLOCK = 512;
+var FILE_MODES = /* @__PURE__ */ new Set([420, 493]);
+var CONTROL_RE2 = /[\u0000-\u001f\u007f-\u009f]/;
+var ArchiveError = class extends Error {
+  tooLarge;
+  constructor(message2, tooLarge = false) {
+    super(message2);
+    this.name = "ArchiveError";
+    this.tooLarge = tooLarge;
+  }
+};
+var crcTable = null;
+function crc32(data) {
+  if (!crcTable) {
+    crcTable = new Uint32Array(256);
+    for (let n = 0; n < 256; n += 1) {
+      let c = n;
+      for (let k = 0; k < 8; k += 1) c = c & 1 ? 3988292384 ^ c >>> 1 : c >>> 1;
+      crcTable[n] = c >>> 0;
+    }
+  }
+  let crc = 4294967295;
+  for (let i = 0; i < data.length; i += 1) crc = crcTable[(crc ^ data[i]) & 255] ^ crc >>> 8;
+  return (crc ^ 4294967295) >>> 0;
+}
+function gunzipChecked(gz) {
+  if (gz.length < 18 || gz[0] !== 31 || gz[1] !== 139) throw new ArchiveError("it is not gzip");
+  if (gz[2] !== 8) throw new ArchiveError("its gzip method is not deflate");
+  const flags = gz[3];
+  if (flags & 224) throw new ArchiveError("its gzip header sets reserved flags");
+  let at = 10;
+  if (flags & 4) at += 2 + gz.readUInt16LE(Math.min(at, gz.length - 2));
+  for (const flag of [8, 16]) {
+    if (!(flags & flag)) continue;
+    const end = gz.indexOf(0, at);
+    if (end < 0) throw new ArchiveError("its gzip header is cut short");
+    at = end + 1;
+  }
+  if (flags & 2) at += 2;
+  if (at > gz.length - 8) throw new ArchiveError("its gzip header is cut short");
+  let tar;
+  let used;
+  try {
+    const out = inflateRawSync(gz.subarray(at), { info: true, maxOutputLength: MAX_TAR_BYTES });
+    tar = out.buffer;
+    used = out.engine.bytesWritten;
+  } catch (err) {
+    if (err.code === "ERR_BUFFER_TOO_LARGE") {
+      throw new ArchiveError(`it unpacks to more than ${MAX_TAR_BYTES / 1024 / 1024} MB`, true);
+    }
+    throw new ArchiveError(`its gzip data is broken (${err instanceof Error ? err.message : String(err)})`);
+  }
+  const trailer = at + used;
+  if (gz.length - trailer < 8) throw new ArchiveError("its gzip trailer is cut short");
+  if (gz.length - trailer > 8) throw new ArchiveError("it has bytes after its gzip trailer");
+  if (gz.readUInt32LE(trailer) !== crc32(tar)) throw new ArchiveError("its gzip CRC-32 does not match its contents");
+  if (gz.readUInt32LE(trailer + 4) !== tar.length % 2 ** 32) throw new ArchiveError("its gzip length does not match its contents");
+  return tar;
+}
+function field(header, start, length) {
+  const raw = header.subarray(start, start + length);
+  const end = raw.indexOf(0);
+  try {
+    return new TextDecoder("utf-8", { fatal: true }).decode(end < 0 ? raw : raw.subarray(0, end));
+  } catch {
+    throw new ArchiveError("it has a path that is not UTF-8");
+  }
+}
+function octal(header, start, length) {
+  const text = header.toString("latin1", start, start + length).replace(/[\0 ]+$/, "").replace(/^ +/, "");
+  return /^[0-7]{1,12}$/.test(text) ? parseInt(text, 8) : null;
+}
+function checkPath(path) {
+  const shown = JSON.stringify(path);
+  if (path === "") throw new ArchiveError("it has an entry with an empty path");
+  if (path.startsWith("/")) throw new ArchiveError(`it has an absolute path, ${shown}`);
+  if (path.includes("\\")) throw new ArchiveError(`it has a path with a backslash, ${shown}`);
+  if (CONTROL_RE2.test(path)) throw new ArchiveError(`it has a path with a control character, ${shown}`);
+  for (const segment of path.split("/")) {
+    if (segment === "") throw new ArchiveError(`it has a path with an empty segment, ${shown}`);
+    if (segment === ".." || segment === ".") throw new ArchiveError(`it has a path with "${segment}" in it, ${shown}`);
+  }
+}
+var TYPE_NAMES = {
+  "1": "a hard link",
+  "2": "a symbolic link",
+  "3": "a character device",
+  "4": "a block device",
+  "6": "a fifo",
+  "7": "a contiguous file",
+  x: "a pax header",
+  g: "a pax global header",
+  L: "a GNU long name",
+  K: "a GNU long link name"
+};
+function readTar(tar) {
+  if (tar.length % BLOCK !== 0) throw new ArchiveError("its tar is not a whole number of 512-byte blocks");
+  const files = [];
+  const dirs = [];
+  const seen = /* @__PURE__ */ new Map();
+  let unpacked = 0;
+  let at = 0;
+  for (; ; ) {
+    if (at >= tar.length) throw new ArchiveError("its tar has no end marker");
+    const header = tar.subarray(at, at + BLOCK);
+    if (header.every((b) => b === 0)) {
+      if (!tar.subarray(at).every((b) => b === 0)) throw new ArchiveError("it has data after its tar end marker");
+      break;
+    }
+    let sum = 0;
+    for (let i = 0; i < BLOCK; i += 1) sum += i >= 148 && i < 156 ? 32 : header[i];
+    if (octal(header, 148, 8) !== sum) throw new ArchiveError("it has a tar header with a wrong checksum");
+    if (header.toString("latin1", 257, 263) !== "ustar\0" || header.toString("latin1", 263, 265) !== "00") {
+      throw new ArchiveError("its tar is not ustar");
+    }
+    const name = field(header, 0, 100);
+    const prefix = field(header, 345, 155);
+    let path = prefix ? `${prefix}/${name}` : name;
+    const type = String.fromCharCode(header[156]);
+    const size = octal(header, 124, 12);
+    const mode = octal(header, 100, 8);
+    if (size === null || mode === null) throw new ArchiveError(`it has a tar header for ${JSON.stringify(path)} with a bad size or mode`);
+    const isDir = type === "5";
+    if (!isDir && type !== "0" && type !== "\0") {
+      const what = TYPE_NAMES[type] ?? `an entry of type ${JSON.stringify(type)}`;
+      throw new ArchiveError(`${JSON.stringify(path)} is ${what}; a skill archive holds only files and folders`);
+    }
+    if (isDir && path.endsWith("/")) path = path.slice(0, -1);
+    checkPath(path);
+    const key = path.toLowerCase();
+    const parts = key.split("/");
+    for (let i = 1; i < parts.length; i += 1) {
+      const parent = parts.slice(0, i).join("/");
+      const kind = seen.get(parent);
+      if (kind === "file") throw new ArchiveError(`it puts ${JSON.stringify(path)} inside a file`);
+      if (!kind) seen.set(parent, "implied");
+    }
+    const before = seen.get(key);
+    if (before === "file" || before === "dir" || before === "implied" && !isDir) {
+      throw new ArchiveError(`it lists ${JSON.stringify(path)} twice`);
+    }
+    const start = at + BLOCK;
+    if (isDir) {
+      if (size !== 0) throw new ArchiveError(`its folder ${JSON.stringify(path)} has a size`);
+      seen.set(key, "dir");
+      dirs.push(path);
+    } else {
+      if (!FILE_MODES.has(mode & 4095)) {
+        throw new ArchiveError(`${JSON.stringify(path)} has mode ${(mode & 4095).toString(8).padStart(4, "0")}; a file must be 0644 or 0755`);
+      }
+      if (files.length + 1 > MAX_ARCHIVE_FILES) throw new ArchiveError(`it has more than ${MAX_ARCHIVE_FILES} files`, true);
+      unpacked += size;
+      if (unpacked > MAX_UNPACKED_BYTES) throw new ArchiveError(`its files come to more than ${MAX_UNPACKED_BYTES / 1024 / 1024} MB`, true);
+      if (start + size > tar.length) throw new ArchiveError(`its tar is cut short inside ${JSON.stringify(path)}`);
+      seen.set(key, "file");
+      files.push({ path, bytes: Buffer.from(tar.subarray(start, start + size)), mode: mode & 4095 });
+    }
+    at = start + Math.ceil(size / BLOCK) * BLOCK;
+  }
+  const allDirs = /* @__PURE__ */ new Map();
+  const addDirsOf = (path, self) => {
+    const parts = path.split("/");
+    for (let i = 1; i <= parts.length - (self ? 0 : 1); i += 1) {
+      const dir = parts.slice(0, i).join("/");
+      if (!allDirs.has(dir.toLowerCase())) allDirs.set(dir.toLowerCase(), dir);
+    }
+  };
+  for (const dir of dirs) addDirsOf(dir, true);
+  for (const f of files) addDirsOf(f.path, false);
+  return { files, dirs: [...allDirs.values()].sort((a, b) => a.split("/").length - b.split("/").length) };
+}
+function readSkillArchive(gz) {
+  return readTar(gunzipChecked(gz));
+}
+
 // src/commands/skills-warning.ts
 var WARNING_FIELD = "x-amdahl-warning";
 var MAX_WARNING_CHARS = 300;
@@ -9929,7 +10130,7 @@ async function workspaceUse(ctx, args) {
 }
 
 // src/version.ts
-var VERSION = "0.2.4";
+var VERSION = "0.3.0";
 
 // src/main.ts
 var COMMANDS = {
@@ -9964,6 +10165,7 @@ async function runCli(argv, io) {
       return EXIT.ok;
     }
     if (!parsed.command) {
+      if (argv.length === 0 && shouldSetUp(io)) return await setup(createCtx(io, out, parsed.flags));
       io.stderr(USAGE);
       return EXIT.usage;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amdahl/cli",
-  "version": "0.2.4",
+  "version": "0.3.0",
   "type": "module",
   "description": "The amdahl command line: sign in, check setup, optimize messages, manage API keys, connect MCP clients.",
   "license": "Apache-2.0",