@outlit/cli 0.1.0 → 1.0.1

package/dist/cli.js

@@ -104,7 +104,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@outlit/cli",
-    version: "0.1.0",
+    version: "1.0.1",
     description: "CLI for Outlit customer intelligence platform",
     license: "Apache-2.0",
     repository: {
@@ -117,7 +117,9 @@ var init_package = __esm(() => {
       access: "public"
     },
     type: "module",
-    bin: { outlit: "./dist/cli.js" },
+    bin: {
+      outlit: "./dist/cli.js"
+    },
     files: ["dist"],
     scripts: {
       dev: "bun run src/cli.ts",
@@ -155,6 +157,10 @@ function isInteractive() {
     return false;
   return true;
 }
+var isUnicodeSupported;
+var init_tty = __esm(() => {
+  isUnicodeSupported = process.platform !== "win32" || Boolean(process.env.WT_SESSION) || process.env.TERM_PROGRAM === "vscode";
+});
 
 // src/lib/output.ts
 function isJsonMode(json) {
@@ -179,7 +185,9 @@ function outputError(error, json) {
 function errorMessage(err, fallback) {
   return err instanceof Error ? err.message : fallback;
 }
-var init_output = () => {};
+var init_output = __esm(() => {
+  init_tty();
+});
 
 // ../../node_modules/.bun/citty@0.2.1/node_modules/citty/dist/index.mjs
 function defineCommand2(def) {
@@ -1303,6 +1311,7 @@ var init_signup = __esm(() => {
   init_dist();
   init_output2();
   init_output();
+  init_tty();
   signup_default = defineCommand2({
     meta: {
       name: "signup",
@@ -1324,7 +1333,7 @@ var init_signup = __esm(() => {
         return outputResult({ url: OUTLIT_SIGNUP_URL });
       }
       if (isInteractive()) {
-        We("Outlit CLI — Sign Up");
+        We("Outlit CLI -- Sign Up");
       }
       try {
         if (process.platform === "win32") {
@@ -1435,11 +1444,13 @@ function storeApiKey(apiKey) {
   writeFileSync(credPath, JSON.stringify({ apiKey }, null, 2), { mode: 384 });
   return credPath;
 }
-var CLI_VERSION2, DEFAULT_MCP_URL = "https://mcp.outlit.ai/mcp", DEFAULT_API_URL = "https://app.outlit.ai", OUTLIT_DASHBOARD_URL = "https://app.outlit.ai/workspace-profile", TICK = "\x1B[32m✓\x1B[0m";
+var CLI_VERSION2, DEFAULT_MCP_URL = "https://mcp.outlit.ai/mcp", DEFAULT_API_URL = "https://app.outlit.ai", OUTLIT_DASHBOARD_URL = "https://app.outlit.ai/workspace-profile", TICK2;
 var init_config = __esm(() => {
   init_package();
   init_output();
+  init_tty();
   CLI_VERSION2 = package_default.version;
+  TICK2 = `\x1B[32m${isUnicodeSupported ? String.fromCodePoint(10003) : String.fromCodePoint(8730)}\x1B[0m`;
 });
 
 // src/lib/client.ts
@@ -1521,30 +1532,62 @@ function createSpinner(message) {
   }
   let frameIndex = 0;
   let text = message;
+  let stopped = false;
+  process.stderr.write(HIDE_CURSOR);
+  const removeSignalHandlers = () => {
+    process.off("SIGINT", onSigint);
+    process.off("SIGTERM", onSigterm);
+  };
+  const cleanup = () => {
+    if (stopped)
+      return;
+    stopped = true;
+    clearInterval(timer);
+    removeSignalHandlers();
+    process.stderr.write(SHOW_CURSOR);
+  };
+  const onSigint = () => {
+    cleanup();
+    process.exit(130);
+  };
+  const onSigterm = () => {
+    cleanup();
+    process.exit(143);
+  };
+  process.on("SIGINT", onSigint);
+  process.on("SIGTERM", onSigterm);
   const timer = setInterval(() => {
     const frame = FRAMES[frameIndex % FRAMES.length];
     process.stderr.write(`\r\x1B[2K  ${frame} ${text}`);
     frameIndex++;
   }, INTERVAL_MS);
+  const finish = (symbol, color, msg) => {
+    if (stopped)
+      return;
+    cleanup();
+    process.stderr.write(`\r\x1B[2K  ${color}${symbol}\x1B[0m ${msg}
+`);
+  };
   return {
     update(msg) {
       text = msg;
     },
     stop(msg) {
-      clearInterval(timer);
-      process.stderr.write(`\r\x1B[2K  \x1B[32m✔\x1B[0m ${msg}
-`);
+      finish(SUCCESS_SYMBOL, "\x1B[32m", msg);
     },
     fail(msg) {
-      clearInterval(timer);
-      process.stderr.write(`\r\x1B[2K  \x1B[31m✗\x1B[0m ${msg}
-`);
+      finish(FAIL_SYMBOL, "\x1B[31m", msg);
     }
   };
 }
-var FRAMES, INTERVAL_MS = 80;
+var UNICODE_FRAMES, ASCII_FRAMES, FRAMES, INTERVAL_MS = 80, SUCCESS_SYMBOL, FAIL_SYMBOL, HIDE_CURSOR = "\x1B[?25l", SHOW_CURSOR = "\x1B[?25h";
 var init_spinner = __esm(() => {
-  FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+  init_tty();
+  UNICODE_FRAMES = [10251, 10265, 10297, 10296, 10300, 10292, 10278, 10279, 10247, 10255].map((cp) => String.fromCodePoint(cp));
+  ASCII_FRAMES = ["-", "\\", "|", "/"];
+  FRAMES = isUnicodeSupported ? UNICODE_FRAMES : ASCII_FRAMES;
+  SUCCESS_SYMBOL = isUnicodeSupported ? String.fromCodePoint(10003) : String.fromCodePoint(8730);
+  FAIL_SYMBOL = isUnicodeSupported ? String.fromCodePoint(10007) : "x";
 });
 
 // src/lib/table.ts
@@ -1552,14 +1595,14 @@ function renderTable(headers, rows, emptyMessage = "(no results)") {
   if (rows.length === 0)
     return emptyMessage;
   const widths = headers.map((h, i) => Math.max(h.length, ...rows.map((r) => (r[i] ?? "").length)));
-  const border = (left, mid, right) => `${left}${widths.map((w) => "─".repeat(w + 2)).join(mid)}${right}`;
-  const formatRow = (cells) => `│${cells.map((c, i) => ` ${(c ?? "").padEnd(widths[i] ?? 0)} `).join("│")}│`;
+  const border = (left, mid, right) => `${left}${widths.map((w) => BOX.h.repeat(w + 2)).join(mid)}${right}`;
+  const formatRow = (cells) => `${BOX.v}${cells.map((c, i) => ` ${(c ?? "").padEnd(widths[i] ?? 0)} `).join(BOX.v)}${BOX.v}`;
   return [
-    border("┌", "┬", "┐"),
+    border(BOX.tl, BOX.tt, BOX.tr),
     formatRow(headers),
-    border("├", "┼", "┤"),
+    border(BOX.lt, BOX.cr, BOX.rt),
     ...rows.map(formatRow),
-    border("└", "┴", "┘")
+    border(BOX.bl, BOX.bt, BOX.br)
   ].join(`
 `);
 }
@@ -1571,6 +1614,35 @@ function renderPaginationHint(pagination, itemCount) {
   }
   return `Showing all ${pagination.total} results.`;
 }
+var BOX;
+var init_table = __esm(() => {
+  init_tty();
+  BOX = isUnicodeSupported ? {
+    h: String.fromCodePoint(9472),
+    v: String.fromCodePoint(9474),
+    tl: String.fromCodePoint(9484),
+    tr: String.fromCodePoint(9488),
+    bl: String.fromCodePoint(9492),
+    br: String.fromCodePoint(9496),
+    lt: String.fromCodePoint(9500),
+    rt: String.fromCodePoint(9508),
+    tt: String.fromCodePoint(9516),
+    bt: String.fromCodePoint(9524),
+    cr: String.fromCodePoint(9532)
+  } : {
+    h: "-",
+    v: "|",
+    tl: "+",
+    tr: "+",
+    bl: "+",
+    br: "+",
+    lt: "+",
+    rt: "+",
+    tt: "+",
+    bt: "+",
+    cr: "+"
+  };
+});
 
 // src/lib/api.ts
 async function getClientOrExit(flagApiKey, json) {
@@ -1632,6 +1704,7 @@ var init_api = __esm(() => {
   init_client();
   init_output();
   init_spinner();
+  init_table();
 });
 
 // src/commands/auth/login.ts
@@ -1648,6 +1721,7 @@ var init_login = __esm(() => {
   init_api();
   init_config();
   init_output();
+  init_tty();
   login_default = defineCommand2({
     meta: {
       name: "login",
@@ -1680,7 +1754,7 @@ Format: ok_ followed by 32+ alphanumeric characters.`
         if (!isInteractive()) {
           return outputError({ message: "--key <apiKey> is required in non-interactive mode", code: "missing_key" }, json);
         }
-        We("Outlit CLI — Login");
+        We("Outlit CLI -- Login");
         const existing = resolveApiKey();
         if (existing) {
           R2.info(`A key from ${existing.source} is already active. Enter a new key to replace it.`);
@@ -1779,7 +1853,7 @@ var init_logout = __esm(() => {
         "Remove the stored Outlit API key.",
         "",
         "Deletes ~/.config/outlit/credentials.json.",
-        "Idempotent — safe to run even if not logged in.",
+        "Idempotent -- safe to run even if not logged in.",
         "",
         "Note: If OUTLIT_API_KEY env var is set, it continues to work after logout."
       ].join(`
@@ -1806,7 +1880,7 @@ var init_logout = __esm(() => {
       if (isJsonMode(json)) {
         return outputResult({ success: true });
       }
-      process.stdout.write(`${TICK} Logged out. Credentials removed from ${credPath}
+      process.stdout.write(`${TICK2} Logged out. Credentials removed from ${credPath}
 `);
     }
   });
@@ -1865,7 +1939,7 @@ var init_status = __esm(() => {
       if (isJsonMode(json)) {
         return outputResult({ authenticated: true, source: credential.source, key: masked });
       }
-      console.log(`${TICK} Authenticated
+      console.log(`${TICK2} Authenticated
   Key:    ${masked}
   Source: ${credential.source}`);
     }
@@ -1892,7 +1966,7 @@ var init_whoami = __esm(() => {
         "Print the active API key (masked) and its source.",
         "",
         "Validates the key against the Outlit API.",
-        "Designed for shell scripting — outputs a single line in TTY mode.",
+        "Designed for shell scripting -- outputs a single line in TTY mode.",
         "",
         "Examples:",
         "  outlit auth whoami",
@@ -1933,11 +2007,11 @@ var init_auth2 = __esm(() => {
         "Manage Outlit CLI authentication.",
         "",
         "Subcommands:",
-        "  signup  — create an Outlit account",
-        "  login   — store API key",
-        "  logout  — remove stored key",
-        "  status  — check current auth state",
-        "  whoami  — print masked key for scripting"
+        "  signup  -- create an Outlit account",
+        "  login   -- store API key",
+        "  logout  -- remove stored key",
+        "  status  -- check current auth state",
+        "  whoami  -- print masked key for scripting"
       ].join(`
 `)
     },
@@ -2012,7 +2086,7 @@ var init_pagination = __esm(() => {
   paginationArgs = {
     limit: {
       type: "string",
-      description: "Max results to return (1–100). Default: 20.",
+      description: "Max results to return (1-100). Default: 20.",
       default: "20"
     },
     cursor: {
@@ -2059,7 +2133,9 @@ function truncate(value, maxLen) {
   const str = String(value);
   if (str.length <= maxLen)
     return str;
-  return `${str.slice(0, maxLen - 1)}…`;
+  if (maxLen <= 3)
+    return "...".slice(0, maxLen);
+  return `${str.slice(0, maxLen - 3)}...`;
 }
 
 // src/commands/customers/list.ts
@@ -2354,9 +2430,9 @@ var init_customers = __esm(() => {
         "Query and filter your customer base.",
         "",
         "Subcommands:",
-        "  list      — list customers with filters",
-        "  get       — get a specific customer by ID or domain",
-        "  timeline  — show activity timeline for a customer",
+        "  list      -- list customers with filters",
+        "  get       -- get a specific customer by ID or domain",
+        "  timeline  -- show activity timeline for a customer",
         "",
         AGENT_JSON_HINT
       ].join(`
@@ -2465,7 +2541,7 @@ var init_users = __esm(() => {
         "Query and filter users across your customer base.",
         "",
         "Subcommands:",
-        "  list  — list users with filters",
+        "  list  -- list users with filters",
         "",
         AGENT_JSON_HINT
       ].join(`
@@ -2490,7 +2566,7 @@ function runMcpCliSetup(key, json, opts, exitOnError = true) {
       DEFAULT_MCP_URL,
       "--header",
       `Authorization: Bearer ${key}`
-    ], { stdio: !isJsonMode(json) ? "inherit" : "ignore" });
+    ], { stdio: "pipe" });
   } catch (err) {
     if (exitOnError) {
       if (isEnoentError(err)) {
@@ -2506,7 +2582,7 @@ function runMcpCliSetup(key, json, opts, exitOnError = true) {
       outputResult({ success: true, agent: opts.agentId });
       return { success: true };
     }
-    console.log(`${TICK} ${opts.successMessage}`);
+    console.log(`${TICK2} ${opts.successMessage}`);
   }
   return { success: true };
 }
@@ -2528,7 +2604,7 @@ function runMcpFileSetup(key, json, opts, exitOnError = true) {
       outputResult({ success: true, path: opts.configPath, agent: opts.agentId });
       return { success: true };
     }
-    console.log(`${TICK} ${opts.successMessage}`);
+    console.log(`${TICK2} ${opts.successMessage}`);
   }
   return { success: true };
 }
@@ -2819,7 +2895,7 @@ var init_openclaw = __esm(() => {
       if (isJsonMode(json)) {
         return outputResult({ success: true, path: skillPath, agent: "openclaw" });
       }
-      console.log(`${TICK} Outlit skill written to ${skillPath}. OpenClaw will load it automatically.`);
+      console.log(`${TICK2} Outlit skill written to ${skillPath}. OpenClaw will load it automatically.`);
     }
   });
 });
@@ -2963,7 +3039,7 @@ var init_setup2 = __esm(() => {
         console.log("Detected agents:");
         for (const agentId of detected) {
           const { label, hint } = agentLabels[agentId];
-          console.log(`  ${TICK} ${label.padEnd(14)} — ${hint}`);
+          console.log(`  ${TICK2} ${label.padEnd(14)} -- ${hint}`);
         }
         console.log(`
 Configuring...`);
@@ -3039,7 +3115,7 @@ function checkApiKeyPresence(credential) {
     return {
       name: "API key",
       status: "fail",
-      message: `Invalid format — expected ok_ prefix, got "${credential.key.slice(0, 3)}..."`,
+      message: `Invalid format -- expected ok_ prefix, got "${credential.key.slice(0, 3)}..."`,
       detail: `Get a valid key at ${OUTLIT_DASHBOARD_URL}`
     };
   }
@@ -3148,7 +3224,7 @@ function printChecks(checks) {
   }
   console.log("");
 }
-var STATUS_ICONS, doctor_default, agentChecks;
+var FAIL_SYMBOL2, STATUS_ICONS, doctor_default, agentChecks;
 var init_doctor = __esm(() => {
   init_dist();
   init_auth();
@@ -3157,10 +3233,12 @@ var init_doctor = __esm(() => {
   init_config();
   init_output();
   init_setup2();
+  init_tty();
+  FAIL_SYMBOL2 = isUnicodeSupported ? String.fromCodePoint(10007) : "x";
   STATUS_ICONS = {
-    pass: TICK,
+    pass: TICK2,
     warn: "\x1B[33m!\x1B[0m",
-    fail: "\x1B[31m✗\x1B[0m"
+    fail: `\x1B[31m${FAIL_SYMBOL2}\x1B[0m`
   };
   doctor_default = defineCommand2({
     meta: {
@@ -3169,10 +3247,10 @@ var init_doctor = __esm(() => {
         "Check CLI version, API key, connectivity, and agent detection.",
         "",
         "Runs four checks in sequence:",
-        "  1. CLI version — compares against npm registry",
-        "  2. API key — checks presence and format (ok_ prefix)",
-        "  3. API validation — makes a live test call to verify the key works",
-        "  4. Agent detection — detects OpenClaw, Cursor, Claude Desktop, VS Code",
+        "  1. CLI version -- compares against npm registry",
+        "  2. API key -- checks presence and format (ok_ prefix)",
+        "  3. API validation -- makes a live test call to verify the key works",
+        "  4. Agent detection -- detects OpenClaw, Cursor, Claude Desktop, VS Code",
         "",
         "Exit code: 0 if all checks pass or warn, 1 if any check fails.",
         "",
@@ -3198,7 +3276,7 @@ var init_doctor = __esm(() => {
       if (credential) {
         checks.push(await validateApiKey(credential.key));
       } else {
-        checks.push({ name: "API validation", status: "fail", message: "Skipped — no API key found" });
+        checks.push({ name: "API validation", status: "fail", message: "Skipped -- no API key found" });
       }
       checks.push(...detectAgents2());
       const hasFail = checks.some((c) => c.status === "fail");
@@ -3500,47 +3578,334 @@ var exports_completions = {};
 __export(exports_completions, {
   default: () => completions_default
 });
-var COMMANDS, cmdNames, BASH_SCRIPT, zshCommands, ZSH_SCRIPT, FISH_SCRIPT, SCRIPTS, completions_default;
-var init_completions = __esm(() => {
-  init_dist();
-  init_output2();
-  init_output();
-  COMMANDS = [
-    { name: "auth", desc: "Manage authentication" },
-    { name: "customers", desc: "Customer operations" },
-    { name: "users", desc: "User operations" },
-    { name: "facts", desc: "Get customer facts" },
-    { name: "search", desc: "Search customer context" },
-    { name: "sql", desc: "Execute SQL queries" },
-    { name: "schema", desc: "Discover table schemas" },
-    { name: "setup", desc: "Configure AI agent tools" },
-    { name: "doctor", desc: "Diagnose environment" },
-    { name: "completions", desc: "Generate shell completions" }
-  ];
-  cmdNames = COMMANDS.map((c) => c.name).join(" ");
-  BASH_SCRIPT = `_outlit_completions() {
+function escZsh(s) {
+  return s.replace(/'/g, "'\\''");
+}
+function flagNames(flags) {
+  return flags.map((f) => f.name).join(" ");
+}
+function generateBash() {
+  const cmdNames = COMMANDS.map((c) => c.name).join(" ");
+  const subCases = cmdsWithSubs.map((c) => {
+    const names = c.subs.map((s) => s.name).join(" ");
+    const parentFlags = c.flags?.length ? ` ${flagNames(c.flags)}` : "";
+    return `      ${c.name}) COMPREPLY=($(compgen -W "${names}${parentFlags}" -- "$cur")) ;;`;
+  }).join(`
+`);
+  const flagEntries = [];
+  for (const cmd of leafCmds) {
+    flagEntries.push(`      ${cmd.name}) COMPREPLY=($(compgen -W "${flagNames(cmd.flags)}" -- "$cur")) ;;`);
+  }
+  for (const cmd of cmdsWithSubs) {
+    for (const sub of cmd.subs) {
+      if (sub.flags?.length) {
+        flagEntries.push(`      ${cmd.name}.${sub.name}) COMPREPLY=($(compgen -W "${flagNames(sub.flags)}" -- "$cur")) ;;`);
+      }
+    }
+  }
+  const flagCases = flagEntries.join(`
+`);
+  return `_outlit_completions() {
   local cur="\${COMP_WORDS[COMP_CWORD]}"
-  COMPREPLY=($(compgen -W "${cmdNames}" -- "$cur"))
+  local cmd="\${COMP_WORDS[1]}"
+  local key
+
+  if [[ $COMP_CWORD -eq 1 ]]; then
+    COMPREPLY=($(compgen -W "${cmdNames}" -- "$cur"))
+    return
+  fi
+
+  case $cmd in
+    ${cmdsWithSubs.map((c) => c.name).join("|")})
+      if [[ $COMP_CWORD -eq 2 ]]; then
+        case $cmd in
+${subCases}
+        esac
+        return
+      fi
+      key="\${cmd}.\${COMP_WORDS[2]}"
+      ;;
+    *)
+      key=$cmd
+      ;;
+  esac
+
+  case $key in
+${flagCases}
+  esac
 }
 complete -F _outlit_completions outlit
 `;
-  zshCommands = COMMANDS.map((c) => `'${c.name}:${c.desc.replace(/:/g, "")}'`).join(" ");
-  ZSH_SCRIPT = `#compdef outlit
+}
+function zshDescribe(items) {
+  return items.map((c) => `'${escZsh(c.name)}:${escZsh(c.desc)}'`).join(" ");
+}
+function generateZsh() {
+  const topLevel = zshDescribe(COMMANDS);
+  const subCases = cmdsWithSubs.map((c) => {
+    const items = [...c.subs.map((s) => ({ name: s.name, desc: s.desc })), ...(c.flags ?? []).map((f) => ({ name: f.name, desc: f.desc }))];
+    return `    ${c.name})
+      completions=(${zshDescribe(items)})
+      _describe 'subcommand' completions
+      ;;`;
+  }).join(`
+`);
+  const flagEntries = [];
+  for (const cmd of leafCmds) {
+    flagEntries.push(`    ${cmd.name})
+      completions=(${zshDescribe(cmd.flags)})
+      _describe 'option' completions
+      ;;`);
+  }
+  for (const cmd of cmdsWithSubs) {
+    for (const sub of cmd.subs) {
+      if (sub.flags?.length) {
+        flagEntries.push(`    ${cmd.name}.${sub.name})
+      completions=(${zshDescribe(sub.flags)})
+      _describe 'option' completions
+      ;;`);
+      }
+    }
+  }
+  const flagCases = flagEntries.join(`
+`);
+  return `#compdef outlit
 _outlit() {
-  local -a commands
-  commands=(${zshCommands})
-  _describe 'command' commands
+  local -a completions
+  local cmd=$words[2]
+  local key
+
+  if (( CURRENT == 2 )); then
+    completions=(${topLevel})
+    _describe 'command' completions
+    return
+  fi
+
+  case $cmd in
+    ${cmdsWithSubs.map((c) => c.name).join("|")})
+      if (( CURRENT == 3 )); then
+        case $cmd in
+${subCases}
+        esac
+        return
+      fi
+      key="\${cmd}.$words[3]"
+      ;;
+    *)
+      key=$cmd
+      ;;
+  esac
+
+  case $key in
+${flagCases}
+  esac
 }
 compdef _outlit outlit
 `;
-  FISH_SCRIPT = `# outlit completions for fish shell
-${COMMANDS.map((c) => `complete -c outlit -f -a ${c.name} -d "${c.desc.replace(/"/g, "\\\"")}"`).join(`
-`)}
+}
+function esc(s) {
+  return s.replace(/"/g, "\\\"");
+}
+function generateFish() {
+  const lines = [
+    "# outlit completions for fish shell",
+    "",
+    "# Helper: true when commandline starts with the given subcommand path",
+    "function __outlit_using_cmd",
+    "  set -l tokens (commandline -opc)",
+    "  set -l n (count $argv)",
+    "  if test (count $tokens) -le $n",
+    "    return 1",
+    "  end",
+    "  for i in (seq $n)",
+    '    if test "$tokens[(math $i + 1)]" != "$argv[$i]"',
+    "      return 1",
+    "    end",
+    "  end",
+    "  return 0",
+    "end",
+    "",
+    "# Top-level commands"
+  ];
+  for (const c of COMMANDS) {
+    lines.push(`complete -c outlit -f -n '__fish_use_subcommand' -a ${c.name} -d "${esc(c.desc)}"`);
+  }
+  for (const cmd of cmdsWithSubs) {
+    lines.push("");
+    lines.push(`# ${cmd.name} subcommands`);
+    for (const sub of cmd.subs) {
+      lines.push(`complete -c outlit -f -n '__outlit_using_cmd ${cmd.name}' -a ${sub.name} -d "${esc(sub.desc)}"`);
+    }
+  }
+  for (const cmd of leafCmds) {
+    lines.push("");
+    lines.push(`# ${cmd.name} flags`);
+    for (const f of cmd.flags) {
+      const long = f.name.replace(/^--/, "");
+      lines.push(`complete -c outlit -n '__outlit_using_cmd ${cmd.name}' -l ${long} -d "${esc(f.desc)}"`);
+    }
+  }
+  for (const cmd of cmdsWithSubs) {
+    if (cmd.flags?.length) {
+      lines.push("");
+      lines.push(`# ${cmd.name} flags`);
+      for (const f of cmd.flags) {
+        const long = f.name.replace(/^--/, "");
+        lines.push(`complete -c outlit -n '__outlit_using_cmd ${cmd.name}' -l ${long} -d "${esc(f.desc)}"`);
+      }
+    }
+  }
+  for (const cmd of cmdsWithSubs) {
+    for (const sub of cmd.subs) {
+      if (sub.flags?.length) {
+        lines.push("");
+        lines.push(`# ${cmd.name} ${sub.name} flags`);
+        for (const f of sub.flags) {
+          const long = f.name.replace(/^--/, "");
+          lines.push(`complete -c outlit -n '__outlit_using_cmd ${cmd.name} ${sub.name}' -l ${long} -d "${esc(f.desc)}"`);
+        }
+      }
+    }
+  }
+  return lines.join(`
+`) + `
 `;
+}
+var JSON_F, API_KEY_F, LIMIT_F, CURSOR_F, COMMON, PAGINATED, ACTIVITY_ORDER, COMMANDS, cmdsWithSubs, leafCmds, SCRIPTS, completions_default;
+var init_completions = __esm(() => {
+  init_dist();
+  init_output2();
+  init_output();
+  JSON_F = { name: "--json", desc: "Force JSON output" };
+  API_KEY_F = { name: "--api-key", desc: "Outlit API key" };
+  LIMIT_F = { name: "--limit", desc: "Max results (1-100)" };
+  CURSOR_F = { name: "--cursor", desc: "Pagination cursor" };
+  COMMON = [API_KEY_F, JSON_F];
+  PAGINATED = [...COMMON, LIMIT_F, CURSOR_F];
+  ACTIVITY_ORDER = [
+    { name: "--no-activity-in", desc: "No activity in period" },
+    { name: "--has-activity-in", desc: "Activity in period" },
+    { name: "--order-by", desc: "Sort field" },
+    { name: "--order-direction", desc: "Sort direction (asc, desc)" }
+  ];
+  COMMANDS = [
+    {
+      name: "auth",
+      desc: "Manage authentication",
+      subs: [
+        { name: "signup", desc: "Create an Outlit account", flags: [JSON_F] },
+        { name: "login", desc: "Store API key", flags: [JSON_F, { name: "--key", desc: "API key to store" }] },
+        { name: "logout", desc: "Remove stored key", flags: [JSON_F] },
+        { name: "status", desc: "Check auth state", flags: [...COMMON] },
+        { name: "whoami", desc: "Print masked key", flags: [...COMMON] }
+      ]
+    },
+    {
+      name: "customers",
+      desc: "Customer operations",
+      subs: [
+        {
+          name: "list",
+          desc: "List and filter customers",
+          flags: [
+            ...PAGINATED,
+            ...ACTIVITY_ORDER,
+            { name: "--billing-status", desc: "Filter by billing status" },
+            { name: "--mrr-above", desc: "MRR above threshold (cents)" },
+            { name: "--mrr-below", desc: "MRR below threshold (cents)" },
+            { name: "--search", desc: "Search name or domain" },
+            { name: "--status", desc: "Customer status filter" },
+            { name: "--type", desc: "Customer type filter" }
+          ]
+        },
+        {
+          name: "get",
+          desc: "Get customer by ID or domain",
+          flags: [
+            ...COMMON,
+            { name: "--include", desc: "Sections to include" },
+            { name: "--timeframe", desc: "Metrics timeframe" }
+          ]
+        },
+        {
+          name: "timeline",
+          desc: "Show activity timeline",
+          flags: [
+            ...PAGINATED,
+            { name: "--channels", desc: "Filter by channels" },
+            { name: "--event-types", desc: "Filter by event types" },
+            { name: "--timeframe", desc: "Event timeframe" },
+            { name: "--start-date", desc: "Start date (ISO 8601)" },
+            { name: "--end-date", desc: "End date (ISO 8601)" }
+          ]
+        }
+      ]
+    },
+    {
+      name: "users",
+      desc: "User operations",
+      subs: [
+        {
+          name: "list",
+          desc: "List and filter users",
+          flags: [
+            ...PAGINATED,
+            ...ACTIVITY_ORDER,
+            { name: "--journey-stage", desc: "Filter by journey stage" },
+            { name: "--customer-id", desc: "Filter by customer UUID" },
+            { name: "--search", desc: "Search name or email" }
+          ]
+        }
+      ]
+    },
+    {
+      name: "facts",
+      desc: "Get customer facts",
+      flags: [...PAGINATED, { name: "--timeframe", desc: "Lookback window (7d, 30d, 90d)" }]
+    },
+    {
+      name: "search",
+      desc: "Search customer context",
+      flags: [
+        ...COMMON,
+        { name: "--customer", desc: "Scope to customer (UUID or domain)" },
+        { name: "--top-k", desc: "Max results" },
+        { name: "--after", desc: "Events after date (ISO 8601)" },
+        { name: "--before", desc: "Events before date (ISO 8601)" }
+      ]
+    },
+    {
+      name: "sql",
+      desc: "Execute SQL queries",
+      flags: [
+        ...COMMON,
+        { name: "--query-file", desc: "Path to .sql file" },
+        { name: "--limit", desc: "Max rows to return" }
+      ]
+    },
+    { name: "schema", desc: "Discover table schemas", flags: [...COMMON] },
+    {
+      name: "setup",
+      desc: "Configure AI agent tools",
+      flags: [...COMMON, { name: "--yes", desc: "Skip prompts" }],
+      subs: [
+        { name: "cursor", desc: "Configure Cursor", flags: [...COMMON] },
+        { name: "claude-code", desc: "Configure Claude Code", flags: [...COMMON] },
+        { name: "claude-desktop", desc: "Configure Claude Desktop", flags: [...COMMON] },
+        { name: "vscode", desc: "Configure VS Code", flags: [...COMMON] },
+        { name: "gemini", desc: "Configure Gemini CLI", flags: [...COMMON] },
+        { name: "openclaw", desc: "Configure OpenClaw", flags: [...COMMON] }
+      ]
+    },
+    { name: "doctor", desc: "Diagnose environment", flags: [...COMMON] },
+    { name: "completions", desc: "Generate shell completions", flags: [JSON_F] }
+  ];
+  cmdsWithSubs = COMMANDS.filter((c) => c.subs?.length);
+  leafCmds = COMMANDS.filter((c) => !c.subs?.length && c.flags?.length);
   SCRIPTS = {
-    bash: BASH_SCRIPT,
-    zsh: ZSH_SCRIPT,
-    fish: FISH_SCRIPT
+    bash: generateBash,
+    zsh: generateZsh,
+    fish: generateFish
   };
   completions_default = defineCommand2({
     meta: {
@@ -3570,14 +3935,14 @@ ${COMMANDS.map((c) => `complete -c outlit -f -a ${c.name} -d "${c.desc.replace(/
     run({ args }) {
       const json = !!args.json;
       const shell = args.shell;
-      const script = SCRIPTS[shell];
-      if (!script) {
+      const generate = SCRIPTS[shell];
+      if (!generate) {
         return outputError({
           message: `Unknown shell: ${shell}. Supported: bash, zsh, fish`,
           code: "unknown_shell"
         }, json);
       }
-      process.stdout.write(script);
+      process.stdout.write(generate());
     }
   });
 });
@@ -3690,7 +4055,7 @@ var init_setup3 = __esm(() => {
         console.log("Detected agents:");
         for (const agentId of detected) {
           const { label, hint } = agentLabels2[agentId];
-          console.log(`  ${TICK} ${label.padEnd(14)} — ${hint}`);
+          console.log(`  ${TICK2} ${label.padEnd(14)} -- ${hint}`);
         }
         console.log(`
 Configuring...`);
@@ -4066,14 +4431,20 @@ async function runMain(cmd, opts = {}) {
 // src/lib/config.ts
 init_package();
 init_output();
+init_tty();
 var CLI_VERSION = package_default.version;
+var TICK = `\x1B[32m${isUnicodeSupported ? String.fromCodePoint(10003) : String.fromCodePoint(8730)}\x1B[0m`;
 
 // src/cli.ts
+if (process.argv.includes("-v")) {
+  console.log(CLI_VERSION);
+  process.exit(0);
+}
 var main = defineCommand({
   meta: {
     name: "outlit",
     version: CLI_VERSION,
-    description: `Outlit CLI \u2014 customer intelligence from the terminal.
+    description: `Outlit CLI -- customer intelligence from the terminal.
 
 Usage examples:
   outlit customers list --billing-status PAYING --no-activity-in 30d

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@outlit/cli",
-  "version": "0.1.0",
+  "version": "1.0.1",
   "description": "CLI for Outlit customer intelligence platform",
   "license": "Apache-2.0",
   "repository": {
@@ -13,7 +13,9 @@
     "access": "public"
   },
   "type": "module",
-  "bin": { "outlit": "./dist/cli.js" },
+  "bin": {
+    "outlit": "./dist/cli.js"
+  },
   "files": ["dist"],
   "scripts": {
     "dev": "bun run src/cli.ts",