gistajs 0.0.9 → 0.1.0

package/dist/bin.cjs

@@ -56,6 +56,46 @@ function parseStarter(data) {
   return { slug, repo, branches, description };
 }
 
+// src/color.ts
+var import_picocolors = __toESM(require("picocolors"), 1);
+var c = {
+  brand: (s) => import_picocolors.default.bold(import_picocolors.default.cyan(s)),
+  success: (s) => import_picocolors.default.bold(s),
+  path: (s) => import_picocolors.default.underline(s),
+  slug: (s) => import_picocolors.default.cyan(s),
+  prompt: (s) => import_picocolors.default.bold(import_picocolors.default.yellow(s)),
+  error: (s) => import_picocolors.default.red(s),
+  errorLabel: (s) => import_picocolors.default.bold(import_picocolors.default.red(s)),
+  dim: (s) => import_picocolors.default.dim(s),
+  bold: (s) => import_picocolors.default.bold(s)
+};
+var LOGO = [
+  "   ____ _     _           _     ",
+  "  / ___(_)___| |_ __ _   (_)___ ",
+  " | |  _| / __| __/ _` |  | / __|",
+  " | |_| | \\__ \\ || (_| |_ | \\__ \\",
+  "  \\____|_|___/\\__\\__,_(_)/ |___/",
+  "                       |__/     "
+];
+function lerp(a, b, t) {
+  return Math.round(a + (b - a) * t);
+}
+function rgb(r, g, b, text) {
+  return `\x1B[38;2;${r};${g};${b}m${text}\x1B[39m`;
+}
+function logo() {
+  let from = [0, 255, 65];
+  let to = [0, 143, 17];
+  let total = LOGO.length;
+  return LOGO.map((line, i) => {
+    let t = total <= 1 ? 0 : i / (total - 1);
+    let r = lerp(from[0], to[0], t);
+    let g = lerp(from[1], to[1], t);
+    let b = lerp(from[2], to[2], t);
+    return rgb(r, g, b, line);
+  }).join("\n");
+}
+
 // src/create.ts
 var import_promises2 = require("fs/promises");
 var import_node_os = require("os");
