@intercom/cli 0.1.1 → 0.3.0

package/dist/index.js

@@ -1,105 +1,25 @@
 #!/usr/bin/env node
+import {
+  AuthError,
+  CLIError,
+  NotFoundError,
+  PermissionError,
+  RateLimitError,
+  TimeoutError,
+  applyJq,
+  detectAuthType,
+  formatJson
+} from "./chunk-Y4JK5AHH.js";
 
 // src/index.ts
 import { Command } from "commander";
 
-// src/types.ts
-var CLIError = class extends Error {
-  constructor(message, exitCode = 1, error) {
-    super(message);
-    this.exitCode = exitCode;
-    this.error = error;
-    this.name = "CLIError";
-  }
-};
-var AuthError = class extends CLIError {
-  constructor(message) {
-    super(message, 2);
-  }
-};
-var RateLimitError = class extends CLIError {
-  constructor(message, retryAfter) {
-    super(message, 3);
-    this.retryAfter = retryAfter;
-  }
-};
-var NotFoundError = class extends CLIError {
-  constructor(message) {
-    super(message, 4);
-  }
-};
-var PermissionError = class extends CLIError {
-  constructor(message) {
-    super(message, 5);
-  }
-};
-var TimeoutError = class extends CLIError {
-  constructor(message) {
-    super(message, 6);
-  }
-};
-function detectAuthType(token) {
-  try {
-    const decoded = Buffer.from(token, "base64").toString("utf-8");
-    if (decoded.startsWith("tok:")) {
-      return "oauth";
-    }
-  } catch {
-  }
-  return "api_key";
-}
-
-// src/output/json.ts
-function formatJson(data) {
-  return JSON.stringify(data, null, 2);
-}
-function applyJq(data, expr) {
-  if (expr === ".") return data;
-  if (!expr.startsWith(".")) {
-    throw new CLIError(
-      `Unsupported jq expression: "${expr}". Supported: ".", ".field", ".field.nested", ".field[].nested"`
-    );
-  }
-  if (/[|(){},;]/.test(expr)) {
-    throw new CLIError(
-      `Unsupported jq expression: "${expr}". Supported: ".", ".field", ".field.nested", ".field[].nested"`
-    );
-  }
-  const parts = expr.replace(/^\.\s*/, "").split(/\./).filter(Boolean);
-  for (const part of parts) {
-    if (!/^\w+(\[\])?$/.test(part)) {
-      throw new CLIError(
-        `Unsupported jq expression: "${expr}". Supported: ".", ".field", ".field.nested", ".field[].nested"`
-      );
-    }
-  }
-  let current = data;
-  for (const part of parts) {
-    const arrayMatch = part.match(/^(\w+)\[\]$/);
-    if (arrayMatch) {
-      const key = arrayMatch[1];
-      if (current && typeof current === "object" && key in current) {
-        const arr = current[key];
-        if (!Array.isArray(arr)) return void 0;
-        current = arr;
-      } else {
-        return void 0;
-      }
-    } else if (Array.isArray(current)) {
-      current = current.map(
-        (item) => item && typeof item === "object" ? item[part] : void 0
-      );
-    } else if (current && typeof current === "object") {
-      current = current[part];
-    } else {
-      return void 0;
-    }
-  }
-  return current;
-}
+// src/commands/api.ts
+import { readFileSync as readFileSync3 } from "fs";
 
 // src/api/timeouts.ts
 var API_TIMEOUT_MS = 3e4;
+var SIMULATION_POLL_TIMEOUT_MS = 6e5;
 
 // src/version.ts
 import { createRequire } from "module";
@@ -246,6 +166,22 @@ var IntercomClient = class {
           retryAfter
         );
       }
+      const RETRYABLE_5XX = [502, 503, 504];
+      if (RETRYABLE_5XX.includes(response.status)) {
+        if (attempt < this.maxRetries) {
+          const backoffMs = Math.pow(2, attempt) * 1e3;
+          if (this.verbose) {
+            console.error(
+              `Server error ${response.status}. Retrying in ${backoffMs / 1e3}s (attempt ${attempt + 1}/${this.maxRetries})...`
+            );
+          }
+          await new Promise((r) => setTimeout(r, backoffMs));
+          continue;
+        }
+        throw new CLIError(
+          `Server error ${response.status} after ${this.maxRetries} retries: ${errorMsg}`
+        );
+      }
       throw new CLIError(errorMsg);
     }
     throw new CLIError("Request failed after retries");
@@ -475,9 +411,9 @@ var FallbackBackend = class {
     }
   }
 };
