@zoralabs/cli 0.3.0 → 0.3.1

package/dist/index.js

@@ -52,6 +52,12 @@ function apiErrorMessage(err) {
     return "Zora is temporarily unavailable. Try again later.";
   return formatError(err);
 }
+function bannedCoinMessage(address) {
+  return `The coin at ${address} is unavailable because it violates the Zora terms of service.`;
+}
+function bannedCoinBuyMessage(address) {
+  return `Unable to buy ${address} because it violates the Zora terms of service. Already own this coin? Run zora sell ${address} --all to exit your position.`;
+}
 function fsErrorMessage(err, path) {
   if (!(err instanceof Error)) return String(err);
   const code = err.code;
@@ -431,7 +437,7 @@ var getClient = () => {
   return client;
 };
 var commonProperties = () => ({
-  cli_version: true ? "0.3.0" : "development",
+  cli_version: true ? "0.3.1" : "development",
   os: process.platform,
   arch: process.arch,
   node_version: process.version
@@ -671,7 +677,7 @@ var Table = ({
 
 // src/lib/format.ts
 import { format, formatDistanceStrict } from "date-fns";
-import { formatEther } from "viem";
+import { formatUnits } from "viem";
 function formatCompactUsd(value) {
   if (!value || Number(value) === 0) return "$0";
   return new Intl.NumberFormat("en-US", {
@@ -720,17 +726,28 @@ function formatCreatedAt(isoDate, now) {
   if (isNaN(date.getTime())) return "-";
   return `${formatRelativeTime(date, now)} (${formatAbsoluteTime(date)})`;
 }
-var formatEthDisplay = (wei) => {
-  const eth = formatEther(wei);
-  const parts = eth.split(".");
-  if (!parts[1]) return eth;
-  const trimmed = parts[1].replace(/0+$/, "") || "0";
-  return `${parts[0]}.${trimmed}`;
+var formatAmountDisplay = (amount, decimals) => {
+  const formatted = formatUnits(amount, decimals);
+  const parts = formatted.split(".");
+  if (!parts[1]) {
+    return new Intl.NumberFormat("en-US", {
+      maximumFractionDigits: 2
+    }).format(Number(formatted));
+  }
+  const twoDecimal = `${parts[0]}.${parts[1].slice(0, 2)}`;
+  if (Number(twoDecimal) === 0 && amount > 0n) {
+    const sigIndex = parts[1].search(/[1-9]/);
+    const maxDecimals = sigIndex === -1 ? 6 : Math.min(sigIndex + 4, parts[1].length);
+    const truncated = `${parts[0]}.${parts[1].slice(0, maxDecimals)}`;
+    return new Intl.NumberFormat("en-US", {
+      maximumFractionDigits: maxDecimals
+    }).format(Number(truncated));
+  }
+  return new Intl.NumberFormat("en-US", {
+    maximumFractionDigits: 2
+  }).format(Number(formatted));
 };
 var truncateAddress = (address) => `${address.slice(0, 6)}\u2026${address.slice(-4)}`;
-var formatCoinsDisplay = (coinsOut) => new Intl.NumberFormat("en-US", {
-  maximumFractionDigits: 2
-}).format(Number(coinsOut));
 
 // src/lib/balance-format.ts
 var COIN_DECIMALS = 18;
@@ -961,8 +978,7 @@ var BalanceView = ({
   const hints = [];
   if (paginated && cursorHistory.length > 0) hints.push("\u2190 prev");
   if (paginated && data?.pageInfo?.hasNextPage) hints.push("\u2192 next");
-  hints.push("r refresh");
-  if (autoRefresh) hints.push(`auto: ${secondsUntilRefresh}s`);
+  hints.push(autoRefresh ? `r refresh (${secondsUntilRefresh}s)` : "r refresh");
   hints.push("q quit");
   const footer = hints.join("  \xB7  ");
   const showWallet = mode === "full" || mode === "wallet";
@@ -1017,7 +1033,7 @@ import { getTokenInfo } from "@zoralabs/coins-sdk";
 import {
   createPublicClient as createPublicClient2,
   erc20Abi,
-  formatUnits,
+  formatUnits as formatUnits2,
   http
 } from "viem";
 import { base as base2 } from "viem/chains";
@@ -1102,7 +1118,7 @@ var fetchWalletBalances = async (walletAddress) => {
   });
   const visible = resolved.filter((r) => r.balance > 0n || r.token.isNative);
   const intermediate = visible.map(({ token, balance, priceUsd }) => {
-    const human = formatUnits(balance, token.decimals);
+    const human = formatUnits2(balance, token.decimals);
     const usdValue = priceUsd !== null ? Number(human) * priceUsd : null;
     return { token, human, priceUsd, usdValue };
   });
@@ -1527,10 +1543,10 @@ balanceCommand.command("coins").description("Show coin positions").option("--sor
 // src/commands/buy.ts
 import { Command as Command3 } from "commander";
 import confirm2 from "@inquirer/confirm";
-import { parseUnits, formatUnits as formatUnits3, isAddress } from "viem";
+import { parseUnits, formatUnits as formatUnits4, isAddress } from "viem";
 import {
   setApiKey as setApiKey2,
-  getCoin,
+  getCoin as getCoin2,
   tradeCoin,
   createTradeCall
 } from "@zoralabs/coins-sdk";
@@ -1538,7 +1554,7 @@ import {
 // src/lib/trade-helpers.ts
 import {
   parseEther,
-  formatUnits as formatUnits2,
+  formatUnits as formatUnits3,
   isAddressEqual,
   parseEventLogs,
   erc20Abi as erc20Abi2
@@ -1571,25 +1587,6 @@ var parsePercentageLikeValue = (value) => {
   const parsed = Number(value);
   return Number.isFinite(parsed) ? parsed : void 0;
 };
-var formatAmountDisplay = (amount, decimals) => {
-  const formatted = formatUnits2(amount, decimals);
-  const parts = formatted.split(".");
-  if (!parts[1]) {
-    return new Intl.NumberFormat("en-US", {
-      maximumFractionDigits: 2
-    }).format(Number(formatted));
-  }
-  const twoDecimal = `${parts[0]}.${parts[1].slice(0, 2)}`;
-  let maxDecimals = 2;
-  if (Number(twoDecimal) === 0 && amount > 0n) {
-    const sigIndex = parts[1].search(/[1-9]/);
-    maxDecimals = sigIndex === -1 ? 6 : Math.min(sigIndex + 4, parts[1].length);
-  }
-  const truncated = `${parts[0]}.${parts[1].slice(0, maxDecimals)}`;
-  return new Intl.NumberFormat("en-US", {
-    maximumFractionDigits: maxDecimals
-  }).format(Number(truncated));
-};
 var getReceivedAmountFromReceipt = ({
   receipt,
   tokenAddress,
@@ -1655,12 +1652,12 @@ var printQuote = (json, info) => {
       coin: info.coinSymbol,
       address: info.address,
       spend: {
-        amount: formatUnits2(info.amountIn, info.inputTokenDecimals),
+        amount: formatUnits3(info.amountIn, info.inputTokenDecimals),
         raw: info.amountIn.toString(),
         symbol: info.inputTokenSymbol
       },
       estimated: {
-        amount: formatUnits2(BigInt(info.amountOut), 18),
+        amount: formatUnits3(BigInt(info.amountOut), 18),
         raw: info.amountOut,
         symbol: info.coinSymbol
       },
@@ -1668,29 +1665,33 @@ var printQuote = (json, info) => {
     });
     return;
   }
+  const spendFormatted = formatAmountDisplay(
+    info.amountIn,
+    info.inputTokenDecimals
+  );
+  const coinsFormatted = formatAmountDisplay(BigInt(info.amountOut), 18);
   console.log(`
- Buy ${info.coinName} (${info.coinSymbol})
+ Buy \x1B[1m${info.coinName}\x1B[0m`);
+  console.log(` ${info.coinType} \xB7 ${info.address}
 `);
-  console.log(`   Amount       ${info.spendAmount}`);
-  console.log(`   You get      ~${info.coinsFormatted} ${info.coinSymbol}`);
+  console.log(`   Amount       ${spendFormatted} ${info.inputTokenSymbol}`);
+  console.log(`   You get      ~${coinsFormatted} ${info.coinSymbol}`);
   console.log(`   Slippage     ${info.slippagePct}%
 `);
 };
 var printTradeResult = (json, info) => {
-  const receivedAmount = formatUnits2(info.receivedAmountOut, 18);
-  const receivedFormatted = formatCoinsDisplay(receivedAmount);
   if (json) {
     outputJson({
       action: "buy",
       coin: info.coinSymbol,
       address: info.address,
       spent: {
-        amount: formatUnits2(info.amountIn, info.inputTokenDecimals),
+        amount: formatUnits3(info.amountIn, info.inputTokenDecimals),
         raw: info.amountIn.toString(),
         symbol: info.inputTokenSymbol
       },
       received: {
-        amount: receivedAmount,
+        amount: formatUnits3(info.receivedAmountOut, 18),
         raw: info.receivedAmountOut.toString(),
         symbol: info.coinSymbol
       },
@@ -1698,21 +1699,233 @@ var printTradeResult = (json, info) => {
     });
     return;
   }
+  const spentFormatted = formatAmountDisplay(
+    info.amountIn,
+    info.inputTokenDecimals
+  );
+  const receivedFormatted = formatAmountDisplay(info.receivedAmountOut, 18);
   console.log(`
- Bought ${info.coinName}
+ Bought \x1B[1m${info.coinName}\x1B[0m`);
+  console.log(` ${info.coinType} \xB7 ${info.address}
 `);
-  console.log(`   Spent        ${info.spendAmount} ${info.inputTokenSymbol}`);
+  console.log(`   Spent        ${spentFormatted} ${info.inputTokenSymbol}`);
   console.log(`   Received     ${receivedFormatted} ${info.coinSymbol}`);
   console.log(`   Tx           ${info.txHash}
 `);
 };
 
+// src/lib/coin-ref.ts
+import { getCoin, getProfile, getTrend } from "@zoralabs/coins-sdk";
+var TYPE_KEYWORDS = /* @__PURE__ */ new Set(["creator-coin", "trend"]);
+var CoinArgError = class extends Error {
+  suggestion;
+  constructor(message, suggestion) {
+    super(message);
+    this.suggestion = suggestion;
+  }
+};
+function parsePositionalCoinArgs(firstArg, secondArg) {
+  if (TYPE_KEYWORDS.has(firstArg)) {
+    if (!secondArg) {
+      throw new CoinArgError(
+        `Missing identifier after "${firstArg}".`,
+        `Usage: zora <command> ${firstArg} <name>`
+      );
+    }
+    return { kind: "typed", type: firstArg, identifier: secondArg };
+  }
+  if (firstArg.startsWith("0x")) {
+    return { kind: "address", address: firstArg };
+  }
+  return { kind: "ambiguous-name", name: firstArg };
+}
+function coinArgsToRef(parsed) {
+  switch (parsed.kind) {
+    case "typed":
+      return { kind: "prefixed", type: parsed.type, name: parsed.identifier };
+    case "address":
+      return { kind: "address", address: parsed.address };
+    case "ambiguous-name":
+      return { kind: "ambiguous", name: parsed.name };
+  }
+}
+async function resolveAmbiguousName(name) {
+  const [creatorResult, trendResult] = await Promise.all([
+    resolveByCreatorName(name),
+    resolveByTrendTicker(name)
+  ]);
+  const creatorFound = creatorResult.kind === "found" ? creatorResult.coin : null;
+  const trendFound = trendResult.kind === "found" ? trendResult.coin : null;
+  if (creatorFound && trendFound) {
+    return { kind: "ambiguous", creator: creatorFound, trend: trendFound };
+  }
+  if (creatorFound) {
+    return { kind: "found", coin: creatorFound };
+  }
+  if (trendFound) {
+    return { kind: "found", coin: trendFound };
+  }
+  return {
+    kind: "not-found",
+    message: `No coin found matching "${name}".`
+  };
+}
+function formatAmbiguousError(name, creator, trend, command) {
+  const creatorMcap = formatCompactUsd(creator.marketCap);
+  const trendMcap = formatCompactUsd(trend.marketCap);
+  return {
+    message: [
+      `Multiple coins match "${name}":`,
+      `  creator-coin  ${creator.name}  ${creatorMcap} mcap`,
+      `  trend         ${trend.name}  ${trendMcap} mcap`
+    ].join("\n"),
+    suggestion: `Use: zora ${command} creator-coin ${name}  or  zora ${command} trend ${name}`
+  };
+}
+var COIN_TYPE_MAP = {
+  CONTENT: "post",
+  CREATOR: "creator-coin",
+  TREND: "trend"
+};
+function mapCoinType(raw) {
+  if (!raw) return "unknown";
+  return COIN_TYPE_MAP[raw] ?? "unknown";
+}
+function coinFromToken(token) {
+  return {
+    name: token.name ?? "Unknown",
+    address: token.address ?? "",
+    coinType: mapCoinType(token.coinType),
+    marketCap: token.marketCap ?? "0",
+    marketCapDelta24h: token.marketCapDelta24h ?? "0",
+    volume24h: token.volume24h ?? "0",
+    uniqueHolders: token.uniqueHolders ?? 0,
+    createdAt: token.createdAt,
+    creatorAddress: token.creatorAddress,
+    creatorHandle: token.creatorProfile?.handle,
+    platformBlocked: token.platformBlocked ?? false
+  };
+}
+async function resolveByAddress(address) {
+  const response = await getCoin({ address });
+  if (response.error || !response.data?.zora20Token) {
+    return {
+      kind: "not-found",
+      message: `No coin found at address ${address}`
+    };
+  }
+  return { kind: "found", coin: coinFromToken(response.data.zora20Token) };
+}
+async function resolveByTrendTicker(ticker) {
+  const response = await getTrend({ ticker });
+  if (response.error || !response.data?.trendCoin) {
+    return {
+      kind: "not-found",
+      message: `No trend coin found with ticker "${ticker}"`
+    };
+  }
+  return { kind: "found", coin: coinFromToken(response.data.trendCoin) };
+}
+async function resolveByCreatorName(name) {
+  const response = await getProfile({ identifier: name });
+  if (response.error || !response.data?.profile) {
+    return {
+      kind: "not-found",
+      message: `No creator found with name "${name}"`
+    };
+  }
+  const profile = response.data.profile;
+  if (!profile.creatorCoin) {
+    return {
+      kind: "not-found",
+      message: `"${name}" does not have a creator coin`
+    };
+  }
+  return resolveByAddress(profile.creatorCoin.address);
+}
+async function resolveCoin(ref) {
+  switch (ref.kind) {
+    case "address":
+      return resolveByAddress(ref.address);
+    case "prefixed":
+      if (ref.type === "trend") {
+        return resolveByTrendTicker(ref.name);
+      }
+      return resolveByCreatorName(ref.name);
+    case "ambiguous":
+      return resolveByCreatorName(ref.name);
+  }
+}
+
 // src/commands/buy.ts
-var buyCommand = new Command3("buy").description("Buy a coin").argument("[address]", "Coin contract address (0x\u2026)").option("--eth <value>", "Buy with ETH amount").option("--usd <value>", "Buy with USD equivalent (use with --token)").option("--token <asset>", "Token to spend: eth, usdc, zora", "eth").option("--percent <value>", "Buy with percentage of ETH balance").option("--all", "Swap all ETH for coin").option("--quote", "Print quote and exit without trading").option("--yes", "Skip confirmation and execute directly").option("--slippage <pct>", "Slippage tolerance percent", "1").option("--debug", "Print full quote request/response JSON").action(async function(coinAddress, opts) {
+var buyCommand = new Command3("buy").description("Buy a coin").argument(
+  "[typeOrId]",
+  "Type prefix (creator-coin, trend) or coin address/name"
+).argument("[identifier]", "Coin name (when type prefix is given)").option("--eth <value>", "Buy with ETH amount").option("--usd <value>", "Buy with USD equivalent (use with --token)").option("--token <asset>", "Token to spend: eth, usdc, zora", "eth").option("--percent <value>", "Buy with percentage of ETH balance").option("--all", "Swap all ETH for coin").option("--quote", "Print quote and exit without trading").option("--yes", "Skip confirmation and execute directly").option("--slippage <pct>", "Slippage tolerance percent", "1").option("--debug", "Print full quote request/response JSON").action(async function(typeOrId, identifier, opts) {
   const json = getJson(this);
   const debug = opts.debug === true;
-  if (!isAddress(coinAddress)) {
-    outputErrorAndExit(json, `Invalid address: ${coinAddress}`);
+  let parsed;
+  try {
+    parsed = parsePositionalCoinArgs(typeOrId, identifier);
+  } catch (err) {
+    if (err instanceof CoinArgError) {
+      outputErrorAndExit(json, err.message, err.suggestion);
+    }
+    throw err;
+  }
+  const apiKey = getApiKey();
+  if (apiKey) {
+    setApiKey2(apiKey);
+  }
+  let coinAddress;
+  if (parsed.kind === "address") {
+    if (!isAddress(parsed.address)) {
+      outputErrorAndExit(json, `Invalid address: ${parsed.address}`);
+      return;
+    }
+    coinAddress = parsed.address;
+  } else if (parsed.kind === "ambiguous-name") {
+    let ambResult;
+    try {
+      ambResult = await resolveAmbiguousName(parsed.name);
+    } catch (err) {
+      outputErrorAndExit(
+        json,
+        `Request failed: ${err instanceof Error ? err.message : String(err)}`
+      );
+      return;
+    }
+    if (ambResult.kind === "not-found") {
+      outputErrorAndExit(json, ambResult.message);
+      return;
+    }
+    if (ambResult.kind === "ambiguous") {
+      const { message, suggestion } = formatAmbiguousError(
+        parsed.name,
+        ambResult.creator,
+        ambResult.trend,
+        "buy"
+      );
+      outputErrorAndExit(json, message, suggestion);
+      return;
+    }
+    coinAddress = ambResult.coin.address;
+  } else {
+    const ref = coinArgsToRef(parsed);
+    try {
+      const result = await resolveCoin(ref);
+      if (result.kind === "not-found") {
+        outputErrorAndExit(json, result.message, result.suggestion);
+        return;
+      }
+      coinAddress = result.coin.address;
+    } catch (err) {
+      outputErrorAndExit(
+        json,
+        `Request failed: ${err instanceof Error ? err.message : String(err)}`
+      );
+      return;
+    }
   }
   const tokenKey = opts.token.toLowerCase();
   if (!(tokenKey in BASE_TRADE_TOKENS)) {
@@ -1736,15 +1949,11 @@ var buyCommand = new Command3("buy").description("Buy a coin").argument("[addres
     );
   }
   const slippage = slippagePct / 100;
-  const apiKey = getApiKey();
-  if (apiKey) {
-    setApiKey2(apiKey);
-  }
   const account = resolveAccount(json);
   const { publicClient, walletClient } = createClients(account);
   let token;
   try {
-    const response = await getCoin({ address: coinAddress });
+    const response = await getCoin2({ address: coinAddress });
     token = response.data?.zora20Token;
   } catch (err) {
     outputErrorAndExit(json, `Failed to fetch coin: ${apiErrorMessage(err)}`);
@@ -1752,8 +1961,12 @@ var buyCommand = new Command3("buy").description("Buy a coin").argument("[addres
   if (!token) {
     outputErrorAndExit(json, `Coin not found: ${coinAddress}`);
   }
+  if (token.platformBlocked) {
+    outputErrorAndExit(json, bannedCoinBuyMessage(coinAddress));
+  }
   const coinName = token.name;
   const coinSymbol = token.symbol;
+  const coinType = mapCoinType(token.coinType);
   let amountIn;
   if (amountMode === "usd") {
     const usdVal = parsePercentageLikeValue(opts.usd);
@@ -1788,7 +2001,7 @@ var buyCommand = new Command3("buy").description("Buy a coin").argument("[addres
     }
     if (debug) {
       console.error(
-        `[debug] $${usdVal} USD = ${formatUnits3(amountIn, inputToken.decimals)} ${inputToken.symbol} (price: $${priceUsd})`
+        `[debug] $${usdVal} USD = ${formatUnits4(amountIn, inputToken.decimals)} ${inputToken.symbol} (price: $${priceUsd})`
       );
     }
   } else if (amountMode === "eth") {
@@ -1841,7 +2054,7 @@ var buyCommand = new Command3("buy").description("Buy a coin").argument("[addres
     if (isEth && balance <= gasReserve) {
       outputErrorAndExit(
         json,
-        `Balance too low (${formatEthDisplay(balance)} ETH). Need >${formatEthDisplay(GAS_RESERVE)} ETH for gas.`
+        `Balance too low (${formatAmountDisplay(balance, 18)} ETH). Need >${formatAmountDisplay(GAS_RESERVE, 18)} ETH for gas.`
       );
     }
     const spendableBalance = balance - gasReserve;
@@ -1871,7 +2084,7 @@ var buyCommand = new Command3("buy").description("Buy a coin").argument("[addres
     const priceUsd = inputToken.fixedPriceUsd ?? await fetchTokenPriceUsd(inputToken.priceAddress);
     if (priceUsd != null) {
       swapAmountUsd = Number(
-        (Number(formatUnits3(amountIn, inputToken.decimals)) * priceUsd).toFixed(2)
+        (Number(formatUnits4(amountIn, inputToken.decimals)) * priceUsd).toFixed(2)
       );
     }
   }
@@ -1926,25 +2139,19 @@ ${err instanceof Error ? err.stack || err.message : String(err)}
       "Check the coin address is valid and try again. Use --debug for full error details."
     );
   }
-  const spendAmount = formatUnits3(amountIn, inputToken.decimals);
-  const spendFormatted = new Intl.NumberFormat("en-US", {
-    maximumFractionDigits: 6
-  }).format(Number(spendAmount));
-  const coinsOut = formatUnits3(BigInt(amountOut), 18);
-  const coinsFormatted = formatCoinsDisplay(coinsOut);
+  const quoteInfo = {
+    coinName,
+    coinSymbol,
+    coinType,
+    address: coinAddress,
+    amountIn,
+    inputTokenSymbol: inputToken.symbol,
+    inputTokenDecimals: inputToken.decimals,
+    amountOut,
+    slippagePct
+  };
   if (opts.quote) {
-    printQuote(json, {
-      coinName,
-      coinSymbol,
-      address: coinAddress,
-      spendAmount: `${spendFormatted} ${inputToken.symbol}`,
-      amountIn,
-      inputTokenSymbol: inputToken.symbol,
-      inputTokenDecimals: inputToken.decimals,
-      coinsFormatted,
-      amountOut,
-      slippagePct
-    });
+    printQuote(json, quoteInfo);
     track("cli_buy", {
       action: "quote",
       coin_address: coinAddress,
@@ -1960,18 +2167,7 @@ ${err instanceof Error ? err.stack || err.message : String(err)}
     return;
   }
   if (!opts.yes) {
-    printQuote(false, {
-      coinName,
-      coinSymbol,
-      address: coinAddress,
-      spendAmount: `${spendFormatted} ${inputToken.symbol}`,
-      amountIn,
-      inputTokenSymbol: inputToken.symbol,
-      inputTokenDecimals: inputToken.decimals,
-      coinsFormatted,
-      amountOut,
-      slippagePct
-    });
+    printQuote(false, quoteInfo);
     const ok = await confirm2({
       message: "Confirm?",
       default: false
@@ -2028,8 +2224,8 @@ ${err instanceof Error ? err.stack || err.message : String(err)}
   printTradeResult(json, {
     coinName,
     coinSymbol,
+    coinType,
     address: coinAddress,
-    spendAmount,
     amountIn,
     inputTokenSymbol: inputToken.symbol,
     inputTokenDecimals: inputToken.decimals,
@@ -2063,9 +2259,6 @@ import {
   getCoinsTopVolume24h,
   getCoinsMostValuable,
   getCoinsNew,
-  getCoinsTopGainers,
-  getCoinsLastTraded,
-  getCoinsLastTradedUnique,
   getExploreTopVolumeAll24h,
   getExploreTopVolumeCreators24h,
   getExploreNewAll,
@@ -2088,9 +2281,6 @@ var SORT_LABELS2 = {
   mcap: "Top by Market Cap",
   volume: "Top by 24h Volume",
   new: "New",
-  gainers: "Top Gainers (24h)",
-  "last-traded": "Last Traded",
-  "last-traded-unique": "Last Traded (Unique)",
   trending: "Trending",
   featured: "Featured"
 };
@@ -2340,8 +2530,7 @@ var ExploreView = ({
   hints.push("c copy address");
   if (cursorHistory.length > 0) hints.push("\u2190 prev");
   if (pageInfo?.hasNextPage) hints.push("\u2192 next");
-  hints.push("r refresh");
-  if (autoRefresh) hints.push(`auto: ${secondsUntilRefresh}s`);
+  hints.push(autoRefresh ? `r refresh (${secondsUntilRefresh}s)` : "r refresh");
   hints.push("q quit");
   const footer = hints.join("  \xB7  ") + (copyFeedback ? `  ${copyFeedback}` : "");
   return /* @__PURE__ */ jsx4(
@@ -2378,15 +2567,6 @@ var QUERY_MAP = {
     "creator-coin": getCreatorCoins,
     post: getCoinsNew
   },
-  gainers: {
-    post: getCoinsTopGainers
-  },
-  "last-traded": {
-    post: getCoinsLastTraded
-  },
-  "last-traded-unique": {
-    post: getCoinsLastTradedUnique
-  },
   trending: {
     all: getTrendingAll,
     trend: getTrendingTrends,
@@ -2428,7 +2608,7 @@ var SORT_OPTIONS2 = Object.keys(SORT_LABELS2).join(", ");
 var exploreCommand = new Command4("explore").description("Browse top, new, and highest volume coins").option("--sort <sort>", `Sort by: ${SORT_OPTIONS2}`, "mcap").option(
   "--type <type>",
   "Filter by type: all, trend, creator-coin, post (availability varies by sort)",
-  "post"
+  "creator-coin"
 ).option("--limit <n>", "Number of results (max 20)", "10").option("--after <cursor>", "Pagination cursor from a previous result").option("--live", "Interactive live-updating display (default)").option("--static", "Static snapshot").option(
   "--refresh <seconds>",
   "Auto-refresh interval in seconds, requires --live (min 5)",
@@ -2560,130 +2740,42 @@ var exploreCommand = new Command4("explore").description("Browse top, new, and h
 import { Command as Command5 } from "commander";
 import { setApiKey as setApiKey4 } from "@zoralabs/coins-sdk";
 
-// src/lib/coin-ref.ts
-import { getCoin as getCoin2, getProfile, getTrend } from "@zoralabs/coins-sdk";
-var COIN_TYPE_MAP = {
-  CONTENT: "post",
-  CREATOR: "creator-coin",
-  TREND: "trend"
-};
-function mapCoinType(raw) {
-  if (!raw) return "unknown";
-  return COIN_TYPE_MAP[raw] ?? "unknown";
-}
-function coinFromToken(token) {
-  return {
-    name: token.name ?? "Unknown",
-    address: token.address ?? "",
-    coinType: mapCoinType(token.coinType),
-    marketCap: token.marketCap ?? "0",
-    marketCapDelta24h: token.marketCapDelta24h ?? "0",
-    volume24h: token.volume24h ?? "0",
-    uniqueHolders: token.uniqueHolders ?? 0,
-    createdAt: token.createdAt,
-    creatorAddress: token.creatorAddress,
-    creatorHandle: token.creatorProfile?.handle
-  };
+// src/components/CoinDetail.tsx
+import { Box as Box5, Text as Text5 } from "ink";
+import { jsx as jsx6, jsxs as jsxs5 } from "react/jsx-runtime";
+var LABEL_WIDTH = 18;
+function Row({
+  label,
+  children
+}) {
+  return /* @__PURE__ */ jsxs5(Box5, { children: [
+    /* @__PURE__ */ jsx6(Box5, { width: LABEL_WIDTH, flexShrink: 0, children: /* @__PURE__ */ jsx6(Text5, { dimColor: true, children: label }) }),
+    /* @__PURE__ */ jsx6(Text5, { children })
+  ] });
 }
-function parseCoinRef(identifier, type) {
-  if (identifier.startsWith("0x")) {
-    return { kind: "address", address: identifier };
-  }
-  if (type === "creator-coin") {
-    return { kind: "prefixed", type: "creator-coin", name: identifier };
-  }
-  if (type === "trend") {
-    return { kind: "prefixed", type: "trend", name: identifier };
-  }
-  return { kind: "ambiguous", name: identifier };
-}
-async function resolveByAddress(address) {
-  const response = await getCoin2({ address });
-  if (response.error || !response.data?.zora20Token) {
-    return {
-      kind: "not-found",
-      message: `No coin found at address ${address}`
-    };
-  }
-  return { kind: "found", coin: coinFromToken(response.data.zora20Token) };
-}
-async function resolveByTrendTicker(ticker) {
-  const response = await getTrend({ ticker });
-  if (response.error || !response.data?.trendCoin) {
-    return {
-      kind: "not-found",
-      message: `No trend coin found with ticker "${ticker}"`
-    };
-  }
-  return { kind: "found", coin: coinFromToken(response.data.trendCoin) };
-}
-async function resolveByCreatorName(name) {
-  const response = await getProfile({ identifier: name });
-  if (response.error || !response.data?.profile) {
-    return {
-      kind: "not-found",
-      message: `No creator found with name "${name}"`
-    };
-  }
-  const profile = response.data.profile;
-  if (!profile.creatorCoin) {
-    return {
-      kind: "not-found",
-      message: `"${name}" does not have a creator coin`
-    };
-  }
-  return resolveByAddress(profile.creatorCoin.address);
-}
-async function resolveCoin(ref) {
-  switch (ref.kind) {
-    case "address":
-      return resolveByAddress(ref.address);
-    case "prefixed":
-      if (ref.type === "trend") {
-        return resolveByTrendTicker(ref.name);
-      }
-      return resolveByCreatorName(ref.name);
-    case "ambiguous":
-      return resolveByCreatorName(ref.name);
-  }
-}
-
-// src/components/CoinDetail.tsx
-import { Box as Box5, Text as Text5 } from "ink";
-import { jsx as jsx6, jsxs as jsxs5 } from "react/jsx-runtime";
-var LABEL_WIDTH = 18;
-function Row({
-  label,
-  children
-}) {
-  return /* @__PURE__ */ jsxs5(Box5, { children: [
-    /* @__PURE__ */ jsx6(Box5, { width: LABEL_WIDTH, flexShrink: 0, children: /* @__PURE__ */ jsx6(Text5, { dimColor: true, children: label }) }),
-    /* @__PURE__ */ jsx6(Text5, { children })
-  ] });
-}
-function CoinDetail({ coin }) {
-  const change = formatMcapChange(coin.marketCap, coin.marketCapDelta24h);
-  return /* @__PURE__ */ jsxs5(Box5, { flexDirection: "column", paddingLeft: 1, children: [
-    /* @__PURE__ */ jsxs5(Box5, { marginTop: 1, flexDirection: "column", children: [
-      /* @__PURE__ */ jsx6(Text5, { bold: true, children: coin.name }),
-      /* @__PURE__ */ jsxs5(Text5, { children: [
-        coin.coinType,
-        " ",
-        "\xB7",
-        " ",
-        coin.address
-      ] })
-    ] }),
-    /* @__PURE__ */ jsxs5(Box5, { marginTop: 1, flexDirection: "column", children: [
-      /* @__PURE__ */ jsx6(Row, { label: "Market Cap", children: formatCompactUsd(coin.marketCap) }),
-      /* @__PURE__ */ jsx6(Row, { label: "24h Volume", children: formatCompactUsd(coin.volume24h) }),
-      /* @__PURE__ */ jsx6(Row, { label: "24h Change", children: /* @__PURE__ */ jsx6(Text5, { color: change.color, children: change.text }) }),
-      /* @__PURE__ */ jsx6(Row, { label: "Holders", children: formatHolders(coin.uniqueHolders) }),
-      coin.coinType === "post" && (coin.creatorHandle ?? coin.creatorAddress) && /* @__PURE__ */ jsx6(Row, { label: "Creator", children: coin.creatorHandle ?? coin.creatorAddress }),
-      /* @__PURE__ */ jsx6(Row, { label: "Created", children: formatCreatedAt(coin.createdAt) })
-    ] }),
-    /* @__PURE__ */ jsx6(Box5, { marginBottom: 1 })
-  ] });
+function CoinDetail({ coin }) {
+  const change = formatMcapChange(coin.marketCap, coin.marketCapDelta24h);
+  return /* @__PURE__ */ jsxs5(Box5, { flexDirection: "column", paddingLeft: 1, children: [
+    /* @__PURE__ */ jsxs5(Box5, { marginTop: 1, flexDirection: "column", children: [
+      /* @__PURE__ */ jsx6(Text5, { bold: true, children: coin.name }),
+      /* @__PURE__ */ jsxs5(Text5, { children: [
+        coin.coinType,
+        " ",
+        "\xB7",
+        " ",
+        coin.address
+      ] })
+    ] }),
+    /* @__PURE__ */ jsxs5(Box5, { marginTop: 1, flexDirection: "column", children: [
+      /* @__PURE__ */ jsx6(Row, { label: "Market Cap", children: formatCompactUsd(coin.marketCap) }),
+      /* @__PURE__ */ jsx6(Row, { label: "24h Volume", children: formatCompactUsd(coin.volume24h) }),
+      /* @__PURE__ */ jsx6(Row, { label: "24h Change", children: /* @__PURE__ */ jsx6(Text5, { color: change.color, children: change.text }) }),
+      /* @__PURE__ */ jsx6(Row, { label: "Holders", children: formatHolders(coin.uniqueHolders) }),
+      coin.coinType === "post" && (coin.creatorHandle ?? coin.creatorAddress) && /* @__PURE__ */ jsx6(Row, { label: "Creator", children: coin.creatorHandle ?? coin.creatorAddress }),
+      /* @__PURE__ */ jsx6(Row, { label: "Created", children: formatCreatedAt(coin.createdAt) })
+    ] }),
+    /* @__PURE__ */ jsx6(Box5, { marginBottom: 1 })
+  ] });
 }
 
 // src/commands/get.tsx
@@ -2702,29 +2794,87 @@ function formatCoinJson(coin) {
     creatorHandle: coin.creatorHandle ?? null
   };
 }
-var VALID_TYPES = ["creator-coin", "post", "trend"];
-var getCommand = new Command5("get").description("Look up a coin by address or name").argument("[identifier]", "Coin address (0x...) or creator name").option("--type <type>", "Coin type: creator-coin, post, trend").action(async function(identifier, opts) {
+function outputCoin(json, coin) {
+  outputData(json, {
+    json: formatCoinJson(coin),
+    render: () => {
+      renderOnce(/* @__PURE__ */ jsx7(CoinDetail, { coin }));
+    }
+  });
+}
+var getCommand = new Command5("get").description("Look up a coin by address or name").argument("[typeOrId]", "Type prefix (creator-coin, trend) or identifier").argument(
+  "[identifier]",
+  "Coin address (0x...) or name (when type prefix is given)"
+).action(async function(typeOrId, identifier) {
   const json = getJson(this);
-  if (opts.type !== void 0 && !VALID_TYPES.includes(opts.type)) {
-    outputErrorAndExit(
-      json,
-      `Invalid --type value: ${opts.type}.`,
-      `Supported: ${VALID_TYPES.join(", ")}`
-    );
-  }
-  const type = opts.type;
-  if (type === "post" && !identifier.startsWith("0x")) {
-    outputErrorAndExit(
-      json,
-      "Posts can only be looked up by address.",
-      "Use: zora get 0x..."
-    );
+  let parsed;
+  try {
+    parsed = parsePositionalCoinArgs(typeOrId, identifier);
+  } catch (err) {
+    if (err instanceof CoinArgError) {
+      outputErrorAndExit(json, err.message, err.suggestion);
+    }
+    throw err;
   }
-  const ref = parseCoinRef(identifier, opts.type);
   const apiKey = getApiKey();
   if (apiKey) {
     setApiKey4(apiKey);
   }
+  if (parsed.kind === "ambiguous-name") {
+    let ambResult;
+    try {
+      ambResult = await resolveAmbiguousName(parsed.name);
+    } catch (err) {
+      outputErrorAndExit(
+        json,
+        `Request failed: ${err instanceof Error ? err.message : String(err)}`
+      );
+      return;
+    }
+    if (ambResult.kind === "not-found") {
+      outputErrorAndExit(json, ambResult.message);
+      return;
+    }
+    if (ambResult.kind === "ambiguous") {
+      if (json) {
+        outputData(json, {
+          json: {
+            matches: [
+              { type: "creator-coin", ...formatCoinJson(ambResult.creator) },
+              { type: "trend", ...formatCoinJson(ambResult.trend) }
+            ],
+            hint: `Use: zora get creator-coin ${parsed.name}  or  zora get trend ${parsed.name}`
+          },
+          render: () => {
+          }
+        });
+      } else {
+        outputCoin(false, ambResult.creator);
+        console.log("");
+        outputCoin(false, ambResult.trend);
+        console.log(
+          `
+\x1B[2mUse \`zora get creator-coin ${parsed.name}\` or \`zora get trend ${parsed.name}\` for a specific type.\x1B[0m`
+        );
+      }
+      track("cli_get", {
+        lookup_type: "name",
+        found: true,
+        ambiguous: true,
+        output_format: json ? "json" : "text"
+      });
+      return;
+    }
+    outputCoin(json, ambResult.coin);
+    track("cli_get", {
+      lookup_type: "name",
+      found: true,
+      coin_type: ambResult.coin.coinType,
+      output_format: json ? "json" : "text"
+    });
+    return;
+  }
+  const ref = coinArgsToRef(parsed);
   let result;
   try {
     result = await resolveCoin(ref);
@@ -2732,29 +2882,20 @@ var getCommand = new Command5("get").description("Look up a coin by address or n
     outputErrorAndExit(json, `Request failed: ${apiErrorMessage(err)}`);
     return;
   }
-  if (type && result.kind === "found" && result.coin.coinType !== type) {
-    outputErrorAndExit(
-      json,
-      `Coin at ${result.coin.address} is a ${result.coin.coinType}, not a ${type}.`,
-      `Use: zora get ${result.coin.address} --type ${result.coin.coinType}`
-    );
-    return;
-  }
   if (result.kind === "not-found") {
     outputErrorAndExit(json, result.message);
     return;
   }
-  outputData(json, {
-    json: formatCoinJson(result.coin),
-    render: () => {
-      renderOnce(/* @__PURE__ */ jsx7(CoinDetail, { coin: result.coin }));
-    }
-  });
+  if (result.coin.platformBlocked) {
+    outputErrorAndExit(json, bannedCoinMessage(result.coin.address));
+    return;
+  }
+  outputCoin(json, result.coin);
   track("cli_get", {
-    lookup_type: identifier.startsWith("0x") ? "address" : "name",
-    coin_type_filter: type ?? null,
-    found: result.kind === "found",
-    coin_type: result.kind === "found" ? result.coin.coinType : null,
+    lookup_type: typeOrId.startsWith("0x") ? "address" : "name",
+    coin_type_filter: parsed.kind === "typed" ? parsed.type : null,
+    found: true,
+    coin_type: result.coin.coinType,
     output_format: json ? "json" : "text"
   });
 });
@@ -2827,7 +2968,6 @@ var downsample = (values, maxWidth) => {
 
 // src/commands/price-history.tsx
 import { jsx as jsx9 } from "react/jsx-runtime";
-var VALID_TYPES2 = ["creator-coin", "post", "trend"];
 var VALID_INTERVALS = ["1h", "24h", "1w", "1m", "ALL"];
 var INTERVAL_TO_API_FIELD = {
   "1h": "oneHour",
@@ -2868,54 +3008,7 @@ var fetchPriceHistory = async (address, interval) => {
     price: Number(p.closePrice)
   }));
 };
-var priceHistoryCommand = new Command6("price-history").description("Display price history for a coin").argument("[identifier]", "Coin address (0x...) or name").option("--type <type>", "Coin type: creator-coin, post, trend").option(
-  "--interval <interval>",
-  `Time range: ${VALID_INTERVALS.join(", ")}`,
-  "1w"
-).action(async function(identifier, opts) {
-  const json = getJson(this);
-  const interval = opts.interval ?? "1w";
-  if (!VALID_INTERVALS.includes(interval)) {
-    outputErrorAndExit(
-      json,
-      `Invalid --interval value: ${interval}.`,
-      `Supported: ${VALID_INTERVALS.join(", ")}`
-    );
-  }
-  if (opts.type !== void 0 && !VALID_TYPES2.includes(opts.type)) {
-    outputErrorAndExit(
-      json,
-      `Invalid --type value: ${opts.type}.`,
-      `Supported: ${VALID_TYPES2.join(", ")}`
-    );
-  }
-  if (opts.type === "post" && !identifier.startsWith("0x")) {
-    outputErrorAndExit(
-      json,
-      "Posts can only be looked up by address.",
-      "Use: zora price-history 0x..."
-    );
-  }
-  const ref = parseCoinRef(identifier, opts.type);
-  const apiKey = getApiKey();
-  if (apiKey) {
-    setApiKey5(apiKey);
-  }
-  let result;
-  try {
-    result = await resolveCoin(ref);
-  } catch (err) {
-    outputErrorAndExit(
-      json,
-      `Request failed: ${err instanceof Error ? err.message : String(err)}`
-    );
-    return;
-  }
-  if (result.kind === "not-found") {
-    outputErrorAndExit(json, result.message, result.suggestion);
-    return;
-  }
-  const { coin } = result;
+async function showPriceHistory(json, coin, interval) {
   let prices;
   try {
     prices = await fetchPriceHistory(coin.address, interval);
@@ -2941,9 +3034,7 @@ var priceHistoryCommand = new Command6("price-history").description("Display pri
     priceValues[0],
     priceValues[priceValues.length - 1]
   );
-  const sparklineText = sparkline(
-    downsample(priceValues, MAX_SPARKLINE_WIDTH)
-  );
+  const sparklineText = sparkline(downsample(priceValues, MAX_SPARKLINE_WIDTH));
   outputData(json, {
     json: {
       coin: coin.name,
@@ -2974,11 +3065,139 @@ var priceHistoryCommand = new Command6("price-history").description("Display pri
       );
     }
   });
+  return prices.length;
+}
+var priceHistoryCommand = new Command6("price-history").description("Display price history for a coin").argument("[typeOrId]", "Type prefix (creator-coin, trend) or identifier").argument(
+  "[identifier]",
+  "Coin address (0x...) or name (when type prefix is given)"
+).option(
+  "--interval <interval>",
+  `Time range: ${VALID_INTERVALS.join(", ")}`,
+  "1w"
+).action(async function(typeOrId, identifier, opts) {
+  const json = getJson(this);
+  const interval = opts.interval ?? "1w";
+  if (!VALID_INTERVALS.includes(interval)) {
+    outputErrorAndExit(
+      json,
+      `Invalid --interval value: ${interval}.`,
+      `Supported: ${VALID_INTERVALS.join(", ")}`
+    );
+  }
+  let parsed;
+  try {
+    parsed = parsePositionalCoinArgs(typeOrId, identifier);
+  } catch (err) {
+    if (err instanceof CoinArgError) {
+      outputErrorAndExit(json, err.message, err.suggestion);
+    }
+    throw err;
+  }
+  const apiKey = getApiKey();
+  if (apiKey) {
+    setApiKey5(apiKey);
+  }
+  if (parsed.kind === "ambiguous-name") {
+    let ambResult;
+    try {
+      ambResult = await resolveAmbiguousName(parsed.name);
+    } catch (err) {
+      outputErrorAndExit(
+        json,
+        `Request failed: ${err instanceof Error ? err.message : String(err)}`
+      );
+      return;
+    }
+    if (ambResult.kind === "not-found") {
+      outputErrorAndExit(json, ambResult.message);
+      return;
+    }
+    if (ambResult.kind === "ambiguous") {
+      if (json) {
+        const [creatorPrices, trendPrices] = await Promise.all([
+          fetchPriceHistory(ambResult.creator.address, interval),
+          fetchPriceHistory(ambResult.trend.address, interval)
+        ]);
+        outputData(json, {
+          json: {
+            matches: [
+              {
+                type: "creator-coin",
+                coin: ambResult.creator.name,
+                prices: creatorPrices
+              },
+              {
+                type: "trend",
+                coin: ambResult.trend.name,
+                prices: trendPrices
+              }
+            ],
+            hint: `Use: zora price-history creator-coin ${parsed.name}  or  zora price-history trend ${parsed.name}`
+          },
+          render: () => {
+          }
+        });
+      } else {
+        await showPriceHistory(
+          false,
+          ambResult.creator,
+          interval
+        );
+        console.log("");
+        await showPriceHistory(false, ambResult.trend, interval);
+        console.log(
+          `
+\x1B[2mUse \`zora price-history creator-coin ${parsed.name}\` or \`zora price-history trend ${parsed.name}\` for a specific type.\x1B[0m`
+        );
+      }
+      track("cli_price_history", {
+        lookup_type: "name",
+        ambiguous: true,
+        interval,
+        output_format: json ? "json" : "text"
+      });
+      return;
+    }
+    const dataPoints2 = await showPriceHistory(
+      json,
+      ambResult.coin,
+      interval
+    );
+    track("cli_price_history", {
+      lookup_type: "name",
+      coin_type: ambResult.coin.coinType,
+      interval,
+      data_points: dataPoints2,
+      output_format: json ? "json" : "text"
+    });
+    return;
+  }
+  const ref = coinArgsToRef(parsed);
+  let result;
+  try {
+    result = await resolveCoin(ref);
+  } catch (err) {
+    outputErrorAndExit(
+      json,
+      `Request failed: ${err instanceof Error ? err.message : String(err)}`
+    );
+    return;
+  }
+  if (result.kind === "not-found") {
+    outputErrorAndExit(json, result.message, result.suggestion);
+    return;
+  }
+  if (result.coin.platformBlocked) {
+    outputErrorAndExit(json, bannedCoinMessage(result.coin.address));
+    return;
+  }
+  const { coin } = result;
+  const dataPoints = await showPriceHistory(json, coin, interval);
   track("cli_price_history", {
-    lookup_type: identifier.startsWith("0x") ? "address" : "name",
+    lookup_type: typeOrId.startsWith("0x") ? "address" : "name",
     coin_type: coin.coinType,
     interval,
-    data_points: prices.length,
+    data_points: dataPoints,
     output_format: json ? "json" : "text"
   });
 });
@@ -2988,7 +3207,7 @@ import { Command as Command7 } from "commander";
 import confirm3 from "@inquirer/confirm";
 import {
   erc20Abi as erc20Abi3,
-  formatUnits as formatUnits4,
+  formatUnits as formatUnits5,
   isAddress as isAddress2,
   parseUnits as parseUnits2
 } from "viem";
@@ -3005,12 +3224,12 @@ function printSellQuote(output, info) {
       coin: info.coinSymbol,
       address: info.address,
       sell: {
-        amount: formatUnits4(info.amountIn, info.coinDecimals),
+        amount: formatUnits5(info.amountIn, info.coinDecimals),
         raw: info.amountIn.toString(),
         symbol: info.coinSymbol
       },
       estimated: {
-        amount: formatUnits4(BigInt(info.quoteAmountOut), info.outputDecimals),
+        amount: formatUnits5(BigInt(info.quoteAmountOut), info.outputDecimals),
         raw: info.quoteAmountOut,
         symbol: info.outputSymbol
       },
@@ -3019,7 +3238,8 @@ function printSellQuote(output, info) {
     return;
   }
   console.log(`
- Sell ${info.coinName} (${info.coinSymbol})
+ Sell \x1B[1m${info.coinName}\x1B[0m`);
+  console.log(` ${info.coinType} \xB7 ${info.address}
 `);
   console.log(`   Amount       ${info.soldFormatted} ${info.coinSymbol}`);
   console.log(
@@ -3029,7 +3249,7 @@ function printSellQuote(output, info) {
 `);
 }
 function printSellResult(output, info) {
-  const receivedAmount = formatUnits4(
+  const receivedAmount = formatUnits5(
     info.receivedAmountOut,
     info.outputDecimals
   );
@@ -3043,7 +3263,7 @@ function printSellResult(output, info) {
       coin: info.coinSymbol,
       address: info.address,
       sold: {
-        amount: formatUnits4(info.amountIn, info.coinDecimals),
+        amount: formatUnits5(info.amountIn, info.coinDecimals),
         raw: info.amountIn.toString(),
         symbol: info.coinSymbol
       },
@@ -3058,7 +3278,8 @@ function printSellResult(output, info) {
     return;
   }
   console.log(`
- Sold ${info.coinName}
+ Sold \x1B[1m${info.coinName}\x1B[0m`);
+  console.log(` ${info.coinType} \xB7 ${info.address}
 `);
   console.log(`   Sold         ${info.soldFormatted} ${info.coinSymbol}`);
   console.log(
@@ -3070,11 +3291,74 @@ function printSellResult(output, info) {
   console.log(`   Tx           ${info.txHash}
 `);
 }
-var sellCommand = new Command7("sell").description("Sell a coin").argument("[address]", "Coin contract address (0x\u2026)").option("--amount <value>", "Sell specific number of coins").option("--usd <value>", "Sell USD equivalent worth of coins").option("--percent <value>", "Sell percentage of coin balance").option("--all", "Sell entire coin balance").option("--to <asset>", "Receive asset: eth, usdc, zora", "eth").option("--token <asset>", "Receive asset: eth, usdc, zora (alias for --to)").option("--quote", "Print quote and exit without trading").option("--yes", "Skip confirmation and execute directly").option("--slippage <pct>", "Slippage tolerance percent", "1").option("--debug", "Print full quote request/response JSON").action(async function(coinAddress, opts) {
+var sellCommand = new Command7("sell").description("Sell a coin").argument(
+  "[typeOrId]",
+  "Type prefix (creator-coin, trend) or coin address/name"
+).argument("[identifier]", "Coin name (when type prefix is given)").option("--amount <value>", "Sell specific number of coins").option("--usd <value>", "Sell USD equivalent worth of coins").option("--percent <value>", "Sell percentage of coin balance").option("--all", "Sell entire coin balance").option("--to <asset>", "Receive asset: eth, usdc, zora", "eth").option("--token <asset>", "Receive asset: eth, usdc, zora (alias for --to)").option("--quote", "Print quote and exit without trading").option("--yes", "Skip confirmation and execute directly").option("--slippage <pct>", "Slippage tolerance percent", "1").option("--debug", "Print full quote request/response JSON").action(async function(typeOrId, identifier, opts) {
   const json = getJson(this);
   const debug = opts.debug === true;
-  if (!isAddress2(coinAddress)) {
-    outputErrorAndExit(json, `Invalid address: ${coinAddress}`);
+  let parsed;
+  try {
+    parsed = parsePositionalCoinArgs(typeOrId, identifier);
+  } catch (err) {
+    if (err instanceof CoinArgError) {
+      outputErrorAndExit(json, err.message, err.suggestion);
+    }
+    throw err;
+  }
+  const apiKey = getApiKey();
+  if (apiKey) {
+    setApiKey6(apiKey);
+  }
+  let coinAddress;
+  if (parsed.kind === "address") {
+    if (!isAddress2(parsed.address)) {
+      outputErrorAndExit(json, `Invalid address: ${parsed.address}`);
+      return;
+    }
+    coinAddress = parsed.address;
+  } else if (parsed.kind === "ambiguous-name") {
+    let ambResult;
+    try {
+      ambResult = await resolveAmbiguousName(parsed.name);
+    } catch (err) {
+      outputErrorAndExit(
+        json,
+        `Request failed: ${err instanceof Error ? err.message : String(err)}`
+      );
+      return;
+    }
+    if (ambResult.kind === "not-found") {
+      outputErrorAndExit(json, ambResult.message);
+      return;
+    }
+    if (ambResult.kind === "ambiguous") {
+      const { message, suggestion } = formatAmbiguousError(
+        parsed.name,
+        ambResult.creator,
+        ambResult.trend,
+        "sell"
+      );
+      outputErrorAndExit(json, message, suggestion);
+      return;
+    }
+    coinAddress = ambResult.coin.address;
+  } else {
+    const ref = coinArgsToRef(parsed);
+    try {
+      const result = await resolveCoin(ref);
+      if (result.kind === "not-found") {
+        outputErrorAndExit(json, result.message, result.suggestion);
+        return;
+      }
+      coinAddress = result.coin.address;
+    } catch (err) {
+      outputErrorAndExit(
+        json,
+        `Request failed: ${err instanceof Error ? err.message : String(err)}`
+      );
+      return;
+    }
   }
   const output = json ? "json" : "static";
   const outputAsset = opts.token ? opts.token.toLowerCase() : opts.to;
@@ -3099,10 +3383,6 @@ var sellCommand = new Command7("sell").description("Sell a coin").argument("[add
     );
   }
   const slippage = slippagePct / 100;
-  const apiKey = getApiKey();
-  if (apiKey) {
-    setApiKey6(apiKey);
-  }
   const account = resolveAccount(json);
   const { publicClient, walletClient } = createClients(account);
   let token;
@@ -3117,6 +3397,7 @@ var sellCommand = new Command7("sell").description("Sell a coin").argument("[add
   }
   const coinName = token.name;
   const coinSymbol = token.symbol;
+  const coinType = mapCoinType(token.coinType);
   const coinDecimals = Number(token.decimals ?? 18);
   let amountIn;
   if (amountMode === "usd") {
@@ -3143,7 +3424,7 @@ var sellCommand = new Command7("sell").description("Sell a coin").argument("[add
     }
     if (debug) {
       console.error(
-        `[debug] $${usdVal} USD = ${formatUnits4(amountIn, coinDecimals)} ${coinSymbol} (coin price: $${coinPriceUsd})`
+        `[debug] $${usdVal} USD = ${formatUnits5(amountIn, coinDecimals)} ${coinSymbol} (coin price: $${coinPriceUsd})`
       );
     }
   } else if (amountMode === "amount") {
@@ -3198,7 +3479,7 @@ var sellCommand = new Command7("sell").description("Sell a coin").argument("[add
     const coinPriceUsd = await fetchTokenPriceUsd(coinAddress);
     if (coinPriceUsd !== null && coinPriceUsd > 0) {
       swapAmountUsd = Number(
-        (Number(formatUnits4(amountIn, coinDecimals)) * coinPriceUsd).toFixed(
+        (Number(formatUnits5(amountIn, coinDecimals)) * coinPriceUsd).toFixed(
           2
         )
       );
@@ -3264,6 +3545,7 @@ ${err instanceof Error ? err.stack || err.message : String(err)}
     printSellQuote(output, {
       coinName,
       coinSymbol,
+      coinType,
       address: coinAddress,
       soldFormatted,
       amountIn,
@@ -3293,6 +3575,7 @@ ${err instanceof Error ? err.stack || err.message : String(err)}
     printSellQuote("static", {
       coinName,
       coinSymbol,
+      coinType,
       address: coinAddress,
       soldFormatted,
       amountIn,
@@ -3361,6 +3644,7 @@ ${err instanceof Error ? err.stack || err.message : String(err)}
   printSellResult(output, {
     coinName,
     coinSymbol,
+    coinType,
     address: coinAddress,
     amountIn,
     coinDecimals,
@@ -3517,8 +3801,10 @@ var ProfileView = ({
     ] }) });
   }
   if (!data) return null;
-  const hints = ["\u2190 \u2192 switch tab", "r refresh"];
-  if (autoRefresh) hints.push(`auto: ${secondsUntilRefresh}s`);
+  const hints = [
+    "\u2190 \u2192 switch tab",
+    autoRefresh ? `r refresh (${secondsUntilRefresh}s)` : "r refresh"
+  ];
   hints.push("q quit");
   const footer = hints.join("  \xB7  ");
   const rankedPosts = data.posts.map((p, i) => ({ ...p, rank: i + 1 }));
@@ -3789,7 +4075,7 @@ import { Command as Command9 } from "commander";
 import confirm4 from "@inquirer/confirm";
 import {
   erc20Abi as erc20Abi4,
-  formatUnits as formatUnits5,
+  formatUnits as formatUnits6,
   isAddress as isAddress3,
   parseUnits as parseUnits3
 } from "viem";
@@ -3799,7 +4085,7 @@ var SEND_AMOUNT_CHECKS = {
   percent: (opts) => opts.percent !== void 0,
   all: (opts) => opts.all === true
 };
-var VALID_TYPES3 = ["creator-coin", "post", "trend"];
+var KNOWN_TOKEN_NAMES = /* @__PURE__ */ new Set(["eth", "usdc", "zora"]);
 function printSendPreview(info) {
   const usdStr = info.amountUsd != null ? ` ($${info.amountUsd.toFixed(2)})` : "";
   console.log(`
@@ -3820,7 +4106,7 @@ function printSendResult(json, info) {
       coin: info.symbol,
       address: info.address,
       sent: {
-        amount: formatUnits5(info.amount, info.decimals),
+        amount: formatUnits6(info.amount, info.decimals),
         raw: info.amount.toString(),
         symbol: info.symbol,
         amountUsd: info.amountUsd
@@ -3841,7 +4127,10 @@ function printSendResult(json, info) {
   console.log(`   Tx           ${info.txHash}
 `);
 }
-var sendCommand = new Command9("send").description("Send coins or ETH to an address").argument("[identifier]", "Coin address, name, or token (eth, usdc, zora)").option("--to <address>", "Recipient address (0x...)").option("--type <type>", "Coin type: creator-coin, post, trend").option("--amount <value>", "Send specific amount").option("--percent <value>", "Send percentage of balance (1-100)").option("--all", "Send entire balance").option("--yes", "Skip confirmation").action(async function(identifier, opts) {
+var sendCommand = new Command9("send").description("Send coins or ETH to an address").argument(
+  "[typeOrId]",
+  "Token (eth, usdc, zora), type prefix (creator-coin, trend), or coin address/name"
+).argument("[identifier]", "Coin name (when type prefix is given)").option("--to <address>", "Recipient address (0x...)").option("--amount <value>", "Send specific amount").option("--percent <value>", "Send percentage of balance (1-100)").option("--all", "Send entire balance").option("--yes", "Skip confirmation").action(async function(firstArg, secondArg, opts) {
   const json = getJson(this);
   if (!opts.to) {
     outputErrorAndExit(
@@ -3858,24 +4147,15 @@ var sendCommand = new Command9("send").description("Send coins or ETH to an addr
     );
   }
   const recipient = opts.to;
-  if (opts.type !== void 0 && !VALID_TYPES3.includes(opts.type)) {
-    outputErrorAndExit(
-      json,
-      `Invalid --type value: ${opts.type}.`,
-      `Supported: ${VALID_TYPES3.join(", ")}`
-    );
-  }
   const amountMode = getAmountMode(
     json,
     opts,
     SEND_AMOUNT_CHECKS,
     "--amount, --percent, or --all"
   );
-  const isEth = identifier.toLowerCase() === "eth";
+  const isKnownToken = KNOWN_TOKEN_NAMES.has(firstArg.toLowerCase());
+  const isEth = firstArg.toLowerCase() === "eth";
   if (isEth) {
-    if (opts.type) {
-      outputErrorAndExit(json, "--type is not valid when sending ETH.");
-    }
     const account = resolveAccount(json);
     const { publicClient, walletClient } = createClients(account);
     const balance = await publicClient.getBalance({
@@ -3913,14 +4193,14 @@ var sendCommand = new Command9("send").description("Send coins or ETH to an addr
       if (amount + GAS_RESERVE > balance) {
         outputErrorAndExit(
           json,
-          `Insufficient balance. Have ${formatEthDisplay(balance)} ETH (need to reserve ~${formatEthDisplay(GAS_RESERVE)} ETH for gas).`
+          `Insufficient balance. Have ${formatAmountDisplay(balance, 18)} ETH (need to reserve ~${formatAmountDisplay(GAS_RESERVE, 18)} ETH for gas).`
         );
       }
     } else {
       if (balance <= GAS_RESERVE) {
         outputErrorAndExit(
           json,
-          `Balance too low (${formatEthDisplay(balance)} ETH). Need >${formatEthDisplay(GAS_RESERVE)} ETH for gas.`
+          `Balance too low (${formatAmountDisplay(balance, 18)} ETH). Need >${formatAmountDisplay(GAS_RESERVE, 18)} ETH for gas.`
         );
       }
       const spendable = balance - GAS_RESERVE;
@@ -3943,12 +4223,12 @@ var sendCommand = new Command9("send").description("Send coins or ETH to an addr
         }
       }
     }
-    const amountFormatted = formatEthDisplay(amount);
+    const amountFormatted = formatAmountDisplay(amount, 18);
     let amountUsd = null;
     const ethPriceUsd = await fetchTokenPriceUsd(WETH_ADDRESS);
     if (ethPriceUsd != null) {
       amountUsd = Number(
-        (Number(formatUnits5(amount, 18)) * ethPriceUsd).toFixed(2)
+        (Number(formatUnits6(amount, 18)) * ethPriceUsd).toFixed(2)
       );
     }
     if (!opts.yes) {
@@ -4008,14 +4288,8 @@ var sendCommand = new Command9("send").description("Send coins or ETH to an addr
       tx_hash: txHash
     });
   } else {
-    const knownTokenKey = identifier.toLowerCase();
-    const knownToken = knownTokenKey !== "eth" && knownTokenKey in BASE_TRADE_TOKENS ? BASE_TRADE_TOKENS[knownTokenKey] : void 0;
-    if (knownToken && opts.type) {
-      outputErrorAndExit(
-        json,
-        `--type is not valid when sending ${knownToken.symbol}.`
-      );
-    }
+    const knownTokenKey = firstArg.toLowerCase();
+    const knownToken = isKnownToken && knownTokenKey !== "eth" && knownTokenKey in BASE_TRADE_TOKENS ? BASE_TRADE_TOKENS[knownTokenKey] : void 0;
     let tokenAddress;
     let tokenName;
     if (knownToken) {
@@ -4027,21 +4301,60 @@ var sendCommand = new Command9("send").description("Send coins or ETH to an addr
       if (apiKey) {
         setApiKey8(apiKey);
       }
-      const ref = parseCoinRef(identifier, opts.type);
-      let result;
+      let parsed;
       try {
-        result = await resolveCoin(ref);
+        parsed = parsePositionalCoinArgs(firstArg, secondArg);
       } catch (err) {
-        outputErrorAndExit(
-          json,
-          `Request failed: ${err instanceof Error ? err.message : String(err)}`
-        );
+        if (err instanceof CoinArgError) {
+          outputErrorAndExit(json, err.message, err.suggestion);
+        }
+        throw err;
       }
-      if (result.kind === "not-found") {
-        outputErrorAndExit(json, result.message, result.suggestion);
+      if (parsed.kind === "ambiguous-name") {
+        let ambResult;
+        try {
+          ambResult = await resolveAmbiguousName(parsed.name);
+        } catch (err) {
+          outputErrorAndExit(
+            json,
+            `Request failed: ${err instanceof Error ? err.message : String(err)}`
+          );
+          return;
+        }
+        if (ambResult.kind === "not-found") {
+          outputErrorAndExit(json, ambResult.message);
+          return;
+        }
+        if (ambResult.kind === "ambiguous") {
+          const { message, suggestion } = formatAmbiguousError(
+            parsed.name,
+            ambResult.creator,
+            ambResult.trend,
+            "send"
+          );
+          outputErrorAndExit(json, message, suggestion);
+          return;
+        }
+        tokenAddress = ambResult.coin.address;
+        tokenName = ambResult.coin.name;
+      } else {
+        const ref = coinArgsToRef(parsed);
+        try {
+          const result = await resolveCoin(ref);
+          if (result.kind === "not-found") {
+            outputErrorAndExit(json, result.message, result.suggestion);
+            return;
+          }
+          tokenAddress = result.coin.address;
+          tokenName = result.coin.name;
+        } catch (err) {
+          outputErrorAndExit(
+            json,
+            `Request failed: ${err instanceof Error ? err.message : String(err)}`
+          );
+          return;
+        }
       }
-      tokenAddress = result.coin.address;
-      tokenName = result.coin.name;
     }
     const account = resolveAccount(json);
     const { publicClient, walletClient } = createClients(account);
@@ -4139,7 +4452,7 @@ var sendCommand = new Command9("send").description("Send coins or ETH to an addr
     const priceUsd = knownToken?.fixedPriceUsd ?? await fetchTokenPriceUsd(priceAddress);
     if (priceUsd != null) {
       amountUsd = Number(
-        (Number(formatUnits5(amount, decimals)) * priceUsd).toFixed(2)
+        (Number(formatUnits6(amount, decimals)) * priceUsd).toFixed(2)
       );
     }
     if (!opts.yes) {
@@ -4461,8 +4774,103 @@ walletCommand.command("export").description("Print the raw private key to stdout
   });
 });
 
-// src/components/Zorb.tsx
+// src/components/StyledHelp.tsx
+import { Text as Text10, Box as Box10 } from "ink";
+
+// src/components/KeyValueTable.tsx
 import { Text as Text9, Box as Box9 } from "ink";
+import { jsx as jsx12, jsxs as jsxs9 } from "react/jsx-runtime";
+function KeyValueTable({
+  rows,
+  labelWidth
+}) {
+  const pad = labelWidth ?? Math.max(0, ...rows.map((r) => r.label.length)) + 2;
+  return /* @__PURE__ */ jsx12(Box9, { flexDirection: "column", children: rows.map((row, i) => /* @__PURE__ */ jsxs9(Text9, { children: [
+    /* @__PURE__ */ jsx12(Text9, { bold: true, children: row.label.padEnd(pad) }),
+    /* @__PURE__ */ jsx12(Text9, { dimColor: true, children: row.value })
+  ] }, i)) });
+}
+
+// src/lib/parse-help.ts
+var DEFAULT_DESC_COLUMN = 38;
+var TWO_COLUMN_REGEX = /^(.+\S)([ \t]{2,})(\S.*)/m;
+function getDescriptionColumnOffset(sections) {
+  for (const section of sections) {
+    const match = section.content.match(TWO_COLUMN_REGEX);
+    if (match) {
+      return match[1].length + match[2].length;
+    }
+  }
+  return DEFAULT_DESC_COLUMN;
+}
+function parseHelpSections(text) {
+  const sections = [];
+  let currentTitle = "";
+  let currentLines = [];
+  for (const line of text.split("\n")) {
+    const match = line.match(/^([A-Z]\w+):(.*)/);
+    if (match) {
+      if (currentTitle) {
+        const content = currentLines.join("\n").replace(/^\n+|\n+$/g, "");
+        sections.push({ title: currentTitle, content });
+      }
+      currentTitle = match[1];
+      currentLines = match[2].trim() ? [match[2].trim()] : [];
+    } else if (currentTitle) {
+      currentLines.push(line.startsWith("  ") ? line.slice(2) : line);
+    }
+  }
+  if (currentTitle) {
+    const content = currentLines.join("\n").replace(/^\n+|\n+$/g, "");
+    sections.push({ title: currentTitle, content });
+  }
+  return sections.filter((s) => s.content);
+}
+
+// src/components/StyledHelp.tsx
+import { jsx as jsx13, jsxs as jsxs10 } from "react/jsx-runtime";
+function StyledHelp({
+  sections,
+  header
+}) {
+  const descriptionColumnOffset = getDescriptionColumnOffset(sections);
+  return /* @__PURE__ */ jsxs10(Box10, { flexDirection: "column", gap: 1, children: [
+    header,
+    sections.map((section, i) => {
+      const hasTwoColumns = TWO_COLUMN_REGEX.test(section.content);
+      const rows = hasTwoColumns ? section.content.split("\n").map((line) => {
+        const m = line.match(TWO_COLUMN_REGEX);
+        if (m)
+          return {
+            label: m[1],
+            value: m[3][0].toUpperCase() + m[3].slice(1)
+          };
+        return { label: "", value: line.trimStart() };
+      }) : null;
+      return /* @__PURE__ */ jsxs10(
+        Box10,
+        {
+          flexDirection: "column",
+          borderStyle: "single",
+          borderDimColor: true,
+          paddingX: 1,
+          paddingY: 1,
+          children: [
+            /* @__PURE__ */ jsx13(Text10, { bold: true, children: section.title }),
+            rows ? /* @__PURE__ */ jsx13(KeyValueTable, { rows, labelWidth: descriptionColumnOffset }) : /* @__PURE__ */ jsx13(Text10, { children: section.content })
+          ]
+        },
+        i
+      );
+    })
+  ] });
+}
+
+// src/components/StyledHelpHeader.tsx
+import { Text as Text12, Box as Box12 } from "ink";
+
+// src/components/Zorb.tsx
+import { Text as Text11, Box as Box11 } from "ink";
 
 // src/lib/zorb-pixels.ts
 function supportsTruecolor() {
@@ -4607,7 +5015,7 @@ function generateZorbPixels(size) {
 }
 
 // src/components/Zorb.tsx
-import { jsx as jsx12, jsxs as jsxs9 } from "react/jsx-runtime";
+import { jsx as jsx14, jsxs as jsxs11 } from "react/jsx-runtime";
 var LOWER_HALF_BLOCK = "\u2584";
 var UPPER_HALF_BLOCK = "\u2580";
 function rgbString([r, g, b]) {
@@ -4630,19 +5038,19 @@ function Zorb({ size = 20 }) {
       const topIsBlack = isBlack(top);
       const bottomIsBlack = isBlack(bottom);
       if (topIsBlack && bottomIsBlack) {
-        cells.push(/* @__PURE__ */ jsx12(Text9, { children: " " }, x));
+        cells.push(/* @__PURE__ */ jsx14(Text11, { children: " " }, x));
       } else if (topIsBlack) {
         cells.push(
-          /* @__PURE__ */ jsx12(Text9, { color: rgbString(bottom), children: LOWER_HALF_BLOCK }, x)
+          /* @__PURE__ */ jsx14(Text11, { color: rgbString(bottom), children: LOWER_HALF_BLOCK }, x)
         );
       } else if (bottomIsBlack) {
         cells.push(
-          /* @__PURE__ */ jsx12(Text9, { color: rgbString(top), children: UPPER_HALF_BLOCK }, x)
+          /* @__PURE__ */ jsx14(Text11, { color: rgbString(top), children: UPPER_HALF_BLOCK }, x)
         );
       } else {
         cells.push(
-          /* @__PURE__ */ jsx12(
-            Text9,
+          /* @__PURE__ */ jsx14(
+            Text11,
             {
               backgroundColor: rgbString(top),
               color: rgbString(bottom),
@@ -4653,25 +5061,66 @@ function Zorb({ size = 20 }) {
         );
       }
     }
-    rows.push(/* @__PURE__ */ jsx12(Text9, { children: cells }, y));
+    rows.push(/* @__PURE__ */ jsx14(Text11, { children: cells }, y));
   }
-  return /* @__PURE__ */ jsxs9(Box9, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsx12(Text9, { children: " " }),
+  return /* @__PURE__ */ jsxs11(Box11, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsx14(Text11, { children: " " }),
     rows,
-    /* @__PURE__ */ jsx12(Text9, { children: " " })
+    /* @__PURE__ */ jsx14(Text11, { children: " " })
   ] });
 }
 
+// src/components/StyledHelpHeader.tsx
+import { jsx as jsx15, jsxs as jsxs12 } from "react/jsx-runtime";
+function StyledHelpHeader({
+  sections
+}) {
+  const descriptionColumnOffset = getDescriptionColumnOffset(sections);
+  return /* @__PURE__ */ jsxs12(
+    Box12,
+    {
+      flexDirection: "row",
+      borderStyle: "single",
+      borderDimColor: true,
+      paddingX: 1,
+      paddingY: 1,
+      children: [
+        /* @__PURE__ */ jsx15(Box12, { flexShrink: 0, width: descriptionColumnOffset, children: /* @__PURE__ */ jsx15(Zorb, { size: 20 }) }),
+        /* @__PURE__ */ jsx15(Box12, { flexDirection: "column", flexGrow: 1, justifyContent: "center", children: /* @__PURE__ */ jsx15(Text12, { bold: true, children: "Zora CLI" }) })
+      ]
+    }
+  );
+}
+
 // src/index.tsx
-import { jsx as jsx13 } from "react/jsx-runtime";
+import { jsx as jsx16 } from "react/jsx-runtime";
 if (process.env.ZORA_API_TARGET) {
   setApiBaseUrl(process.env.ZORA_API_TARGET);
 }
-var version = true ? "0.3.0" : JSON.parse(
+var version = true ? "0.3.1" : JSON.parse(
   readFileSync2(new URL("../package.json", import.meta.url), "utf-8")
 ).version;
+function styledHelpWriteOut(showHeader) {
+  return (str) => {
+    if (supportsTruecolor()) {
+      const sections = parseHelpSections(str);
+      if (sections.length > 0) {
+        const header = showHeader ? /* @__PURE__ */ jsx16(StyledHelpHeader, { sections }) : void 0;
+        renderOnce(/* @__PURE__ */ jsx16(StyledHelp, { sections, header }));
+        return;
+      }
+    }
+    process.stdout.write(str);
+  };
+}
 var buildProgram = () => {
-  const program2 = new Command12().name("zora").description("Zora CLI").version(version).option("--json", "Output as JSON (for scripts and automation)", false);
+  const program2 = new Command12().name("zora").description("A developer CLI for the Zora platform").version(version).option("--json", "Output as JSON (for scripts and automation)", false);
+  const helpWidth = (process.stdout.columns || 80) - 4;
+  program2.configureHelp({ helpWidth });
+  program2.configureOutput({ writeOut: styledHelpWriteOut(true) });
+  program2.action(() => {
+    program2.outputHelp();
+  });
   program2.addCommand(authCommand);
   program2.addCommand(balanceCommand);
   program2.addCommand(buyCommand);
@@ -4683,9 +5132,17 @@ var buildProgram = () => {
   program2.addCommand(walletCommand);
   program2.addCommand(sellCommand);
   program2.addCommand(sendCommand);
+  const applyToSubcommands = (parent) => {
+    for (const cmd of parent.commands) {
+      cmd.configureHelp({ helpWidth });
+      cmd.configureOutput({ writeOut: styledHelpWriteOut(false) });
+      applyToSubcommands(cmd);
+    }
+  };
+  applyToSubcommands(program2);
   program2.hook("preAction", (_thisCommand, actionCommand) => {
     const expected = actionCommand.registeredArguments.length;
-    if (expected > 0 && actionCommand.args.length < expected) {
+    if (expected > 0 && actionCommand.args.length === 0) {
       actionCommand.outputHelp();
       process.exit(1);
     }
@@ -4694,10 +5151,6 @@ var buildProgram = () => {
 };
 var program = buildProgram();
 if (!process.env.VITEST) {
-  const showingHelp = process.argv.length <= 2 || process.argv.includes("--help") || process.argv.includes("-h");
-  if (showingHelp && !process.argv.includes("--json") && supportsTruecolor()) {
-    renderOnce(/* @__PURE__ */ jsx13(Zorb, { size: 20 }));
-  }
   console.warn(
     "\x1B[33m\u26A0 Beta:\x1B[0m This CLI is in beta and should be used with caution."
   );