@@ -73,11 +113,13 @@ async function promptForStarter(starters) {
   let rl = createPrompt();
   try {
     let options = starters.map(
-      (starter2, index2) => `${index2 + 1}. ${starter2.slug} - ${starter2.description}`
+      (starter2, index2) => `  ${c.dim(`${index2 + 1}.`)} ${c.slug(starter2.slug)} ${c.dim("\u2014")} ${starter2.description}`
     ).join("\n");
-    let answer = await rl.question(`Choose a starter:
+    let answer = await rl.question(
+      `${c.prompt("Choose a starter:")}
 ${options}
-> `);
+${c.dim(">")} `
+    );
     let index = Number.parseInt(answer.trim(), 10) - 1;
     let starter = starters[index];
     if (!starter) throw new Error("Invalid starter selection");
@@ -90,10 +132,12 @@ async function promptForGitIdentity() {
   let rl = createPrompt();
   try {
     console.log(
-      "Before I make the first commit, Git needs a name and email to attach to it."
+      c.dim(
+        "Before I make the first commit, Git needs a name and email to attach to it."
+      )
     );
-    let name = (await rl.question("Your name: ")).trim();
-    let email = (await rl.question("Your email: ")).trim();
+    let name = (await rl.question(c.prompt("Your name: "))).trim();
+    let email = (await rl.question(c.prompt("Your email: "))).trim();
     if (!name) throw new Error("Name is required to make the first commit");
     if (!email) throw new Error("Email is required to make the first commit");
     let saveGlobal = await confirm(
@@ -105,6 +149,16 @@ async function promptForGitIdentity() {
     rl.close();
   }
 }
+async function promptConfirm(message, defaultYes = true) {
+  let rl = createPrompt();
+  try {
+    let answer = (await rl.question(c.prompt(message))).trim().toLowerCase();
+    if (answer === "") return defaultYes;
+    return answer === "y" || answer === "yes";
+  } finally {
+    rl.close();
+  }
+}
 function createPrompt() {
   return import_promises.default.createInterface({
     input: import_node_process.default.stdin,
@@ -112,7 +166,7 @@ function createPrompt() {
   });
 }
 async function confirm(rl, message) {
-  let answer = (await rl.question(message)).trim().toLowerCase();
+  let answer = (await rl.question(c.dim(message))).trim().toLowerCase();
   return answer === "y" || answer === "yes";
 }
 
@@ -128,7 +182,9 @@ async function run(command, args, cwd) {
     child.once("exit", (code) => {
       if (code === 0) resolve2();
       else {
-        reject(new Error(`${command} ${args.join(" ")} exited with code ${code}`));
+        reject(
+          new Error(`${command} ${args.join(" ")} exited with code ${code}`)
+        );
       }
     });
   });
@@ -340,12 +396,10 @@ async function diffStarter(starter, options, deps = defaultDeps2) {
     await git2(root, ["remote", "add", "origin", repoUrl], deps);
     await fetchTag(root, fromTag, repoUrl, deps);
     await fetchTag(root, toTag, repoUrl, deps);
-    return await gitOutput(
-      root,
-      ["diff", "--stat", `refs/tags/${fromTag}`, `refs/tags/${toTag}`],
-      repoUrl,
-      deps
-    );
+    let diffArgs = ["diff"];
+    if (options.stat) diffArgs.push("--stat");
+    diffArgs.push(`refs/tags/${fromTag}`, `refs/tags/${toTag}`);
+    return await gitOutput(root, diffArgs, repoUrl, deps);
   } finally {
     await deps.rm(root, { recursive: true, force: true });
   }
@@ -360,7 +414,13 @@ async function fetchTag(cwd, tag, repoUrl, deps) {
   try {
     await git2(
       cwd,
-      ["fetch", "--quiet", "--no-tags", "origin", `refs/tags/${tag}:refs/tags/${tag}`],
+      [
+        "fetch",
+        "--quiet",
+        "--no-tags",
+        "origin",
+        `refs/tags/${tag}:refs/tags/${tag}`
+      ],
       deps
     );
   } catch (error) {
@@ -420,12 +480,15 @@ var defaultDeps3 = {
   createProject,
   diffStarter,
   promptForStarter,
+  promptConfirm,
   stdout: console
 };
 var UsageError = class extends Error {
-  constructor(message) {
+  command;
+  constructor(message, command) {
     super(message);
     this.name = "UsageError";
+    this.command = command;
   }
 };
 async function runCli(argv = import_node_process3.default.argv.slice(2), deps = defaultDeps3) {
@@ -434,36 +497,50 @@ async function runCli(argv = import_node_process3.default.argv.slice(2), deps =
     deps.stdout.log(getHelpText());
     return;
   }
+  if (command === "logo") {
+    deps.stdout.log("\n" + logo() + "\n");
+    return;
+  }
   if (command === "create") {
     let options = parseCreateArgs(rest);
     if (!options.projectName) {
-      throw new UsageError("Project name is required");
+      throw new UsageError("Project name is required", "create");
     }
     let catalog = await deps.loadCatalog(options.catalogUrl);
     let starterName = options.starter || await deps.promptForStarter(catalog);
     let starter = catalog.find((entry) => entry.slug === starterName);
     if (!starter) {
-      throw new UsageError(`Unknown starter: ${starterName}`);
+      throw new UsageError(`Unknown starter: ${starterName}`, "create");
+    }
+    if (options.git === void 0) {
+      options.git = await deps.promptConfirm("Initialize git? (Y/n) ");
+    }
+    if (options.install === void 0) {
+      options.install = await deps.promptConfirm("Install dependencies? (Y/n) ");
     }
     let root = await deps.createProject(starter, options);
-    deps.stdout.log(`Created ${starter.slug} project in ${root}`);
+    deps.stdout.log(
+      `
+  ${c.brand("gistajs")} ${c.success("Created")} ${c.slug(starter.slug)} project in ${c.path(root)}
+`
+    );
     return;
   }
   if (command === "diff") {
     let options = parseDiffArgs(rest);
     if (!options.starter) {
-      throw new UsageError("Starter is required");
+      throw new UsageError("Starter is required", "diff");
     }
     if (!options.fromReleaseKey) {
-      throw new UsageError("From release key is required");
+      throw new UsageError("From release key is required", "diff");
     }
     if (!options.toReleaseKey) {
-      throw new UsageError("To release key is required");
+      throw new UsageError("To release key is required", "diff");
     }
     let catalog = await deps.loadCatalog(options.catalogUrl);
     let starter = catalog.find((entry) => entry.slug === options.starter);
     if (!starter) {
-      throw new UsageError(`Unknown starter: ${options.starter}`);
+      throw new UsageError(`Unknown starter: ${options.starter}`, "diff");
     }
     let output = await deps.diffStarter(starter, options);
     deps.stdout.log(output.trimEnd());
@@ -476,18 +553,15 @@ async function main() {
     await runCli();
   } catch (error) {
     let message = error instanceof Error ? error.message : String(error);
-    console.error(message);
+    console.error(`${c.errorLabel("error:")} ${c.error(message)}`);
     if (error instanceof UsageError) {
-      console.error(getHelpText());
+      console.error(getHelpText(error.command));
     }
     import_node_process3.default.exitCode = 1;
   }
 }
 function parseCreateArgs(argv) {
-  let options = {
-    install: true,
-    git: true
-  };
+  let options = {};
   for (let index = 0; index < argv.length; index += 1) {
     let arg = argv[index];
     if (!arg) continue;
@@ -496,7 +570,8 @@ function parseCreateArgs(argv) {
       continue;
     }
     if (arg === "--starter") {
-      if (!argv[index + 1]) throw new UsageError("--starter requires a value");
+      if (!argv[index + 1])
+        throw new UsageError("--starter requires a value", "create");
       options.starter = argv[index + 1];
       index += 1;
       continue;
@@ -511,13 +586,13 @@ function parseCreateArgs(argv) {
     }
     if (arg === "--catalog-url") {
       if (!argv[index + 1]) {
-        throw new UsageError("--catalog-url requires a value");
+        throw new UsageError("--catalog-url requires a value", "create");
       }
       options.catalogUrl = argv[index + 1];
       index += 1;
       continue;
     }
-    throw new UsageError(`Unknown argument: ${arg}`);
+    throw new UsageError(`Unknown argument: ${arg}`, "create");
   }
   return options;
 }
@@ -538,30 +613,66 @@ function parseDiffArgs(argv) {
       options.toReleaseKey = arg;
       continue;
     }
+    if (arg === "--stat") {
+      options.stat = true;
+      continue;
+    }
     if (arg === "--catalog-url") {
       if (!argv[index + 1]) {
-        throw new UsageError("--catalog-url requires a value");
+        throw new UsageError("--catalog-url requires a value", "diff");
       }
       options.catalogUrl = argv[index + 1];
       index += 1;
       continue;
     }
-    throw new UsageError(`Unknown argument: ${arg}`);
+    throw new UsageError(`Unknown argument: ${arg}`, "diff");
   }
   return options;
 }
-function getHelpText() {
+function getHelpText(command) {
+  let header = `  ${c.brand("gistajs")} ${c.dim("\u2014 scaffold Gista.js starter projects")}`;
+  if (command === "create") {
+    return [
+      "",
+      header,
+      "",
+      `  ${c.bold("Usage:")}`,
+      `    ${c.dim("$")} ${c.bold("gistajs create")} <project-name> [--starter <slug>] [--no-install] [--no-git]`,
+      "",
+      `  ${c.bold("Examples:")}`,
+      `    ${c.dim("$")} gistajs create my-app`,
+      `    ${c.dim("$")} gistajs create my-app --starter website`,
+      ""
+    ].join("\n");
+  }
+  if (command === "diff") {
+    return [
+      "",
+      header,
+      "",
+      `  ${c.bold("Usage:")}`,
+      `    ${c.dim("$")} ${c.bold("gistajs diff")} <starter> <from-release-key> <to-release-key> [--stat]`,
+      "",
+      `  ${c.bold("Examples:")}`,
+      `    ${c.dim("$")} gistajs diff auth 2026-03-28-001 2026-03-29-001`,
+      `    ${c.dim("$")} gistajs diff auth 2026-03-28-001 2026-03-29-001 --stat`,
+      ""
+    ].join("\n");
+  }
   return [
-    "Usage:",
-    "  gistajs create <project-name> [--starter <slug>] [--no-install] [--no-git]",
-    "  gistajs diff <starter> <from-release-key> <to-release-key>",
     "",
-    "Examples:",
-    "  gistajs create my-app",
-    "  gistajs create my-app --starter website",
-    "  gistajs diff auth 2026-03-28-001 2026-03-29-001",
+    header,
+    "",
+    `  ${c.bold("Usage:")}`,
+    `    ${c.dim("$")} ${c.bold("gistajs create")} <project-name> [--starter <slug>] [--no-install] [--no-git]`,
+    `    ${c.dim("$")} ${c.bold("gistajs diff")} <starter> <from-release-key> <to-release-key> [--stat]`,
     "",
-    "Run `gistajs` with no arguments to show this help."
+    `  ${c.bold("Examples:")}`,
+    `    ${c.dim("$")} gistajs create my-app`,
+    `    ${c.dim("$")} gistajs create my-app --starter website`,
+    `    ${c.dim("$")} gistajs diff auth 2026-03-28-001 2026-03-29-001`,
+    `    ${c.dim("$")} gistajs diff auth 2026-03-28-001 2026-03-29-001 --stat`,
+    ""
   ].join("\n");
 }
 

package/dist/index.d.ts

@@ -18,6 +18,7 @@ type DiffOptions = {
     starter?: string;
     fromReleaseKey?: string;
     toReleaseKey?: string;
+    stat?: boolean;
     catalogUrl?: string;
 };
 
@@ -37,12 +38,14 @@ declare function diffStarter(starter: StarterSpec, options: DiffOptions, deps?:
 declare function runOutput(command: string, args: string[], cwd: string): Promise<string>;
 
 declare function promptForStarter(starters: StarterSpec[]): Promise<string>;
+declare function promptConfirm(message: string, defaultYes?: boolean): Promise<boolean>;
 
 type CliDeps = {
     loadCatalog: typeof loadCatalog;
     createProject: typeof createProject;
     diffStarter: typeof diffStarter;
     promptForStarter: typeof promptForStarter;
+    promptConfirm: typeof promptConfirm;
     stdout: Pick<typeof console, 'log'>;
 };
 declare function runCli(argv?: string[], deps?: CliDeps): Promise<void>;

package/dist/index.js

@@ -31,6 +31,46 @@ function parseStarter(data) {
   return { slug, repo, branches, description };
 }
 
+// src/color.ts
+import pc from "picocolors";
+var c = {
+  brand: (s) => pc.bold(pc.cyan(s)),
+  success: (s) => pc.bold(s),
+  path: (s) => pc.underline(s),
+  slug: (s) => pc.cyan(s),
+  prompt: (s) => pc.bold(pc.yellow(s)),
+  error: (s) => pc.red(s),
+  errorLabel: (s) => pc.bold(pc.red(s)),
+  dim: (s) => pc.dim(s),
+  bold: (s) => pc.bold(s)
+};
+var LOGO = [
+  "   ____ _     _           _     ",
+  "  / ___(_)___| |_ __ _   (_)___ ",
+  " | |  _| / __| __/ _` |  | / __|",
+  " | |_| | \\__ \\ || (_| |_ | \\__ \\",
+  "  \\____|_|___/\\__\\__,_(_)/ |___/",
+  "                       |__/     "
+];
+function lerp(a, b, t) {
+  return Math.round(a + (b - a) * t);
+}
+function rgb(r, g, b, text) {
+  return `\x1B[38;2;${r};${g};${b}m${text}\x1B[39m`;
+}
+function logo() {
+  let from = [0, 255, 65];
+  let to = [0, 143, 17];
+  let total = LOGO.length;
+  return LOGO.map((line, i) => {
+    let t = total <= 1 ? 0 : i / (total - 1);
+    let r = lerp(from[0], to[0], t);
+    let g = lerp(from[1], to[1], t);
+    let b = lerp(from[2], to[2], t);
+    return rgb(r, g, b, line);
+  }).join("\n");
+}
+
 // src/create.ts
 import {
   cp,
@@ -58,11 +98,13 @@ async function promptForStarter(starters) {
   let rl = createPrompt();
   try {
     let options = starters.map(
-      (starter2, index2) => `${index2 + 1}. ${starter2.slug} - ${starter2.description}`
+      (starter2, index2) => `  ${c.dim(`${index2 + 1}.`)} ${c.slug(starter2.slug)} ${c.dim("\u2014")} ${starter2.description}`
     ).join("\n");
-    let answer = await rl.question(`Choose a starter:
+    let answer = await rl.question(
+      `${c.prompt("Choose a starter:")}
 ${options}
-> `);
+${c.dim(">")} `
+    );
     let index = Number.parseInt(answer.trim(), 10) - 1;
     let starter = starters[index];
     if (!starter) throw new Error("Invalid starter selection");
@@ -75,10 +117,12 @@ async function promptForGitIdentity() {
   let rl = createPrompt();
   try {
     console.log(
-      "Before I make the first commit, Git needs a name and email to attach to it."
+      c.dim(
+        "Before I make the first commit, Git needs a name and email to attach to it."
+      )
     );
-    let name = (await rl.question("Your name: ")).trim();
-    let email = (await rl.question("Your email: ")).trim();
+    let name = (await rl.question(c.prompt("Your name: "))).trim();
+    let email = (await rl.question(c.prompt("Your email: "))).trim();
     if (!name) throw new Error("Name is required to make the first commit");
     if (!email) throw new Error("Email is required to make the first commit");
     let saveGlobal = await confirm(
@@ -90,6 +134,16 @@ async function promptForGitIdentity() {
     rl.close();
   }
 }
+async function promptConfirm(message, defaultYes = true) {
+  let rl = createPrompt();
+  try {
+    let answer = (await rl.question(c.prompt(message))).trim().toLowerCase();
+    if (answer === "") return defaultYes;
+    return answer === "y" || answer === "yes";
+  } finally {
+    rl.close();
+  }
+}
 function createPrompt() {
   return readline.createInterface({
     input: process.stdin,
@@ -97,7 +151,7 @@ function createPrompt() {
   });
 }
 async function confirm(rl, message) {
-  let answer = (await rl.question(message)).trim().toLowerCase();
+  let answer = (await rl.question(c.dim(message))).trim().toLowerCase();
   return answer === "y" || answer === "yes";
 }
 
@@ -113,7 +167,9 @@ async function run(command, args, cwd) {
     child.once("exit", (code) => {
       if (code === 0) resolve2();
       else {
-        reject(new Error(`${command} ${args.join(" ")} exited with code ${code}`));
+        reject(
+          new Error(`${command} ${args.join(" ")} exited with code ${code}`)
+        );
       }
     });
   });
@@ -325,12 +381,10 @@ async function diffStarter(starter, options, deps = defaultDeps2) {
     await git2(root, ["remote", "add", "origin", repoUrl], deps);
     await fetchTag(root, fromTag, repoUrl, deps);
     await fetchTag(root, toTag, repoUrl, deps);
-    return await gitOutput(
-      root,
-      ["diff", "--stat", `refs/tags/${fromTag}`, `refs/tags/${toTag}`],
-      repoUrl,
-      deps
-    );
+    let diffArgs = ["diff"];
+    if (options.stat) diffArgs.push("--stat");
+    diffArgs.push(`refs/tags/${fromTag}`, `refs/tags/${toTag}`);
+    return await gitOutput(root, diffArgs, repoUrl, deps);
   } finally {
     await deps.rm(root, { recursive: true, force: true });
   }
@@ -345,7 +399,13 @@ async function fetchTag(cwd, tag, repoUrl, deps) {
   try {
     await git2(
       cwd,
-      ["fetch", "--quiet", "--no-tags", "origin", `refs/tags/${tag}:refs/tags/${tag}`],
+      [
+        "fetch",
+        "--quiet",
+        "--no-tags",
+        "origin",
+        `refs/tags/${tag}:refs/tags/${tag}`
+      ],
       deps
     );
   } catch (error) {
@@ -405,12 +465,15 @@ var defaultDeps3 = {
   createProject,
   diffStarter,
   promptForStarter,
+  promptConfirm,
   stdout: console
 };
 var UsageError = class extends Error {
-  constructor(message) {
+  command;
+  constructor(message, command) {
     super(message);
     this.name = "UsageError";
+    this.command = command;
   }
 };
 async function runCli(argv = process3.argv.slice(2), deps = defaultDeps3) {
@@ -419,36 +482,50 @@ async function runCli(argv = process3.argv.slice(2), deps = defaultDeps3) {
     deps.stdout.log(getHelpText());
     return;
   }
+  if (command === "logo") {
+    deps.stdout.log("\n" + logo() + "\n");
+    return;
+  }
   if (command === "create") {
     let options = parseCreateArgs(rest);
     if (!options.projectName) {
-      throw new UsageError("Project name is required");
+      throw new UsageError("Project name is required", "create");
     }
     let catalog = await deps.loadCatalog(options.catalogUrl);
     let starterName = options.starter || await deps.promptForStarter(catalog);
     let starter = catalog.find((entry) => entry.slug === starterName);
     if (!starter) {
-      throw new UsageError(`Unknown starter: ${starterName}`);
+      throw new UsageError(`Unknown starter: ${starterName}`, "create");
+    }
+    if (options.git === void 0) {
+      options.git = await deps.promptConfirm("Initialize git? (Y/n) ");
+    }
+    if (options.install === void 0) {
+      options.install = await deps.promptConfirm("Install dependencies? (Y/n) ");
     }
     let root = await deps.createProject(starter, options);
-    deps.stdout.log(`Created ${starter.slug} project in ${root}`);
+    deps.stdout.log(
+      `
+  ${c.brand("gistajs")} ${c.success("Created")} ${c.slug(starter.slug)} project in ${c.path(root)}
+`
+    );
     return;
   }
   if (command === "diff") {
     let options = parseDiffArgs(rest);
     if (!options.starter) {
-      throw new UsageError("Starter is required");
+      throw new UsageError("Starter is required", "diff");
     }
     if (!options.fromReleaseKey) {
-      throw new UsageError("From release key is required");
+      throw new UsageError("From release key is required", "diff");
     }
     if (!options.toReleaseKey) {
-      throw new UsageError("To release key is required");
+      throw new UsageError("To release key is required", "diff");
     }
     let catalog = await deps.loadCatalog(options.catalogUrl);
     let starter = catalog.find((entry) => entry.slug === options.starter);
     if (!starter) {
-      throw new UsageError(`Unknown starter: ${options.starter}`);
+      throw new UsageError(`Unknown starter: ${options.starter}`, "diff");
     }
     let output = await deps.diffStarter(starter, options);
     deps.stdout.log(output.trimEnd());
@@ -457,10 +534,7 @@ async function runCli(argv = process3.argv.slice(2), deps = defaultDeps3) {
   throw new UsageError(`Unknown command: ${command}`);
 }
 function parseCreateArgs(argv) {
-  let options = {
-    install: true,
-    git: true
-  };
+  let options = {};
   for (let index = 0; index < argv.length; index += 1) {
     let arg = argv[index];
     if (!arg) continue;
@@ -469,7 +543,8 @@ function parseCreateArgs(argv) {
       continue;
     }
     if (arg === "--starter") {
-      if (!argv[index + 1]) throw new UsageError("--starter requires a value");
+      if (!argv[index + 1])
+        throw new UsageError("--starter requires a value", "create");
       options.starter = argv[index + 1];
       index += 1;
       continue;
@@ -484,13 +559,13 @@ function parseCreateArgs(argv) {
     }
     if (arg === "--catalog-url") {
       if (!argv[index + 1]) {
-        throw new UsageError("--catalog-url requires a value");
+        throw new UsageError("--catalog-url requires a value", "create");
       }
       options.catalogUrl = argv[index + 1];
       index += 1;
       continue;
     }
-    throw new UsageError(`Unknown argument: ${arg}`);
+    throw new UsageError(`Unknown argument: ${arg}`, "create");
   }
   return options;
 }
@@ -511,30 +586,66 @@ function parseDiffArgs(argv) {
       options.toReleaseKey = arg;
       continue;
     }
+    if (arg === "--stat") {
+      options.stat = true;
+      continue;
+    }
     if (arg === "--catalog-url") {
       if (!argv[index + 1]) {
-        throw new UsageError("--catalog-url requires a value");
+        throw new UsageError("--catalog-url requires a value", "diff");
       }
       options.catalogUrl = argv[index + 1];
       index += 1;
       continue;
     }
-    throw new UsageError(`Unknown argument: ${arg}`);
+    throw new UsageError(`Unknown argument: ${arg}`, "diff");
   }
   return options;
 }
-function getHelpText() {
+function getHelpText(command) {
+  let header = `  ${c.brand("gistajs")} ${c.dim("\u2014 scaffold Gista.js starter projects")}`;
+  if (command === "create") {
+    return [
+      "",
+      header,
+      "",
+      `  ${c.bold("Usage:")}`,
+      `    ${c.dim("$")} ${c.bold("gistajs create")} <project-name> [--starter <slug>] [--no-install] [--no-git]`,
+      "",
+      `  ${c.bold("Examples:")}`,
+      `    ${c.dim("$")} gistajs create my-app`,
+      `    ${c.dim("$")} gistajs create my-app --starter website`,
+      ""
+    ].join("\n");
+  }
+  if (command === "diff") {
+    return [
+      "",
+      header,
+      "",
+      `  ${c.bold("Usage:")}`,
+      `    ${c.dim("$")} ${c.bold("gistajs diff")} <starter> <from-release-key> <to-release-key> [--stat]`,
+      "",
+      `  ${c.bold("Examples:")}`,
+      `    ${c.dim("$")} gistajs diff auth 2026-03-28-001 2026-03-29-001`,
+      `    ${c.dim("$")} gistajs diff auth 2026-03-28-001 2026-03-29-001 --stat`,
+      ""
+    ].join("\n");
+  }
   return [
-    "Usage:",
-    "  gistajs create <project-name> [--starter <slug>] [--no-install] [--no-git]",
-    "  gistajs diff <starter> <from-release-key> <to-release-key>",
     "",
-    "Examples:",
-    "  gistajs create my-app",
-    "  gistajs create my-app --starter website",
-    "  gistajs diff auth 2026-03-28-001 2026-03-29-001",
+    header,
+    "",
+    `  ${c.bold("Usage:")}`,
+    `    ${c.dim("$")} ${c.bold("gistajs create")} <project-name> [--starter <slug>] [--no-install] [--no-git]`,
+    `    ${c.dim("$")} ${c.bold("gistajs diff")} <starter> <from-release-key> <to-release-key> [--stat]`,
     "",
-    "Run `gistajs` with no arguments to show this help."
+    `  ${c.bold("Examples:")}`,
+    `    ${c.dim("$")} gistajs create my-app`,
+    `    ${c.dim("$")} gistajs create my-app --starter website`,
+    `    ${c.dim("$")} gistajs diff auth 2026-03-28-001 2026-03-29-001`,
+    `    ${c.dim("$")} gistajs diff auth 2026-03-28-001 2026-03-29-001 --stat`,
+    ""
   ].join("\n");
 }
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gistajs",
-  "version": "0.0.9",
+  "version": "0.1.0",
   "description": "Create Gista.js starter projects",
   "keywords": [
     "cli",
@@ -33,7 +33,8 @@
     }
   },
   "dependencies": {
-    "tar": "^7.5.1"
+    "picocolors": "^1.1.1",
+    "tar": "^7.5.13"
   },
   "devDependencies": {
     "@types/node": "^25.5.0",
@@ -41,7 +42,7 @@
     "oxfmt": "^0.40.0",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
-    "vitest": "^4.1.0"
+    "vitest": "^4.1.2"
   },
   "engines": {
     "node": ">=20"