-function createDefaultBackend(configDir) {
-  if (configDir) {
-    return new EncryptedFileBackend(configDir);
+function createDefaultBackend(configDir2) {
+  if (configDir2) {
+    return new EncryptedFileBackend(configDir2);
   }
   return new FallbackBackend(
     new NativeKeychainBackend(),
@@ -516,8 +452,8 @@ var CONFIG_FILE = "config.json";
 function defaultConfigDir() {
   return join2(homedir2(), ".intercom");
 }
-async function readConfig(configDir) {
-  const dir = configDir ?? defaultConfigDir();
+async function readConfig(configDir2) {
+  const dir = configDir2 ?? defaultConfigDir();
   try {
     const raw = await readFile(join2(dir, CONFIG_FILE), "utf-8");
     return JSON.parse(raw);
@@ -525,27 +461,27 @@ async function readConfig(configDir) {
     return { workspaces: {} };
   }
 }
-async function writeConfig(config, configDir) {
-  const dir = configDir ?? defaultConfigDir();
+async function writeConfig(config, configDir2) {
+  const dir = configDir2 ?? defaultConfigDir();
   await mkdir(dir, { recursive: true });
   await atomicWriteFile(join2(dir, CONFIG_FILE), JSON.stringify(config, null, 2) + "\n");
 }
-async function addWorkspace(configDir, workspace) {
-  const config = await readConfig(configDir);
+async function addWorkspace(configDir2, workspace) {
+  const config = await readConfig(configDir2);
   config.workspaces[workspace.app_id] = workspace;
   if (!config.default) {
     config.default = workspace.app_id;
   }
-  await writeConfig(config, configDir);
+  await writeConfig(config, configDir2);
 }
-async function removeWorkspace(configDir, appId) {
-  const config = await readConfig(configDir);
+async function removeWorkspace(configDir2, appId) {
+  const config = await readConfig(configDir2);
   delete config.workspaces[appId];
   if (config.default === appId) {
     const remaining = Object.keys(config.workspaces);
     config.default = remaining.length > 0 ? remaining[0] : void 0;
   }
-  await writeConfig(config, configDir);
+  await writeConfig(config, configDir2);
 }
 
 // src/commands/helpers.ts
@@ -562,8 +498,8 @@ async function resolveClient(options = {}) {
       timeoutMs: options.timeout ? parseInt(options.timeout, 10) * 1e3 : void 0
     });
   }
-  const configDir = process.env.INTERCOM_CONFIG_DIR;
-  const config = await readConfig(configDir);
+  const configDir2 = process.env.INTERCOM_CONFIG_DIR;
+  const config = await readConfig(configDir2);
   const appId = options.workspace ?? config.default;
   if (!appId) {
     throw new AuthError(
@@ -575,7 +511,7 @@ async function resolveClient(options = {}) {
       `Default workspace "${appId}" is not in configured workspaces. Run "intercom auth bootstrap" or "intercom auth login --token <token>" to re-authenticate.`
     );
   }
-  const store = new CredentialStore(createDefaultBackend(configDir));
+  const store = new CredentialStore(createDefaultBackend(configDir2));
   const cred = await store.get(appId);
   if (!cred) {
     throw new AuthError(
@@ -629,6 +565,20 @@ function render(data, opts, humanRenderer, listItems) {
     console.log(formatJson(data));
     return;
   }
+  if (opts.agent) {
+    if (listItems) {
+      for (const item of listItems) {
+        console.log(JSON.stringify(item));
+      }
+    } else {
+      console.log(JSON.stringify(data));
+    }
+    return;
+  }
+  if (opts.human) {
+    console.log(humanRenderer());
+    return;
+  }
   if (!process.stdout.isTTY) {
     if (listItems) {
       for (const item of listItems) {
@@ -672,20 +622,44 @@ function parseTypedFields(fields, typed) {
 }
 
 // src/commands/api.ts
+function readInput(input) {
+  let raw;
+  if (input === "-") {
+    const fd = readFileSync3(0, "utf-8");
+    raw = fd;
+  } else {
+    raw = readFileSync3(input, "utf-8");
+  }
+  try {
+    return JSON.parse(raw);
+  } catch {
+    throw new CLIError(`Failed to parse JSON from ${input === "-" ? "stdin" : input}`);
+  }
+}
 function registerApiCommand(program) {
-  program.command("api").description("Make an authenticated API request (like gh api)").argument("<endpoint>", "API endpoint path (e.g., /articles)").option("-X, --method <method>", "HTTP method").option("-f, --field <key=value...>", "String field").option(
+  program.command("api").description("Make an authenticated API request (like gh api)").argument("<endpoint>", "API endpoint path (e.g., /articles)").addHelpText(
+    "after",
+    `
+Examples:
+  intercom api /me
+  intercom api /articles --paginate
+  intercom api /contacts -X POST -f email=test@example.com -f role=user
+  intercom api /articles/123 --jq '.title'`
+  ).option("-X, --method <method>", "HTTP method").option("-f, --field <key=value...>", "String field").option(
     "-F, --typed-field <key=value...>",
     "Typed field (bools, numbers, file reads)"
-  ).option("--jq <expr>", "Filter response with jq expression").option("--json", "Output as JSON").option("--paginate", "Auto-paginate through all pages").option("--verbose", "Show full HTTP request/response").action(async function(endpoint) {
+  ).option("--jq <expr>", "Filter response with jq expression").option("--json", "Output as JSON").option("--input <file>", "Read JSON body from file (use - for stdin)").option("--paginate", "Auto-paginate through all pages").option("--verbose", "Show full HTTP request/response").action(async function(endpoint) {
     const options = this.optsWithGlobals();
     const client = await resolveClient(options);
     const stringFields = options.field ?? [];
     const typedFields = options.typedField ?? [];
+    const inputBody = options.input ? readInput(options.input) : {};
     const body = {
+      ...inputBody,
       ...parseTypedFields(stringFields, false),
       ...parseTypedFields(typedFields, true)
     };
-    const hasBody = stringFields.length > 0 || typedFields.length > 0;
+    const hasBody = stringFields.length > 0 || typedFields.length > 0 || !!options.input;
     const method = options.method ?? (hasBody ? "POST" : "GET");
     let result;
     if (options.paginate && method.toUpperCase() === "GET") {
@@ -729,7 +703,14 @@ function registerApiCommand(program) {
 
 // src/commands/auth/login.ts
 function registerLoginCommand(auth) {
-  auth.command("login").description("Authenticate with Intercom").option("--token <token>", "Authenticate with an API key or token directly").option("--device", "Use device flow (for headless environments)").action(async (options) => {
+  auth.command("login").description("Authenticate with Intercom").option("--token <token>", "Authenticate with an API key or token directly").option("--device", "Use device flow (for headless environments)").addHelpText(
+    "after",
+    `
+Examples:
+  $ intercom auth login --token <your-api-token>
+
+Environment: Set INTERCOM_TOKEN to skip login entirely.`
+  ).action(async (options) => {
     if (options.token) {
       await loginWithToken(options.token);
     } else if (options.device) {
@@ -753,17 +734,17 @@ async function loginWithToken(token) {
   const app = me.app;
   const appId = app?.id_code ?? me.id;
   const name = app?.name ?? "Unknown";
-  const configDir = process.env.INTERCOM_CONFIG_DIR;
-  const store = new CredentialStore(createDefaultBackend(configDir));
+  const configDir2 = process.env.INTERCOM_CONFIG_DIR;
+  const store = new CredentialStore(createDefaultBackend(configDir2));
   await store.set(appId, { token, auth_type: authType, app_id: appId });
-  await addWorkspace(configDir, { app_id: appId, name });
+  await addWorkspace(configDir2, { app_id: appId, name });
   console.log(`Authenticated to ${name} (${appId})`);
 }
 
 // src/auth/cookies.ts
 function extractCookies(response) {
   const setCookies = typeof response.headers.getSetCookie === "function" ? response.headers.getSetCookie() : (response.headers.get("set-cookie") ?? "").split(/,(?=[^ ])/).filter(Boolean);
-  return setCookies.map((c) => c.split(";")[0]).join("; ");
+  return setCookies.map((c2) => c2.split(";")[0]).join("; ");
 }
 function mergeCookies(existing, newCookies) {
   const map = /* @__PURE__ */ new Map();
@@ -828,7 +809,6 @@ async function signup(options) {
     email_submission: {},
     sign_up_locale: "en",
     new_app_feature_flags: [
-      "synchronously-create-subscription-on-signup",
       "fin-sdk",
       "messenger-public-api"
     ]
@@ -929,6 +909,13 @@ async function findOrCreateAppPackage(baseUrl, cookies, appId, appPackageId, tim
     { timeoutMs }
   );
   if (!listResponse.ok) {
+    if (listResponse.status === 403) {
+      throw new Error(
+        `Developer Hub access denied (403). This usually means the admin email has not been verified.
+  Verify your email first: intercom auth verify-email --url <url-from-verification-email>
+  Then retry this command.`
+      );
+    }
     throw new Error(`Failed to list app packages: ${listResponse.status}`);
   }
   const data = await listResponse.json();
@@ -970,6 +957,13 @@ async function findOrCreateAppPackage(baseUrl, cookies, appId, appPackageId, tim
     { timeoutMs }
   );
   if (!createResponse.ok) {
+    if (createResponse.status === 403) {
+      throw new Error(
+        `Developer Hub access denied (403). This usually means the admin email has not been verified.
+  Verify your email first: intercom auth verify-email --url <url-from-verification-email>
+  Then retry this command.`
+      );
+    }
     throw new Error(`Failed to create app package: ${createResponse.status}`);
   }
   const created = await createResponse.json();
@@ -1074,10 +1068,10 @@ function registerBootstrapCommand(auth) {
         console.log(`Found app package: ${appPackage.name} (id: ${appPackage.id})`);
       }
       console.log("Access token acquired");
-      const configDir = process.env.INTERCOM_CONFIG_DIR;
-      const store = new CredentialStore(createDefaultBackend(configDir));
+      const configDir2 = process.env.INTERCOM_CONFIG_DIR;
+      const store = new CredentialStore(createDefaultBackend(configDir2));
       await store.set(appId, { token, auth_type: "oauth", app_id: appId });
-      await addWorkspace(configDir, { app_id: appId, name: appId });
+      await addWorkspace(configDir2, { app_id: appId, name: appId });
       console.log(`
 Authenticated to workspace ${appId}`);
     } catch (err) {
@@ -1089,15 +1083,85 @@ Authenticated to workspace ${appId}`);
 }
 
 // src/output/formatter.ts
+import pc from "picocolors";
+function isColorEnabled() {
+  return !!process.stdout.isTTY && !process.env.NO_COLOR;
+}
+function c(fn, s) {
+  return isColorEnabled() ? fn(s) : s;
+}
+var STATUS_COLORS = {
+  // green
+  active: pc.green,
+  open: pc.green,
+  published: pc.green,
+  enabled: pc.green,
+  verified: pc.green,
+  true: pc.green,
+  // red
+  error: pc.red,
+  closed: pc.red,
+  deleted: pc.red,
+  disabled: pc.red,
+  false: pc.red,
+  // yellow
+  pending: pc.yellow,
+  draft: pc.yellow,
+  snoozed: pc.yellow
+};
+function colorizeStatus(value) {
+  if (!isColorEnabled()) return value;
+  const fn = STATUS_COLORS[value.toLowerCase()];
+  return fn ? fn(value) : value;
+}
+function truncate(value, max) {
+  if (value.length <= max) return value;
+  return value.slice(0, max - 1) + "\u2026";
+}
+var DEFAULT_MAX_COLUMNS = 8;
+var DEFAULT_TRUNCATION = 50;
+var WIDE_TRUNCATION = 200;
+var STATUS_KEYS = /* @__PURE__ */ new Set([
+  "STATE",
+  "STATUS",
+  "OPEN",
+  "ROLE",
+  "ENABLED"
+]);
+function isWide() {
+  return process.argv.includes("--wide");
+}
 function table({ columns, rows }) {
   if (rows.length === 0) return "";
-  const widths = columns.map(
-    (col) => Math.max(col.length, ...rows.map((row) => (row[col] ?? "").length))
+  const wide = isWide();
+  const maxTrunc = wide ? WIDE_TRUNCATION : DEFAULT_TRUNCATION;
+  const displayColumns = wide ? columns : columns.slice(0, DEFAULT_MAX_COLUMNS);
+  const truncatedRows = rows.map((row) => {
+    const out = {};
+    for (const col of displayColumns) {
+      out[col] = truncate(row[col] ?? "", maxTrunc);
+    }
+    return out;
+  });
+  const widths = displayColumns.map(
+    (col) => Math.max(
+      col.length,
+      ...truncatedRows.map((row) => (row[col] ?? "").length)
+    )
   );
-  const formatRow = (values) => values.map((val, i) => i < values.length - 1 ? val.padEnd(widths[i]) : val).join("  ");
-  const header = formatRow(columns);
-  const body = rows.map(
-    (row) => formatRow(columns.map((col) => row[col] ?? ""))
+  const formatRow = (values, isHeader) => values.map((val, i) => {
+    const col = displayColumns[i];
+    const padded = i < values.length - 1 ? val.padEnd(widths[i]) : val;
+    if (isHeader) return c(pc.bold, padded);
+    if (STATUS_KEYS.has(col)) return colorizeStatus(padded);
+    return padded;
+  }).join("  ");
+  const header = formatRow(displayColumns, true);
+  const body = truncatedRows.map(
+    (row) => formatRow(
+      displayColumns.map((col) => row[col] ?? ""),
+      false
+    )
   );
   return [header, ...body].join("\n");
 }
@@ -1107,19 +1171,25 @@ function detail(data) {
   );
   if (entries.length === 0) return "";
   const maxKeyLen = Math.max(...entries.map(([k]) => k.length));
-  return entries.map(([key, value]) => `${key.padEnd(maxKeyLen)}:  ${value}`).join("\n");
+  return entries.map(([key, value]) => {
+    const label = c(pc.bold, key.padEnd(maxKeyLen));
+    const strVal = String(value);
+    const isStatus = STATUS_KEYS.has(key.toUpperCase());
+    const colored = isStatus ? colorizeStatus(strVal) : strVal;
+    return `${label}:  ${colored}`;
+  }).join("\n");
 }
 
 // src/commands/auth/status.ts
 function registerStatusCommand(auth) {
   auth.command("status").description("Show current authentication status").option("--json", "Output as JSON").action(async (options) => {
-    const configDir = process.env.INTERCOM_CONFIG_DIR;
-    const config = await readConfig(configDir);
+    const configDir2 = process.env.INTERCOM_CONFIG_DIR;
+    const config = await readConfig(configDir2);
     const appId = config.default;
     if (!appId) {
       throw new AuthError('Not authenticated. Run "intercom auth login" to get started.');
     }
-    const store = new CredentialStore(createDefaultBackend(configDir));
+    const store = new CredentialStore(createDefaultBackend(configDir2));
     const cred = await store.get(appId);
     if (!cred) {
       throw new AuthError('Not authenticated. Run "intercom auth login" to get started.');
@@ -1146,15 +1216,15 @@ function registerStatusCommand(auth) {
 // src/commands/auth/logout.ts
 function registerLogoutCommand(auth) {
   auth.command("logout").description("Remove stored credentials").option("--workspace <id>", "Workspace app_id to log out of").action(async (options) => {
-    const configDir = process.env.INTERCOM_CONFIG_DIR;
-    const config = await readConfig(configDir);
+    const configDir2 = process.env.INTERCOM_CONFIG_DIR;
+    const config = await readConfig(configDir2);
     const appId = options.workspace ?? config.default;
     if (!appId) {
       throw new AuthError("Not authenticated.");
     }
-    const store = new CredentialStore(createDefaultBackend(configDir));
+    const store = new CredentialStore(createDefaultBackend(configDir2));
     await store.delete(appId);
-    await removeWorkspace(configDir, appId);
+    await removeWorkspace(configDir2, appId);
     const name = config.workspaces[appId]?.name ?? appId;
     console.log(`Logged out of ${name} (${appId})`);
   });
@@ -1193,10 +1263,10 @@ function registerSignupCommand(auth) {
           password,
           appId: workspace.id
         });
-        const configDir = process.env.INTERCOM_CONFIG_DIR;
-        const store = new CredentialStore(createDefaultBackend(configDir));
+        const configDir2 = process.env.INTERCOM_CONFIG_DIR;
+        const store = new CredentialStore(createDefaultBackend(configDir2));
         await store.set(appId, { token, auth_type: "oauth", app_id: appId });
-        await addWorkspace(configDir, { app_id: appId, name: workspace.name });
+        await addWorkspace(configDir2, { app_id: appId, name: workspace.name });
         console.log(`
 Authenticated to workspace ${appId}`);
       } catch {
@@ -1242,15 +1312,84 @@ function registerVerifyEmailCommand(auth) {
   });
 }
 
+// src/commands/auth/list.ts
+function registerListCommand(auth) {
+  auth.command("list").description("List all configured workspaces").option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").action(async function() {
+    const opts = this.optsWithGlobals();
+    const configDir2 = process.env.INTERCOM_CONFIG_DIR;
+    const config = await readConfig(configDir2);
+    const store = new CredentialStore(createDefaultBackend(configDir2));
+    const workspaces = await Promise.all(
+      Object.values(config.workspaces).map(async (ws) => {
+        const cred = await store.get(ws.app_id);
+        return {
+          app_id: ws.app_id,
+          name: ws.name,
+          auth_type: cred?.auth_type ?? "unknown",
+          default: ws.app_id === config.default
+        };
+      })
+    );
+    render(
+      workspaces,
+      opts,
+      () => {
+        if (workspaces.length === 0) {
+          return 'No workspaces configured. Run "intercom auth login" to get started.';
+        }
+        const rows = workspaces.map((ws) => ({
+          DEFAULT: ws.default ? "*" : "",
+          APP_ID: ws.app_id,
+          NAME: ws.name,
+          AUTH_TYPE: ws.auth_type
+        }));
+        return table({
+          columns: ["DEFAULT", "APP_ID", "NAME", "AUTH_TYPE"],
+          rows
+        });
+      },
+      workspaces
+    );
+  });
+}
+
+// src/commands/auth/switch.ts
+function registerSwitchCommand(auth) {
+  auth.command("switch <app_id>").description("Switch the default workspace").action(async (appId) => {
+    const configDir2 = process.env.INTERCOM_CONFIG_DIR;
+    const config = await readConfig(configDir2);
+    if (!config.workspaces[appId]) {
+      const available = Object.keys(config.workspaces);
+      const hint = available.length > 0 ? ` Available: ${available.join(", ")}` : ' Run "intercom auth login" to add a workspace.';
+      throw new CLIError(`Workspace "${appId}" not found.${hint}`);
+    }
+    config.default = appId;
+    await writeConfig(config, configDir2);
+    const name = config.workspaces[appId].name;
+    console.log(`Switched to ${name} (${appId})`);
+  });
+}
+
 // src/commands/auth/index.ts
 function registerAuthCommand(program) {
-  const auth = program.command("auth").description("Manage authentication credentials");
+  const auth = program.command("auth").description("Manage authentication credentials").addHelpText(
+    "after",
+    `
+Examples:
+  intercom auth login --token <api-token>
+  intercom auth status
+  intercom auth logout
+
+Environment: Set INTERCOM_TOKEN to skip login entirely.`
+  );
   registerLoginCommand(auth);
   registerBootstrapCommand(auth);
   registerStatusCommand(auth);
   registerLogoutCommand(auth);
   registerSignupCommand(auth);
   registerVerifyEmailCommand(auth);
+  registerListCommand(auth);
+  registerSwitchCommand(auth);
 }
 
 // src/commands/me.ts
@@ -1286,8 +1425,23 @@ function htmlToText(html) {
 
 // src/commands/articles.ts
 function registerArticlesCommand(program) {
-  const articles = program.command("articles").description("Manage help center articles");
-  articles.command("list").description("List help center articles").option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").option("--limit <n>", "Max results to return", "25").option("--all", "Auto-paginate all pages").action(async function() {
+  const articles = program.command("articles").description("Manage help center articles (list, get, create, update, delete)").addHelpText(
+    "after",
+    `
+Examples:
+  intercom articles list
+  intercom articles get 123
+  intercom articles create -f title="Getting Started" -F body=@article.md
+  intercom articles update 123 -f state=published
+  intercom articles delete 123`
+  );
+  articles.command("list").description("List help center articles").option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").option("--limit <n>", "Max results to return", "25").option("--all", "Auto-paginate all pages").addHelpText(
+    "after",
+    `
+Examples:
+  $ intercom articles list --json
+  $ intercom articles list --all --jq '.[].title'`
+  ).action(async function() {
     const opts = this.optsWithGlobals();
     const client = await resolveClient(opts);
     let result;
@@ -1344,7 +1498,16 @@ ${body}` : meta;
     "Typed field: bools, numbers, @file reads (repeatable)",
     (v, acc) => [...acc, v],
     []
-  ).option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").action(async function() {
+  ).option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").addHelpText(
+    "after",
+    `
+Examples:
+  $ intercom articles create -f title='Getting Started' -f body='<p>Hello</p>'
+  $ intercom articles create -F body=@article.html -f title='Guide'
+
+Common fields: title, body, author_id, state, parent_id, parent_type
+Use -F for typed values (numbers, booleans) and @file reads.`
+  ).action(async function() {
     const opts = this.optsWithGlobals();
     const client = await resolveClient(opts);
     const body = {
@@ -1409,7 +1572,15 @@ ${body}` : meta;
 
 // src/commands/contacts.ts
 function registerContactsCommand(program) {
-  const contacts = program.command("contacts").description("Manage contacts");
+  const contacts = program.command("contacts").description("Manage contacts (list, get, create, update, delete, search)").addHelpText(
+    "after",
+    `
+Examples:
+  intercom contacts list --limit 10
+  intercom contacts get abc123
+  intercom contacts create -f email=user@example.com -f role=user
+  intercom contacts delete abc123`
+  );
   contacts.command("list").description("List contacts").option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").option("--limit <n>", "Max results to return", "25").option("--all", "Auto-paginate all pages").action(async function() {
     const opts = this.optsWithGlobals();
     const client = await resolveClient(opts);
@@ -1427,12 +1598,12 @@ function registerContactsCommand(program) {
       result,
       opts,
       () => {
-        const rows = items.map((c) => ({
-          ID: String(c.id ?? ""),
-          EMAIL: String(c.email ?? ""),
-          NAME: String(c.name ?? ""),
-          ROLE: String(c.role ?? ""),
-          UPDATED: formatTimestamp(c.updated_at)
+        const rows = items.map((c2) => ({
+          ID: String(c2.id ?? ""),
+          EMAIL: String(c2.email ?? ""),
+          NAME: String(c2.name ?? ""),
+          ROLE: String(c2.role ?? ""),
+          UPDATED: formatTimestamp(c2.updated_at)
         }));
         return table({
           columns: ["ID", "EMAIL", "NAME", "ROLE", "UPDATED"],
@@ -1510,6 +1681,45 @@ function registerContactsCommand(program) {
     const deleted = result;
     render(result, opts, () => `Deleted contact ${deleted.id ?? id}`);
   });
+  contacts.command("search").description("Search contacts (POST /contacts/search)").option(
+    "-f, --field <key=value>",
+    "String field (repeatable)",
+    (v, acc) => [...acc, v],
+    []
+  ).option(
+    "-F, --typed-field <key=value>",
+    "Typed field (repeatable)",
+    (v, acc) => [...acc, v],
+    []
+  ).option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").action(async function() {
+    const opts = this.optsWithGlobals();
+    const client = await resolveClient(opts);
+    const body = {
+      ...parseTypedFields(opts.field ?? [], false),
+      ...parseTypedFields(opts.typedField ?? [], true)
+    };
+    const result = await client.post("/contacts/search", body);
+    const response = result;
+    const items = response.data ?? [];
+    render(
+      result,
+      opts,
+      () => {
+        const rows = items.map((c2) => ({
+          ID: String(c2.id ?? ""),
+          EMAIL: String(c2.email ?? ""),
+          NAME: String(c2.name ?? ""),
+          ROLE: String(c2.role ?? ""),
+          UPDATED: formatTimestamp(c2.updated_at)
+        }));
+        return table({
+          columns: ["ID", "EMAIL", "NAME", "ROLE", "UPDATED"],
+          rows
+        });
+      },
+      items
+    );
+  });
 }
 
 // src/commands/conversations.ts
@@ -1586,7 +1796,14 @@ function renderConversationStream(result) {
   return parts.join("\n");
 }
 function registerConversationsCommand(program) {
-  const conversations = program.command("conversations").description("Manage conversations");
+  const conversations = program.command("conversations").description("Manage conversations (list, get, reply, search)").addHelpText(
+    "after",
+    `
+Examples:
+  intercom conversations list
+  intercom conversations get 123
+  intercom conversations reply 123 -f body="Thanks!" -f message_type=comment -f type=admin -f admin_id=456`
+  );
   conversations.command("list").description("List conversations").option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").option("--limit <n>", "Max results to return", "25").option("--all", "Auto-paginate all pages").action(async function() {
     const opts = this.optsWithGlobals();
     const client = await resolveClient(opts);
@@ -1608,12 +1825,12 @@ function registerConversationsCommand(program) {
       result,
       opts,
       () => {
-        const rows = items.map((c) => ({
-          ID: String(c.id ?? ""),
-          STATE: String(c.state ?? ""),
-          OPEN: String(c.open ?? ""),
-          CREATED: formatTimestamp(c.created_at),
-          UPDATED: formatTimestamp(c.updated_at)
+        const rows = items.map((c2) => ({
+          ID: String(c2.id ?? ""),
+          STATE: String(c2.state ?? ""),
+          OPEN: String(c2.open ?? ""),
+          CREATED: formatTimestamp(c2.created_at),
+          UPDATED: formatTimestamp(c2.updated_at)
         }));
         return table({
           columns: ["ID", "STATE", "OPEN", "CREATED", "UPDATED"],
@@ -1637,7 +1854,14 @@ function registerConversationsCommand(program) {
     "Field to set (repeatable)",
     (v, acc) => [...acc, v],
     []
-  ).option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").action(async function(id) {
+  ).option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").addHelpText(
+    "after",
+    `
+Examples:
+  $ intercom conversations reply 123 -f type=admin -f body='Thanks!'
+
+Required fields: body, type (admin or user). Also: admin_id, message_type.`
+  ).action(async function(id) {
     const opts = this.optsWithGlobals();
     const client = await resolveClient(opts);
     const body = parseFieldArgs(opts.field ?? []);
@@ -1653,11 +1877,57 @@ function registerConversationsCommand(program) {
       })
     );
   });
+  conversations.command("search").description("Search conversations (POST /conversations/search)").option(
+    "-f, --field <key=value>",
+    "String field (repeatable)",
+    (v, acc) => [...acc, v],
+    []
+  ).option(
+    "-F, --typed-field <key=value>",
+    "Typed field (repeatable)",
+    (v, acc) => [...acc, v],
+    []
+  ).option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").action(async function() {
+    const opts = this.optsWithGlobals();
+    const client = await resolveClient(opts);
+    const body = {
+      ...parseTypedFields(opts.field ?? [], false),
+      ...parseTypedFields(opts.typedField ?? [], true)
+    };
+    const result = await client.post("/conversations/search", body);
+    const response = result;
+    const items = response.conversations ?? [];
+    render(
+      result,
+      opts,
+      () => {
+        const rows = items.map((c2) => ({
+          ID: String(c2.id ?? ""),
+          STATE: String(c2.state ?? ""),
+          OPEN: String(c2.open ?? ""),
+          CREATED: formatTimestamp(c2.created_at),
+          UPDATED: formatTimestamp(c2.updated_at)
+        }));
+        return table({
+          columns: ["ID", "STATE", "OPEN", "CREATED", "UPDATED"],
+          rows
+        });
+      },
+      items
+    );
+  });
 }
 
 // src/commands/help-center.ts
 function registerHelpCenterCommand(program) {
-  const helpCenter = program.command("help-center").description("Manage help center collections");
+  const helpCenter = program.command("help-center").description("Manage help center collections").addHelpText(
+    "after",
+    `
+Examples:
+  intercom help-center list
+  intercom help-center get 123
+  intercom help-center create -f name="FAQ"`
+  );
   helpCenter.command("list").description("List help center collections").option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").option("--limit <n>", "Max results to return", "25").option("--all", "Auto-paginate all pages").action(async function() {
     const opts = this.optsWithGlobals();
     const client = await resolveClient(opts);
@@ -1679,11 +1949,11 @@ function registerHelpCenterCommand(program) {
       result,
       opts,
       () => {
-        const rows = items.map((c) => ({
-          ID: String(c.id ?? ""),
-          NAME: String(c.name ?? ""),
-          DESCRIPTION: String(c.description ?? ""),
-          UPDATED: formatTimestamp(c.updated_at)
+        const rows = items.map((c2) => ({
+          ID: String(c2.id ?? ""),
+          NAME: String(c2.name ?? ""),
+          DESCRIPTION: String(c2.description ?? ""),
+          UPDATED: formatTimestamp(c2.updated_at)
         }));
         return table({
           columns: ["ID", "NAME", "DESCRIPTION", "UPDATED"],
@@ -1752,8 +2022,21 @@ export function IntercomWidget() {
 }`;
 }
 function registerMessengerCommand(program) {
-  const messenger = program.command("messenger").description("Manage Intercom Messenger settings");
-  messenger.command("get").description("Get Messenger settings").option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").action(async function() {
+  const messenger = program.command("messenger").description("Manage Intercom Messenger settings (get, update, snippet)").addHelpText(
+    "after",
+    `
+Examples:
+  intercom messenger get
+  intercom messenger update -f alignment=right -f theme_mode=dark
+  intercom messenger snippet --format react`
+  );
+  messenger.command("get").description("Get Messenger settings").option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").addHelpText(
+    "after",
+    `
+Examples:
+  $ intercom messenger get --json
+  $ intercom messenger get --jq '.alignment'`
+  ).action(async function() {
     const opts = this.optsWithGlobals();
     const client = await resolveClient(opts);
     const result = await client.get("/messenger", void 0, UNSTABLE_HEADERS);
@@ -1805,17 +2088,120 @@ function registerMessengerCommand(program) {
     "--format <format>",
     "Output format: html (default) or react",
     "html"
-  ).option("--verbose", "Show HTTP request/response details").action(async function() {
+  ).option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").action(async function() {
     const opts = this.optsWithGlobals();
     const client = await resolveClient(opts);
     const me = await client.get("/me");
     const app = me.app;
     const appId = String(app?.id_code ?? "");
-    if (opts.format === "react") {
-      console.log(generateReactSnippet(appId));
-    } else {
-      console.log(generateHtmlSnippet(appId));
+    const snippet = opts.format === "react" ? generateReactSnippet(appId) : generateHtmlSnippet(appId);
+    const format = opts.format ?? "html";
+    render({ format, snippet }, opts, () => snippet);
+  });
+}
+
+// src/commands/fin.ts
+import { writeFile as writeFile2 } from "fs/promises";
+
+// src/commands/fin/procedures.ts
+import { readFile as readFile2 } from "fs/promises";
+import { basename } from "path";
+import AdmZip from "adm-zip";
+function registerProceduresCommand(fin) {
+  const procedures = fin.command("procedures").description("Manage Fin SDK procedures");
+  procedures.command("list").description("List procedures from the Fin SDK manifest").option("--json", "Output as JSON").option("--verbose", "Show HTTP request/response details").action(async function() {
+    const opts = this.optsWithGlobals();
+    const client = await resolveClient(opts);
+    const result = await client.get("/fin-sdk/manifest");
+    const manifest = result;
+    const items = manifest.procedures ?? [];
+    render(items, opts, () => {
+      if (items.length === 0) {
+        return "No procedures found.";
+      }
+      const rows = items.map((item) => ({
+        ID: String(item.id ?? ""),
+        NAME: String(item.name ?? "")
+      }));
+      return table({ columns: ["ID", "NAME"], rows });
+    }, items);
+  });
+  procedures.command("get <id>").description("Download a procedure by ID and print its YAML content").option("--verbose", "Show HTTP request/response details").action(async function(id) {
+    const opts = this.optsWithGlobals();
+    const client = await resolveClient(opts);
+    const buffer = await client.getBuffer(`/fin-sdk/procedures/${id}/download`);
+    const zip = new AdmZip(buffer);
+    const entry = zip.getEntries().find((e) => e.entryName.endsWith("procedure.yaml"));
+    if (!entry) {
+      throw new Error("procedure.yaml not found in downloaded ZIP");
+    }
+    console.log(zip.readAsText(entry));
+  });
+  procedures.command("upload <file>").description("Upload a procedure file to Fin SDK").option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").action(async function(filePath) {
+    const opts = this.optsWithGlobals();
+    const client = await resolveClient(opts);
+    const fileContent = await readFile2(filePath);
+    const formData = new FormData();
+    const blob = new Blob([fileContent], { type: "application/x-yaml" });
+    formData.append("file_data", blob, basename(filePath));
+    const result = await client.postFormData("/fin-sdk/upload", formData);
+    render(result, opts, () => formatJson(result));
+  });
+}
+
+// src/commands/fin/data-connectors.ts
+function registerDataConnectorsCommand(fin) {
+  const dataConnectors = fin.command("data-connectors").description("Manage Fin SDK data connectors");
+  dataConnectors.command("list").description("List data connectors from the Fin SDK manifest").option("--json", "Output as JSON").option("--verbose", "Show HTTP request/response details").action(async function() {
+    const opts = this.optsWithGlobals();
+    const client = await resolveClient(opts);
+    const result = await client.get("/fin-sdk/manifest");
+    const manifest = result;
+    const items = manifest.data_connectors ?? [];
+    render(items, opts, () => {
+      if (items.length === 0) {
+        return "No data connectors found.";
+      }
+      const rows = items.map((item) => ({
+        ID: String(item.id ?? ""),
+        NAME: String(item.name ?? "")
+      }));
+      return table({ columns: ["ID", "NAME"], rows });
+    }, items);
+  });
+  dataConnectors.command("create").description("Create a data connector").requiredOption("-f, --field <key=value>", "Field to set (e.g. name=<name>)", (v, acc) => [...acc, v], []).option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").action(async function() {
+    const opts = this.optsWithGlobals();
+    const client = await resolveClient(opts);
+    const fields = opts.field ?? [];
+    const body = {};
+    for (const f of fields) {
+      const eq = f.indexOf("=");
+      if (eq === -1) throw new Error(`Invalid field format: ${f}. Expected key=value`);
+      body[f.slice(0, eq)] = f.slice(eq + 1);
     }
+    const result = await client.post("/fin-sdk/data-connectors", body);
+    render(
+      result,
+      opts,
+      () => detail({
+        "ID": String(result.id ?? ""),
+        "Name": String(result.name ?? ""),
+        "Status": result.status != null ? String(result.status) : void 0
+      })
+    );
+  });
+  dataConnectors.command("get <id>").description("Download a data connector by ID").option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").action(async function(id) {
+    const opts = this.optsWithGlobals();
+    const client = await resolveClient(opts);
+    const result = await client.get(`/fin-sdk/data-connectors/${id}/download`);
+    render(
+      result,
+      opts,
+      () => detail({
+        "ID": String(result.id ?? ""),
+        "Name": String(result.name ?? "")
+      })
+    );
   });
 }
 
@@ -1839,12 +2225,175 @@ function registerGuidanceCommand(fin) {
       return table({ columns: ["ID", "NAME"], rows });
     }, items);
   });
-  guidance.command("get <id>").description("Download a guidance item by ID and print its YAML content").option("--verbose", "Show HTTP request/response details").action(async function(id) {
+  guidance.command("get <id>").description("Download a guidance item by ID and print its YAML content").option("--json", "Output as JSON").option("--verbose", "Show HTTP request/response details").action(async function(id) {
     const opts = this.optsWithGlobals();
     const client = await resolveClient(opts);
     const text = await client.getText(`/fin-sdk/guidance/${id}/download`);
+    render({ format: "yaml", content: text }, opts, () => text);
+  });
+}
+
+// src/commands/fin/attributes.ts
+function registerAttributesCommand(fin) {
+  const attributes = fin.command("attributes").description("Manage Fin SDK attributes");
+  attributes.command("list").description("List Fin SDK attributes").option("--json", "Output as JSON").option("--verbose", "Show HTTP request/response details").action(async function() {
+    const opts = this.optsWithGlobals();
+    const client = await resolveClient(opts);
+    const result = await client.get("/fin-sdk/attributes");
+    const items = Array.isArray(result) ? result : result.attributes ?? [];
+    render(items, opts, () => {
+      if (items.length === 0) {
+        return "No attributes found.";
+      }
+      const rows = items.map((item) => ({
+        NAME: String(item.name ?? ""),
+        TYPE: String(item.type ?? ""),
+        DESCRIPTION: String(item.description ?? "")
+      }));
+      return table({ columns: ["NAME", "TYPE", "DESCRIPTION"], rows });
+    }, items);
+  });
+}
+
+// src/commands/fin/audiences.ts
+function registerAudiencesCommand(fin) {
+  const audiences = fin.command("audiences").description("Manage Fin SDK audiences");
+  audiences.command("list").description("List Fin SDK audiences").option("--json", "Output as JSON").option("--verbose", "Show HTTP request/response details").action(async function() {
+    const opts = this.optsWithGlobals();
+    const client = await resolveClient(opts);
+    const result = await client.get("/fin-sdk/audiences");
+    const items = Array.isArray(result) ? result : result.audiences ?? [];
+    render(items, opts, () => {
+      if (items.length === 0) {
+        return "No audiences found.";
+      }
+      const rows = items.map((item) => ({
+        ID: String(item.id ?? ""),
+        NAME: String(item.name ?? "")
+      }));
+      return table({ columns: ["ID", "NAME"], rows });
+    }, items);
+  });
+}
+
+// src/commands/fin/workflows.ts
+function registerWorkflowsCommand(fin) {
+  const workflows = fin.command("workflows").description("Manage Fin SDK workflows");
+  workflows.command("list").description("List Fin SDK workflows").option("--json", "Output as JSON").option("--verbose", "Show HTTP request/response details").action(async function() {
+    const opts = this.optsWithGlobals();
+    const client = await resolveClient(opts);
+    const result = await client.get("/fin-sdk/workflows");
+    const items = Array.isArray(result) ? result : result.workflows ?? [];
+    render(items, opts, () => {
+      if (items.length === 0) {
+        return "No workflows found.";
+      }
+      const rows = items.map((item) => ({
+        ID: String(item.id ?? ""),
+        TITLE: String(item.title ?? ""),
+        STATE: String(item.state ?? ""),
+        TRIGGER: String(item.trigger_type ?? "")
+      }));
+      return table({ columns: ["ID", "TITLE", "STATE", "TRIGGER"], rows });
+    }, items);
+  });
+  workflows.command("get <id>").description("Get a workflow by ID").option("--json", "Output as JSON").option("--verbose", "Show HTTP request/response details").action(async function(id) {
+    const opts = this.optsWithGlobals();
+    const client = await resolveClient(opts);
+    const result = await client.get(`/fin-sdk/workflows/${id}`);
+    const r = result;
+    render(
+      result,
+      opts,
+      () => detail({
+        "ID": String(r.id ?? ""),
+        "Title": String(r.title ?? ""),
+        "State": String(r.state ?? ""),
+        "Trigger": r.trigger_type != null ? String(r.trigger_type) : void 0
+      })
+    );
+  });
+}
+
+// src/commands/fin/simulations.ts
+function registerSimulationsCommand(fin) {
+  const simulations = fin.command("simulations").description("Manage Fin SDK simulations");
+  simulations.command("list <procedure_id>").description("List simulations for a procedure (displays YAML)").option("--verbose", "Show HTTP request/response details").action(async function(procedureId) {
+    const opts = this.optsWithGlobals();
+    const client = await resolveClient(opts);
+    const text = await client.getText(`/fin-sdk/procedures/${procedureId}/simulations`);
     console.log(text);
   });
+  simulations.command("run <procedure_id> [test_id]").description("Run one or all simulations for a procedure").option("--json", "Output as JSON").option("--verbose", "Show HTTP request/response details").action(async function(procedureId, testId) {
+    const opts = this.optsWithGlobals();
+    const client = await resolveClient(opts);
+    let result;
+    if (testId) {
+      result = await client.post(`/fin-sdk/procedures/${procedureId}/simulations/${testId}/run`, {});
+    } else {
+      result = await client.post(`/fin-sdk/procedures/${procedureId}/simulations/run`, {});
+    }
+    const r = result;
+    render(result, opts, () => {
+      if (r.enqueued && Array.isArray(r.enqueued) && r.enqueued.length > 0) {
+        const rows = r.enqueued.map((e) => ({
+          RUN_ID: String(e.run_id ?? ""),
+          TEST_ID: String(e.test_id ?? ""),
+          NAME: String(e.simulation_name ?? ""),
+          STATUS: String(e.status ?? "")
+        }));
+        return table({ columns: ["RUN_ID", "TEST_ID", "NAME", "STATUS"], rows });
+      } else {
+        const runId = r.run_id;
+        if (runId !== void 0) {
+          return `run_id: ${runId}`;
+        } else {
+          return detail({
+            "Procedure ID": String(r.procedure_id ?? "")
+          });
+        }
+      }
+    });
+  });
+  simulations.command("result <run_id>").description("Get the result of a simulation run").option("--json", "Output as JSON").option("--wait", "Poll until run completes").option("--verbose", "Show HTTP request/response details").action(async function(runId) {
+    const opts = this.optsWithGlobals();
+    const client = await resolveClient(opts);
+    let result = await client.get(`/fin-sdk/runs/${runId}`);
+    if (opts.wait) {
+      const deadline = Date.now() + SIMULATION_POLL_TIMEOUT_MS;
+      while (result.status === "pending" || result.status === "running") {
+        if (Date.now() > deadline) {
+          throw new TimeoutError(
+            `Simulation polling timed out after ${SIMULATION_POLL_TIMEOUT_MS / 1e3}s. Last status: ${result.status}. Run "intercom fin simulations result ${runId}" to check later.`
+          );
+        }
+        await new Promise((r) => setTimeout(r, 2e3));
+        result = await client.get(`/fin-sdk/runs/${runId}`);
+      }
+    }
+    render(
+      result,
+      opts,
+      () => detail({
+        "Run ID": String(result.run_id ?? ""),
+        "Status": String(result.status ?? "")
+      })
+    );
+  });
+  simulations.command("generate <procedure_id>").description("Generate simulations for a procedure").option("--json", "Output as JSON").option("--verbose", "Show HTTP request/response details").action(async function(procedureId) {
+    const opts = this.optsWithGlobals();
+    const client = await resolveClient(opts);
+    const result = await client.post(`/fin-sdk/procedures/${procedureId}/simulations/generate`, {});
+    const r = result;
+    render(
+      result,
+      opts,
+      () => detail({
+        "Status": String(r.status ?? ""),
+        "Procedure ID": String(r.procedure_id ?? "")
+      })
+    );
+  });
 }
 
 // src/auth/ember-session.ts
@@ -1901,7 +2450,7 @@ async function emberRequest(session, path, options = {}) {
 }
 function extractCookies2(response) {
   const setCookies = typeof response.headers.getSetCookie === "function" ? response.headers.getSetCookie() : (response.headers.get("set-cookie") ?? "").split(/,(?=[^ ])/).filter(Boolean);
-  return setCookies.map((c) => c.split(";")[0]).join("; ");
+  return setCookies.map((c2) => c2.split(";")[0]).join("; ");
 }
 function mergeCookies2(existing, newCookies) {
   const map = /* @__PURE__ */ new Map();
@@ -1922,8 +2471,8 @@ function registerFinEnableCommand(fin) {
   ).requiredOption("--email <email>", "Admin email address").option("--password-stdin", "Read password from stdin (or set INTERCOM_PASSWORD)").option("--verify-email-url <url>", "Email verification URL (if email not yet verified)").option("--verbose", "Show detailed output").action(async function() {
     const opts = this.optsWithGlobals();
     const password = await resolvePassword({ passwordStdin: opts.passwordStdin });
-    const configDir = process.env.INTERCOM_CONFIG_DIR;
-    const config = await readConfig(configDir);
+    const configDir2 = process.env.INTERCOM_CONFIG_DIR;
+    const config = await readConfig(configDir2);
     const appId = opts.workspace ?? config.default;
     if (!appId) {
       throw new CLIError(
@@ -2017,8 +2566,21 @@ function renderResourceTable(label, items) {
 ${table({ columns: ["ID", "NAME"], rows })}`;
 }
 function registerFinCommand(program) {
-  const fin = program.command("fin").description("Manage Fin SDK resources");
-  fin.command("manifest").description("Show the Fin SDK manifest for this workspace").option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").action(async function() {
+  const fin = program.command("fin").description("Manage Fin AI Agent and SDK resources").addHelpText(
+    "after",
+    `
+Examples:
+  intercom fin manifest
+  intercom fin enable --email admin@company.com
+  intercom fin guidance list`
+  );
+  fin.command("manifest").description("Show the Fin SDK manifest for this workspace").option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").addHelpText(
+    "after",
+    `
+Examples:
+  $ intercom fin manifest
+  $ intercom fin manifest --json`
+  ).action(async function() {
     const opts = this.optsWithGlobals();
     const client = await resolveClient(opts);
     const result = await client.get("/fin-sdk/manifest");
@@ -2043,12 +2605,26 @@ function registerFinCommand(program) {
     });
   });
   registerFinEnableCommand(fin);
+  registerProceduresCommand(fin);
+  registerDataConnectorsCommand(fin);
   registerGuidanceCommand(fin);
+  registerAttributesCommand(fin);
+  registerAudiencesCommand(fin);
+  registerWorkflowsCommand(fin);
+  registerSimulationsCommand(fin);
+  fin.command("download").description("Download Fin SDK resources as a ZIP file").option("-o, --output <path>", "Output file path", "./fin-resources.zip").option("--verbose", "Show HTTP request/response details").action(async function() {
+    const opts = this.optsWithGlobals();
+    const outputPath = opts.output ?? "./fin-resources.zip";
+    const client = await resolveClient(opts);
+    const buffer = await client.getBuffer("/fin-sdk/download");
+    await writeFile2(outputPath, buffer);
+    console.log(`Downloaded ${buffer.length} bytes to ${outputPath}`);
+  });
 }
 
 // src/commands/setup.ts
-import { readdirSync, readFileSync as readFileSync3, statSync } from "fs";
-import { join as join3, basename } from "path";
+import { readdirSync, readFileSync as readFileSync4, statSync } from "fs";
+import { join as join3, basename as basename2 } from "path";
 function isGreenfield(opts) {
   return !!(opts.email && opts.name && (process.env.INTERCOM_PASSWORD || opts.passwordStdin));
 }
@@ -2056,6 +2632,11 @@ function hasPartialGreenfieldFlags(opts) {
   const hasPassword = !!(process.env.INTERCOM_PASSWORD || opts.passwordStdin);
   return !!(opts.email && hasPassword && !opts.name);
 }
+async function hasExistingAuth() {
+  const configDir2 = process.env.INTERCOM_CONFIG_DIR;
+  const config = await readConfig(configDir2);
+  return !!config.default;
+}
 function buildPlan(opts) {
   const steps = [];
   let stepNum = 1;
@@ -2101,8 +2682,8 @@ function buildPlan(opts) {
     }
     if (mdFiles.length > 0) {
       const articleCommands = mdFiles.map((file) => {
-        const title = basename(file, ".md").replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
-        return `intercom articles create -f title="${title}" -F body=@${join3(opts.articlesFrom, file)}`;
+        const title = basename2(file, ".md").replace(/-/g, " ").replace(/\b\w/g, (c2) => c2.toUpperCase());
+        return `intercom articles create -f title="${title}" -F body=@${join3(opts.articlesFrom, file)} -f author_id=$(intercom me --json | jq -r .id)`;
       });
       steps.push({
         step: stepNum++,
@@ -2114,7 +2695,7 @@ function buildPlan(opts) {
         step: stepNum++,
         description: `Create articles from ${opts.articlesFrom}`,
         commands: [
-          `intercom articles create -f title="<article-title>" -F body=@${opts.articlesFrom}/<file>.md`
+          `intercom articles create -f title="<article-title>" -F body=@${opts.articlesFrom}/<file>.md -f author_id=$(intercom me --json | jq -r .id)`
         ]
       });
     }
@@ -2140,15 +2721,20 @@ function formatPlanText(steps) {
 }
 async function runPostAuthSteps(client, opts, results, appId) {
   results.push(`\u2713 Messenger configured`);
+  const me = await client.get("/me");
+  const authorId = me.id != null ? Number(me.id) : void 0;
   const helpCenterName = opts.companyName ? `${opts.companyName} Help` : "Help Center";
   const collections = await client.paginate("/help_center/collections");
   const existingCollection = collections.find(
-    (c) => String(c.name ?? "") === helpCenterName
+    (c2) => String(c2.name ?? "") === helpCenterName
   );
+  let collectionId;
   if (existingCollection) {
+    collectionId = String(existingCollection.id);
     results.push(`\u2713 Help center already exists (${helpCenterName})`);
   } else {
-    await client.post("/help_center/collections", { name: helpCenterName });
+    const created = await client.post("/help_center/collections", { name: helpCenterName });
+    collectionId = created.id != null ? String(created.id) : void 0;
     results.push(`\u2713 Help center created (${helpCenterName})`);
   }
   if (opts.articlesFrom) {
@@ -2163,12 +2749,18 @@ async function runPostAuthSteps(client, opts, results, appId) {
     let created = 0;
     let skipped = 0;
     for (const file of mdFiles) {
-      const title = basename(file, ".md").replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
-      const body = readFileSync3(join3(opts.articlesFrom, file), "utf-8");
+      const title = basename2(file, ".md").replace(/-/g, " ").replace(/\b\w/g, (c2) => c2.toUpperCase());
+      const body = readFileSync4(join3(opts.articlesFrom, file), "utf-8");
       if (existingTitles.has(title)) {
         skipped++;
       } else {
-        await client.post("/articles", { title, body, state: "published" });
+        const articleBody = { title, body, state: "published" };
+        if (authorId != null) articleBody.author_id = authorId;
+        if (collectionId != null) {
+          articleBody.parent_id = collectionId;
+          articleBody.parent_type = "collection";
+        }
+        await client.post("/articles", articleBody);
         created++;
       }
     }
@@ -2183,19 +2775,19 @@ async function runPostAuthSteps(client, opts, results, appId) {
   const articleCount = (await client.paginate("/articles")).length;
   if (articleCount === 0) {
     results.push(`\u26A0 No help center articles found!`);
-    console.log(results.join("\n"));
-    console.log("");
-    console.log("WARNING: Fin needs help center articles to answer questions.");
-    console.log("Without articles, Fin will have nothing to draw from and cannot help visitors.\n");
-    console.log("To add articles, either:");
-    console.log("  1. Re-run with: intercom setup --articles-from <directory-of-markdown-files>");
-    console.log('  2. Create articles manually: intercom articles create -f title="..." -f body="..." -F author_id=<id>');
-    console.log("");
-    console.log("Tip for AI agents: if no articles directory exists, consider creating one by");
-    console.log("  analyzing the project's source code, README, documentation, or any available");
-    console.log("  context about the product. Write markdown files covering key topics that");
-    console.log("  customers would ask about, then re-run setup with --articles-from.\n");
-    console.log("Skipping Fin enablement \u2014 enable Fin after adding articles with: intercom fin enable --email <email>");
+    console.error(results.join("\n"));
+    console.error("");
+    console.error("WARNING: Fin needs help center articles to answer questions.");
+    console.error("Without articles, Fin will have nothing to draw from and cannot help visitors.\n");
+    console.error("To add articles, either:");
+    console.error("  1. Re-run with: intercom setup --articles-from <directory-of-markdown-files>");
+    console.error('  2. Create articles manually: intercom articles create -f title="..." -f body="..." -F author_id=<id>');
+    console.error("");
+    console.error("Tip for AI agents: if no articles directory exists, consider creating one by");
+    console.error("  analyzing the project's source code, README, documentation, or any available");
+    console.error("  context about the product. Write markdown files covering key topics that");
+    console.error("  customers would ask about, then re-run setup with --articles-from.\n");
+    console.error("Skipping Fin enablement \u2014 enable Fin after adding articles with: intercom fin enable --email <email>");
     return;
   }
   results.push(`\u2713 ${articleCount} article(s) in help center`);
@@ -2219,8 +2811,8 @@ async function runPostAuthSteps(client, opts, results, appId) {
         results.push(`\u2713 Fin already opted in`);
       } else {
         results.push(`\u26A0 Fin opt-in failed (${optIn.status}) \u2014 enable manually with: intercom fin enable --email <email>`);
-        console.log(results.join("\n"));
-        console.log("Setup complete (Fin requires manual enablement).");
+        console.error(results.join("\n"));
+        console.error("Setup complete (Fin requires manual enablement).");
         return;
       }
       const profile = await emberRequest(
@@ -2251,7 +2843,7 @@ async function runPostAuthSteps(client, opts, results, appId) {
     }
   } else if (opts.enableFin !== false) {
     results.push(`\u26A0 Fin not enabled (--email required for Fin activation)`);
-    console.log("  Tip: Re-run with --email to enable Fin, or use: intercom fin enable --email <email>");
+    console.error("  Tip: Re-run with --email to enable Fin, or use: intercom fin enable --email <email>");
   }
   try {
     const manifest = await client.get("/fin-sdk/manifest");
@@ -2266,11 +2858,25 @@ async function runPostAuthSteps(client, opts, results, appId) {
       throw err;
     }
   }
-  console.log(results.join("\n"));
-  console.log("Setup complete!");
+  console.error(results.join("\n"));
+  console.error("Setup complete!");
 }
 function registerSetupCommand(program) {
-  program.command("setup").description("Set up a complete Intercom installation").option("--company-name <name>", "Company name for Messenger branding").option("--articles-from <dir>", "Directory of markdown files to create as articles").option("--plan", "Output setup steps as CLI commands without executing").option("--dry-run", "Show what would happen without executing").option("--json", "Output as JSON (for --plan mode)").option("--verbose", "Show HTTP request/response details").option("--email <email>", "Admin email address (for new workspace signup)").option("--password-stdin", "Read password from stdin (or set INTERCOM_PASSWORD env var)").option("--name <name>", "Admin name (for new workspace signup)").option("--plan-tier <tier>", "Trial plan tier: essential, advanced, expert (default: advanced)").option("--enable-fin", "Enable Fin AI Agent (default: true for greenfield setup)", true).option("--no-enable-fin", "Skip Fin enablement").option("--verify-email-url <url>", "Email verification URL (needed for Fin on fresh workspaces)").action(async function() {
+  program.command("setup").description("Set up a complete Intercom installation").addHelpText(
+    "after",
+    `
+Examples:
+  # Existing workspace (already authenticated)
+  intercom setup --company-name "Acme Inc" --articles-from ./docs
+
+  # New workspace (greenfield)
+  INTERCOM_PASSWORD=*** intercom setup --email admin@acme.com --name "Admin" --company-name "Acme Inc"
+
+  # Preview steps without executing
+  intercom setup --plan
+
+Flow: signup \u2192 auth \u2192 messenger \u2192 help center \u2192 articles \u2192 fin`
+  ).option("--company-name <name>", "Company name for Messenger branding").option("--articles-from <dir>", "Directory of markdown files to create as articles").option("--plan", "Output setup steps as CLI commands without executing").option("--dry-run", "Show what would happen without executing").option("--json", "Output as JSON (for --plan mode)").option("--verbose", "Show HTTP request/response details").option("--email <email>", "Admin email address (for new workspace signup)").option("--password-stdin", "Read password from stdin (or set INTERCOM_PASSWORD env var)").option("--name <name>", "Admin name (for new workspace signup)").option("--plan-tier <tier>", "Trial plan tier: essential, advanced, expert (default: advanced)").option("--enable-fin", "Enable Fin AI Agent (default: true for greenfield setup)", true).option("--no-enable-fin", "Skip Fin enablement").option("--verify-email-url <url>", "Email verification URL (needed for Fin on fresh workspaces)").action(async function() {
     const opts = this.optsWithGlobals();
     if (hasPartialGreenfieldFlags(opts)) {
       throw new CLIError(
@@ -2321,7 +2927,8 @@ function registerSetupCommand(program) {
       return;
     }
     const results = [];
-    if (isGreenfield(opts)) {
+    const alreadyAuthed = await hasExistingAuth();
+    if (isGreenfield(opts) && !alreadyAuthed) {
       const password = await resolvePassword({ passwordStdin: opts.passwordStdin });
       const baseUrl = getAppBaseUrl();
       const planTier = opts.planTier ?? "advanced";
@@ -2335,6 +2942,13 @@ function registerSetupCommand(program) {
         plan: planTier
       });
       results.push(`\u2713 Workspace created: ${workspace.name} (${workspace.id})`);
+      if (opts.verifyEmailUrl) {
+        try {
+          await fetchWithTimeout(opts.verifyEmailUrl, { redirect: "manual" }, { timeoutMs: API_TIMEOUT_MS });
+          results.push(`\u2713 Email verified`);
+        } catch {
+        }
+      }
       let token;
       try {
         const result = await getToken({
@@ -2349,9 +2963,17 @@ function registerSetupCommand(program) {
         console.error(`\u2713 Workspace created: ${workspace.name} (${workspace.id})`);
         console.error(`
 Authentication failed after workspace creation: ${message}`);
-        console.error(`
+        if (message.includes("403")) {
+          console.error(`
+This is likely because the email has not been verified.`);
+          console.error(`Verify your email first, then bootstrap:`);
+          console.error(`  intercom auth verify-email --url <url-from-verification-email>`);
+        } else {
+          console.error(`
 Your workspace exists but credentials were not saved.`);
-        console.error(`To complete setup, run:
+        }
+        console.error(`
+To complete setup, run:
 `);
         console.error(`  INTERCOM_PASSWORD=*** intercom auth bootstrap --email ${opts.email} --app-id ${workspace.id}`);
         console.error(`
@@ -2364,10 +2986,10 @@ Then re-run setup without signup flags:
         );
       }
       results.push(`\u2713 Authentication token obtained`);
-      const configDir = process.env.INTERCOM_CONFIG_DIR;
-      const store = new CredentialStore(createDefaultBackend(configDir));
+      const configDir2 = process.env.INTERCOM_CONFIG_DIR;
+      const store = new CredentialStore(createDefaultBackend(configDir2));
       await store.set(workspace.id, { token, auth_type: "oauth", app_id: workspace.id });
-      await addWorkspace(configDir, { app_id: workspace.id, name: workspace.name });
+      await addWorkspace(configDir2, { app_id: workspace.id, name: workspace.name });
       const client2 = new IntercomClient({
         token,
         authType: "oauth",
@@ -2385,20 +3007,350 @@ Then re-run setup without signup flags:
   });
 }
 
+// src/commands/completion.ts
+function binName() {
+  const argv1 = process.argv[1] ?? "";
+  if (argv1.endsWith("/fin") || argv1.endsWith("\\fin")) return "fin";
+  return "intercom";
+}
+var COMMANDS = {
+  api: [],
+  auth: ["login", "logout", "status", "bootstrap", "signup", "verify-email"],
+  me: [],
+  articles: ["list", "get", "create", "update", "delete"],
+  contacts: ["list", "get", "create", "update", "delete"],
+  conversations: ["list", "get", "reply"],
+  "help-center": ["list", "get", "create"],
+  messenger: ["get", "update", "snippet"],
+  fin: ["manifest", "enable", "guidance"],
+  setup: [],
+  pricing: [],
+  completion: ["bash", "zsh", "fish"]
+};
+var GLOBAL_FLAGS = [
+  "--json",
+  "--jq",
+  "--workspace",
+  "--verbose",
+  "--no-retry",
+  "--timeout",
+  "--agent",
+  "--human",
+  "--help",
+  "--version"
+];
+function bashScript(name = binName()) {
+  const commandNames = Object.keys(COMMANDS).join(" ");
+  const fnName = `_${name}`;
+  const subcommandCases = Object.entries(COMMANDS).filter(([, subs]) => subs.length > 0).map(([cmd, subs]) => `      ${cmd}) COMPREPLY=( $(compgen -W "${subs.join(" ")}" -- "$cur") ) ;;`).join("\n");
+  return `# bash completion for ${name} CLI
+# Add to ~/.bashrc: eval "$(${name} completion bash)"
+
+${fnName}() {
+  local cur prev commands
+  COMPREPLY=()
+  cur="\${COMP_WORDS[COMP_CWORD]}"
+  prev="\${COMP_WORDS[COMP_CWORD-1]}"
+  commands="${commandNames}"
+
+  if [[ "$cur" == -* ]]; then
+    COMPREPLY=( $(compgen -W "${GLOBAL_FLAGS.join(" ")}" -- "$cur") )
+    return 0
+  fi
+
+  case "\${COMP_WORDS[1]}" in
+${subcommandCases}
+    *)
+      if [[ \${COMP_CWORD} -eq 1 ]]; then
+        COMPREPLY=( $(compgen -W "$commands" -- "$cur") )
+      fi
+      ;;
+  esac
+  return 0
+}
+
+complete -F ${fnName} ${name}
+`;
+}
+function zshScript(name = binName()) {
+  const fnName = `_${name}`;
+  const commandDescs = [
+    "api:'Make an authenticated API request'",
+    "auth:'Manage authentication credentials'",
+    "me:'Show current admin and workspace info'",
+    "articles:'Manage help center articles'",
+    "contacts:'Manage contacts'",
+    "conversations:'Manage conversations'",
+    "help-center:'Manage help center collections'",
+    "messenger:'Manage Messenger settings'",
+    "fin:'Manage Fin AI Agent'",
+    "setup:'Set up a complete Intercom installation'",
+    "pricing:'Show current Intercom pricing information'",
+    "completion:'Generate shell completion scripts'"
+  ];
+  const subcommandFunctions = Object.entries(COMMANDS).filter(([, subs]) => subs.length > 0).map(([cmd, subs]) => {
+    const subFnName = cmd.replace(/-/g, "_");
+    const subLines = subs.map((s) => `'${s}'`).join(" ");
+    return `${fnName}_${subFnName}() {
+  local -a subcommands
+  subcommands=(${subLines})
+  _describe 'subcommand' subcommands
+}`;
+  }).join("\n\n");
+  return `#compdef ${name}
+# zsh completion for ${name} CLI
+# Add to ~/.zshrc: eval "$(${name} completion zsh)"
+
+${fnName}() {
+  local -a commands global_flags
+  commands=(
+    ${commandDescs.join("\n    ")}
+  )
+  global_flags=(
+    ${GLOBAL_FLAGS.map((f) => `'${f}'`).join("\n    ")}
+  )
+
+  _arguments -C \\
+    '1:command:->command' \\
+    '*::arg:->args'
+
+  case $state in
+    command)
+      _describe 'command' commands
+      ;;
+    args)
+      case $words[1] in
+${Object.entries(COMMANDS).filter(([, subs]) => subs.length > 0).map(([cmd]) => `        ${cmd}) ${fnName}_${cmd.replace(/-/g, "_")} ;;`).join("\n")}
+      esac
+      ;;
+  esac
+}
+
+${subcommandFunctions}
+
+${fnName} "$@"
+`;
+}
+function fishScript(name = binName()) {
+  const lines = [
+    `# fish completion for ${name} CLI`,
+    `# Add to fish config: ${name} completion fish | source`,
+    "",
+    "# Disable file completions",
+    `complete -c ${name} -f`,
+    "",
+    "# Top-level commands"
+  ];
+  const commandDescs = {
+    api: "Make an authenticated API request",
+    auth: "Manage authentication credentials",
+    me: "Show current admin and workspace info",
+    articles: "Manage help center articles",
+    contacts: "Manage contacts",
+    conversations: "Manage conversations",
+    "help-center": "Manage help center collections",
+    messenger: "Manage Messenger settings",
+    fin: "Manage Fin AI Agent",
+    setup: "Set up a complete Intercom installation",
+    pricing: "Show current Intercom pricing information",
+    completion: "Generate shell completion scripts"
+  };
+  for (const [cmd, desc] of Object.entries(commandDescs)) {
+    lines.push(
+      `complete -c ${name} -n '__fish_use_subcommand' -a '${cmd}' -d '${desc}'`
+    );
+  }
+  lines.push("");
+  lines.push("# Subcommands");
+  for (const [cmd, subs] of Object.entries(COMMANDS)) {
+    for (const sub of subs) {
+      lines.push(
+        `complete -c ${name} -n '__fish_seen_subcommand_from ${cmd}' -a '${sub}'`
+      );
+    }
+  }
+  lines.push("");
+  lines.push("# Global flags");
+  for (const flag of GLOBAL_FLAGS) {
+    lines.push(`complete -c ${name} -l '${flag.replace(/^--/, "")}'`);
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+function registerCompletionCommand(program) {
+  const name = binName();
+  const completion = program.command("completion").description("Generate shell completion scripts").addHelpText(
+    "after",
+    `
+Examples:
+  # Bash (add to ~/.bashrc)
+  eval "$(${name} completion bash)"
+
+  # Zsh (add to ~/.zshrc)
+  eval "$(${name} completion zsh)"
+
+  # Fish (add to fish config)
+  ${name} completion fish | source`
+  );
+  completion.command("bash").description("Generate bash completion script").action(() => {
+    console.log(bashScript());
+  });
+  completion.command("zsh").description("Generate zsh completion script").action(() => {
+    console.log(zshScript());
+  });
+  completion.command("fish").description("Generate fish completion script").action(() => {
+    console.log(fishScript());
+  });
+}
+
+// src/commands/pricing.ts
+var PRICING_URL = "https://www.intercom.com/pricing.md";
+function registerPricingCommand(program) {
+  program.command("pricing").description("Show current Intercom pricing information").option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").action(async function() {
+    const opts = this.optsWithGlobals();
+    const response = await fetchWithTimeout(
+      PRICING_URL,
+      { headers: { Accept: "text/markdown, text/plain, */*" } },
+      { timeoutMs: API_TIMEOUT_MS, verbose: opts.verbose }
+    );
+    if (!response.ok) {
+      throw new CLIError(`Failed to fetch pricing: ${response.status} ${response.statusText}`);
+    }
+    const markdown = await response.text();
+    if (opts.json) {
+      const { formatJson: formatJson2 } = await import("./json-MMBOB7YU.js");
+      console.log(formatJson2({ url: PRICING_URL, content: markdown }));
+    } else {
+      console.log(markdown);
+    }
+  });
+}
+
+// src/commands/config.ts
+import { join as join4 } from "path";
+var SUPPORTED_KEYS = ["default_workspace", "timeout"];
+function configDir() {
+  return process.env.INTERCOM_CONFIG_DIR ?? defaultConfigDir();
+}
+function validateKey(key) {
+  if (!SUPPORTED_KEYS.includes(key)) {
+    throw new CLIError(
+      `Unknown config key "${key}". Supported keys: ${SUPPORTED_KEYS.join(", ")}`
+    );
+  }
+  return key;
+}
+async function getValue(key) {
+  const config = await readConfig(configDir());
+  switch (key) {
+    case "default_workspace":
+      return config.default;
+    case "timeout":
+      return config.timeout !== void 0 ? String(config.timeout) : void 0;
+  }
+}
+function resolveSource(key) {
+  switch (key) {
+    case "default_workspace":
+      return process.env.INTERCOM_WORKSPACE ? "INTERCOM_WORKSPACE" : "config";
+    case "timeout":
+      return "config";
+  }
+}
+async function setValue(key, value) {
+  const dir = configDir();
+  const config = await readConfig(dir);
+  switch (key) {
+    case "default_workspace":
+      config.default = value;
+      break;
+    case "timeout": {
+      const n = parseInt(value, 10);
+      if (isNaN(n) || n <= 0) {
+        throw new CLIError("timeout must be a positive integer (seconds)");
+      }
+      config.timeout = n;
+      break;
+    }
+  }
+  await writeConfig(config, dir);
+}
+function registerConfigCommand(program) {
+  const cmd = program.command("config").description("Manage CLI configuration");
+  cmd.command("list").description("List all configuration settings").option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").action(async function() {
+    const opts = this.optsWithGlobals();
+    const config = await readConfig(configDir());
+    const entries = {};
+    for (const key of SUPPORTED_KEYS) {
+      const val = await getValue(key);
+      entries[key] = {
+        value: val ?? "",
+        source: val !== void 0 ? resolveSource(key) : ""
+      };
+    }
+    render(
+      entries,
+      opts,
+      () => table({
+        columns: ["KEY", "VALUE", "SOURCE"],
+        rows: SUPPORTED_KEYS.map((key) => ({
+          KEY: key,
+          VALUE: entries[key].value,
+          SOURCE: entries[key].source
+        }))
+      })
+    );
+  });
+  cmd.command("get <key>").description("Get a configuration value").option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output with jq expression").action(async function(key) {
+    const opts = this.optsWithGlobals();
+    const validKey = validateKey(key);
+    const value = await getValue(validKey);
+    if (value === void 0) {
+      throw new CLIError(`Key "${key}" is not set`);
+    }
+    render({ key, value }, opts, () => value);
+  });
+  cmd.command("set <key> <value>").description("Set a configuration value").action(async function(key, value) {
+    const validKey = validateKey(key);
+    await setValue(validKey, value);
+    console.log(`Set ${key} = ${value}`);
+  });
+  cmd.command("path").description("Show configuration file path").action(async function() {
+    console.log(join4(configDir(), "config.json"));
+  });
+}
+
 // src/index.ts
+function detectBinaryName() {
+  const argv1 = process.argv[1] ?? "";
+  if (argv1.endsWith("/fin") || argv1.endsWith("\\fin")) return "fin";
+  return "intercom";
+}
 function fullCommandName(cmd) {
   const parts = [];
+  const rootNames = /* @__PURE__ */ new Set(["intercom", "fin"]);
   let current = cmd;
   while (current) {
     const name = current.name();
-    if (name && name !== "intercom") parts.unshift(name);
+    if (name && !rootNames.has(name)) parts.unshift(name);
     current = current.parent;
   }
   return parts.join(" ");
 }
 function createProgram() {
   const program = new Command();
-  program.name("intercom").description("CLI tool for managing Intercom workspaces").version(VERSION).option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output").option("--workspace <id>", "Override default workspace").option("--verbose", "Show HTTP request/response details").option("--no-retry", "Disable automatic rate limit retry").option("--timeout <seconds>", "Request timeout in seconds");
+  const binName2 = detectBinaryName();
+  program.name(binName2).description("CLI tool for managing Intercom workspaces").version(VERSION).option("--json", "Output as JSON").option("--jq <expr>", "Filter JSON output").option("--workspace <id>", "Override default workspace").option("--verbose", "Show HTTP request/response details").option("--no-retry", "Disable automatic rate limit retry").option("--timeout <seconds>", "Request timeout in seconds").option("--agent", "Force machine-readable output (JSON/NDJSON)").option("--human", "Force human-readable output even when piped").option("--wide", "Show all columns with wider truncation").addHelpText(
+    "after",
+    `
+Quick start:
+  $ intercom auth login --token <your-api-token>
+  $ intercom me
+  $ intercom articles list --json
+  $ intercom setup --company-name "Acme" --articles-from ./docs
+
+Environment: Set INTERCOM_TOKEN to skip login entirely.`
+  );
   registerApiCommand(program);
   registerAuthCommand(program);
   registerMeCommand(program);
@@ -2409,13 +3361,20 @@ function createProgram() {
   registerMessengerCommand(program);
   registerFinCommand(program);
   registerSetupCommand(program);
-  program.hook("preAction", (_, actionCommand) => {
+  registerPricingCommand(program);
+  registerCompletionCommand(program);
+  registerConfigCommand(program);
+  program.hook("preAction", (thisCommand, actionCommand) => {
+    const rootOpts = thisCommand.opts();
+    if (rootOpts.agent && rootOpts.human) {
+      throw new CLIError("--agent and --human are mutually exclusive");
+    }
     setCliCommand(fullCommandName(actionCommand));
   });
   return program;
 }
 function handleError(err) {
-  const isJson = process.argv.includes("--json");
+  const isJson = process.argv.includes("--json") || process.argv.includes("--agent");
   if (err instanceof CLIError) {
     if (isJson) {
       console.error(formatJson({
@@ -2433,7 +3392,7 @@ function handleError(err) {
   console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
   process.exit(1);
 }
-var isMainModule = process.argv[1]?.endsWith("index.js") || process.argv[1]?.endsWith("intercom");
+var isMainModule = process.argv[1]?.endsWith("index.js") || process.argv[1]?.endsWith("intercom") || process.argv[1]?.endsWith("fin");
 if (isMainModule) {
   const program = createProgram();
   try {