@intercom/cli 0.4.0 → 0.6.0

package/dist/index.js

@@ -714,6 +714,14 @@ Examples:
   });
 }
 
+// src/utils/claude-code-hint.ts
+var HINT_LINE = '<claude-code-hint v="1" type="plugin" value="intercom@claude-plugins-official" />';
+function emitClaudeCodeHint() {
+  if (!process.env.CLAUDECODE) return;
+  process.stderr.write(`${HINT_LINE}
+`);
+}
+
 // 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)").addHelpText(
@@ -752,6 +760,7 @@ async function loginWithToken(token) {
   await store.set(appId, { token, auth_type: authType, app_id: appId });
   await addWorkspace(configDir2, { app_id: appId, name });
   console.log(`Authenticated to ${name} (${appId})`);
+  emitClaudeCodeHint();
 }
 
 // src/auth/cookies.ts
@@ -1015,7 +1024,12 @@ async function fetchAccessToken(baseUrl, cookies, appPackageId, appId, timeoutMs
 }
 async function getToken(options) {
   const { baseUrl, email, password, appId, appPackageId, timeoutMs } = options;
-  const cookies = await deviseSignIn(baseUrl, email, password, timeoutMs);
+  let cookies = await deviseSignIn(baseUrl, email, password, timeoutMs);
+  const appResponse = await fetchWithTimeout(`${baseUrl}/a/apps/${appId}`, {
+    headers: { Cookie: cookies }
+  }, { timeoutMs: timeoutMs ?? API_TIMEOUT_MS });
+  const appCookies = extractCookies(appResponse);
+  if (appCookies) cookies = mergeCookies(cookies, appCookies);
   const appPackage = await findOrCreateAppPackage(
     baseUrl,
     cookies,
@@ -1796,6 +1810,38 @@ Examples:
 }
 
 // src/commands/conversations.ts
+var BLOCKED_FIELDS = [
+  "topics",
+  "ai_topics",
+  "monitor_evaluations",
+  "scorecards"
+];
+var BLOCKED_CUSTOM_ATTRIBUTE_KEYS = [
+  "AI Topic",
+  "AI Subtopic",
+  "AI Topic and Subtopic",
+  "AI Issue summary",
+  "Query Type",
+  "CX Score rating",
+  "CX Score explanation",
+  "CX Score reasons",
+  "Review status",
+  "Reviewer"
+];
+function sanitizeConversation(conversation) {
+  const sanitized = { ...conversation };
+  for (const field of BLOCKED_FIELDS) {
+    delete sanitized[field];
+  }
+  if (sanitized.custom_attributes && typeof sanitized.custom_attributes === "object") {
+    const filtered = { ...sanitized.custom_attributes };
+    for (const key of BLOCKED_CUSTOM_ATTRIBUTE_KEYS) {
+      delete filtered[key];
+    }
+    sanitized.custom_attributes = filtered;
+  }
+  return sanitized;
+}
 function formatDatetime(ts) {
   if (!ts) return "";
   const n = typeof ts === "number" ? ts : Number(ts);
@@ -1893,9 +1939,10 @@ Examples:
       result = await client.get("/conversations", { per_page: limit });
     }
     const response = result;
-    const items = response.conversations ?? [];
+    const items = (response.conversations ?? []).map(sanitizeConversation);
+    const sanitizedResult = { ...response, conversations: items };
     render(
-      result,
+      sanitizedResult,
       opts,
       () => {
         const rows = items.map((c2) => ({
@@ -1916,10 +1963,11 @@ Examples:
   conversations.command("get <id>").description("Get a conversation 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(`/conversations/${id}`);
+    const result = sanitizeConversation(
+      await client.get(`/conversations/${id}`)
+    );
     render(result, opts, () => {
-      const r = result;
-      return renderConversationStream(r);
+      return renderConversationStream(result);
     });
   });
   conversations.command("reply <id>").description("Reply to a conversation").option(
@@ -1969,9 +2017,10 @@ Required fields: body, type (admin or user). Also: admin_id, message_type.`
     };
     const result = await client.post("/conversations/search", body);
     const response = result;
-    const items = response.conversations ?? [];
+    const items = (response.conversations ?? []).map(sanitizeConversation);
+    const sanitizedResult = { ...response, conversations: items };
     render(
-      result,
+      sanitizedResult,
       opts,
       () => {
         const rows = items.map((c2) => ({
@@ -2395,7 +2444,7 @@ Examples:
 }
 
 // src/commands/fin.ts
-import { writeFile as writeFile2 } from "fs/promises";
+import { writeFile as writeFile3 } from "fs/promises";
 
 // src/commands/fin/procedures.ts
 import { readFile as readFile2 } from "fs/promises";
@@ -2604,6 +2653,11 @@ function registerAudiencesCommand(fin) {
 }
 
 // src/commands/fin/workflows.ts
+import { readFile as readFile3 } from "fs/promises";
+import { basename as basename2 } from "path";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+var STATE_LIVE = 1;
+var STATE_PAUSED = 2;
 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() {
@@ -2624,19 +2678,122 @@ function registerWorkflowsCommand(fin) {
       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) {
+  workflows.command("get <id>").description("Get a workflow 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/workflows/${id}`);
-    const r = result;
+    const text = await client.getText(`/fin-sdk/workflows/${id}`);
+    const parsed = parseYaml(text);
+    render(
+      parsed,
+      opts,
+      () => detail({
+        "ID": String(parsed.id ?? ""),
+        "Title": String(parsed.title ?? ""),
+        "State": String(parsed.state ?? ""),
+        "Version": parsed.version != null ? String(parsed.version) : void 0,
+        "Trigger": parsed.trigger_type != null ? String(parsed.trigger_type) : void 0
+      })
+    );
+  });
+  workflows.command("upload <file>").description('Upload a workflow YAML file (creates if id is "new", updates if numeric)').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 workflows upload ./welcome.yaml
+  $ intercom fin workflows get wf-42 > local.yaml; vim local.yaml; intercom fin workflows upload local.yaml
+  $ intercom fin workflows upload ./new.yaml --json | jq .visual_builder_url
+
+The YAML file's id field determines whether this creates or updates:
+  id: "new"   \u2192 creates a new workflow
+  id: <int>   \u2192 updates the existing workflow with that id`
+  ).action(async function(filePath) {
+    const opts = this.optsWithGlobals();
+    const client = await resolveClient(opts);
+    const fileContent = await readFile3(filePath);
+    const formData = new FormData();
+    const blob = new Blob([fileContent], { type: "application/x-yaml" });
+    formData.append("file_data", blob, basename2(filePath));
+    const result = await client.postFormData("/fin-sdk/upload", formData);
     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
+        "ID": String(result.id ?? ""),
+        "Type": result.type != null ? String(result.type) : void 0,
+        "Message": result.message != null ? String(result.message) : void 0,
+        "Visual Builder URL": result.visual_builder_url != null ? String(result.visual_builder_url) : void 0
+      })
+    );
+  });
+  workflows.command("enable <id>").description("Set a workflow's state to live").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 workflows enable 42
+  $ intercom fin workflows enable 42 --json
+
+This is a convenience for GET \u2192 set state \u2192 POST. If another operator
+edits the workflow between the GET and POST, those edits will be
+overwritten (the server does not expose a concurrency token).`
+  ).action(async function(id) {
+    const opts = this.optsWithGlobals();
+    const client = await resolveClient(opts);
+    const text = await client.getText(`/fin-sdk/workflows/${id}`);
+    let parsed;
+    try {
+      parsed = parseYaml(text);
+    } catch (err) {
+      throw new Error(`server returned unparseable YAML for workflow ${id}: ${err.message}`);
+    }
+    parsed.state = STATE_LIVE;
+    const yamlBody = stringifyYaml(parsed);
+    const formData = new FormData();
+    const blob = new Blob([yamlBody], { type: "application/x-yaml" });
+    formData.append("file_data", blob, `workflow-${id}.yaml`);
+    const result = await client.postFormData("/fin-sdk/upload", formData);
+    render(
+      result,
+      opts,
+      () => detail({
+        "ID": String(result.id ?? ""),
+        "Type": result.type != null ? String(result.type) : void 0,
+        "Message": result.message != null ? String(result.message) : void 0
+      })
+    );
+  });
+  workflows.command("disable <id>").description("Set a workflow's state to paused").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 workflows disable 42
+  $ intercom fin workflows disable 42 --json
+
+This is a convenience for GET \u2192 set state \u2192 POST. If another operator
+edits the workflow between the GET and POST, those edits will be
+overwritten (the server does not expose a concurrency token).`
+  ).action(async function(id) {
+    const opts = this.optsWithGlobals();
+    const client = await resolveClient(opts);
+    const text = await client.getText(`/fin-sdk/workflows/${id}`);
+    let parsed;
+    try {
+      parsed = parseYaml(text);
+    } catch (err) {
+      throw new Error(`server returned unparseable YAML for workflow ${id}: ${err.message}`);
+    }
+    parsed.state = STATE_PAUSED;
+    const yamlBody = stringifyYaml(parsed);
+    const formData = new FormData();
+    const blob = new Blob([yamlBody], { type: "application/x-yaml" });
+    formData.append("file_data", blob, `workflow-${id}.yaml`);
+    const result = await client.postFormData("/fin-sdk/upload", formData);
+    render(
+      result,
+      opts,
+      () => detail({
+        "ID": String(result.id ?? ""),
+        "Type": result.type != null ? String(result.type) : void 0,
+        "Message": result.message != null ? String(result.message) : void 0
       })
     );
   });
@@ -2879,6 +3036,275 @@ Fin is live on workspace ${appId}`);
   });
 }
 
+// src/commands/fin/monitors.ts
+import { mkdir as mkdir2, writeFile as writeFile2 } from "fs/promises";
+import { join as join3, relative, dirname } from "path";
+import { stringify } from "yaml";
+async function resolveMonitorId(client, nameOrId) {
+  if (/^\d+$/.test(nameOrId)) {
+    return parseInt(nameOrId, 10);
+  }
+  const monitors = await client.get("/fin-sdk/qa/monitors");
+  const exact = monitors.find((m) => m.name === nameOrId);
+  if (exact) return parseInt(exact.id, 10);
+  const lower = nameOrId.toLowerCase();
+  const fuzzy = monitors.find((m) => m.name.toLowerCase().includes(lower));
+  if (fuzzy) return parseInt(fuzzy.id, 10);
+  throw new CLIError(
+    `Monitor not found: "${nameOrId}". Check the name or use the numeric ID.`
+  );
+}
+function buildWorkingSetYaml(result, since) {
+  const header = [
+    `# Generated by: fin monitor pull-flagged "${result.monitor_name}" --since ${since}`,
+    `# Generated at: ${(/* @__PURE__ */ new Date()).toISOString()}`,
+    `# Monitor: ${result.monitor_name} (ID: ${result.monitor_id})`,
+    `# Showing: ${result.conversations.length} of ${result.total_count} total flagged`,
+    "#",
+    "# Edit this file:",
+    "#   - Remove conversations you don't want to act on",
+    "#   - Set the action and message below",
+    "#   - Then run: fin conversation bulk-send --yes",
+    ""
+  ].join("\n");
+  const doc = {
+    action: "reply",
+    message: "Your message here \u2014 this will be sent to all conversations listed below.\n",
+    close_after_reply: false,
+    conversations: result.conversations.map((c2) => ({
+      id: c2.id,
+      flagged_at: c2.flagged_at,
+      reasoning: c2.reasoning || "No reasoning provided"
+    }))
+  };
+  return header + stringify(doc, { lineWidth: 120 });
+}
+function registerMonitorsCommand(fin) {
+  const monitor = fin.command("monitor").description("Manage Fin QA monitors");
+  monitor.command("pull-flagged <monitor>").description(
+    "Pull conversations flagged by a QA monitor into an editable working set file"
+  ).option(
+    "--since <period>",
+    "Time window to look back (e.g. 24h, 7d, 2w)",
+    "24h"
+  ).option("--limit <n>", "Maximum number of conversations to include", "50").option("--output <path>", "Output file path for the working set YAML").option(
+    "--json",
+    "Output flagged conversations as JSON instead of writing a file"
+  ).option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").addHelpText(
+    "after",
+    `
+Examples:
+  $ fin monitor pull-flagged "Compliance Violations" --since 7d
+  $ fin monitor pull-flagged 12345 --since 24h --limit 100
+  $ fin monitor pull-flagged "My Monitor" --json`
+  ).action(async function(monitorArg) {
+    const opts = this.optsWithGlobals();
+    const client = await resolveClient(opts);
+    const since = opts.since ?? "24h";
+    const limit = parseInt(opts.limit ?? "50", 10);
+    const monitorId = await resolveMonitorId(client, monitorArg);
+    const result = await client.get(
+      `/fin-sdk/qa/monitors/${monitorId}/flagged-conversations`,
+      { since, limit: String(limit) }
+    );
+    if (opts.json || opts.jq || !process.stdout.isTTY) {
+      render(result, opts, () => {
+        return `${result.conversations.length} conversations flagged by "${result.monitor_name}"`;
+      });
+      return;
+    }
+    if (result.conversations.length === 0) {
+      console.log(
+        `No conversations flagged by "${result.monitor_name}" in the last ${since}.`
+      );
+      return;
+    }
+    const outputPath = opts.output ?? join3(
+      process.cwd(),
+      "src",
+      "qa",
+      "bulk-actions",
+      "flagged-conversations.yaml"
+    );
+    await mkdir2(dirname(outputPath), { recursive: true });
+    await writeFile2(outputPath, buildWorkingSetYaml(result, since), "utf-8");
+    const relPath = relative(process.cwd(), outputPath);
+    console.log(
+      `Wrote ${result.conversations.length} conversations to ${relPath}`
+    );
+    console.log("");
+    console.log("Next steps:");
+    console.log(`  1. Edit ${relPath}`);
+    console.log("     - Remove conversations you don't want to act on");
+    console.log("     - Set action: reply, note, or close");
+    console.log("     - Write your message");
+    console.log("  2. Preview: fin conversation bulk-send --dry-run");
+    console.log("  3. Send:    fin conversation bulk-send --yes");
+  });
+}
+
+// src/commands/fin/conversation.ts
+import { readFile as readFile4 } from "fs/promises";
+import { join as join4 } from "path";
+import { parse } from "yaml";
+var PLACEHOLDER_MESSAGE = "Your message here \u2014 this will be sent to all conversations listed below.";
+function validateWorkingSet(ws) {
+  const errors = [];
+  if (!ws.action) {
+    errors.push('Missing "action" field. Must be: reply, note, close, tag, or run_procedure.');
+  } else if (!["reply", "note", "close", "tag", "run_procedure"].includes(ws.action)) {
+    errors.push(
+      `Invalid action "${ws.action}". Must be one of: reply, note, close, tag, run_procedure.`
+    );
+  }
+  if (ws.action === "reply" || ws.action === "note") {
+    if (!ws.message || ws.message.trim().startsWith(PLACEHOLDER_MESSAGE.slice(0, 20))) {
+      errors.push(
+        `Message is required for action "${ws.action}". Edit the message field.`
+      );
+    }
+  }
+  if (ws.action === "run_procedure" && !ws.procedure_id && !ws.procedure_name) {
+    errors.push("procedure_id or procedure_name is required for run_procedure actions.");
+  } else if (ws.action === "run_procedure" && ws.procedure_id && typeof ws.procedure_id !== "number") {
+    errors.push("procedure_id must be a number.");
+  }
+  if (ws.action === "tag" && !ws.tag_id && !ws.tag_name) {
+    errors.push("tag_id or tag_name is required for tag actions.");
+  } else if (ws.action === "tag" && ws.tag_id && typeof ws.tag_id !== "number") {
+    errors.push("tag_id must be a number.");
+  }
+  if (!ws.conversations || ws.conversations.length === 0) {
+    errors.push("conversations list is empty. Add at least one conversation.");
+  } else {
+    const invalid = ws.conversations.filter(
+      (c2) => typeof c2.id !== "number" || isNaN(c2.id)
+    );
+    if (invalid.length > 0) {
+      errors.push(
+        `${invalid.length} conversation(s) have invalid IDs. Each entry must have a numeric id.`
+      );
+    }
+  }
+  return errors;
+}
+function registerConversationCommand(fin) {
+  const conversation = fin.command("conversation").description("Manage conversations in bulk");
+  conversation.command("bulk-send").description(
+    "Send bulk actions (reply, note, close, tag, run_procedure) from a working set file"
+  ).option(
+    "--file <path>",
+    "Path to the working set YAML file",
+    join4(process.cwd(), "src", "qa", "bulk-actions", "flagged-conversations.yaml")
+  ).option("--dry-run", "Preview actions without sending").option("--yes", "Skip confirmation prompt (required in TTY mode)").option(
+    "--json",
+    "Output result as JSON"
+  ).option("--jq <expr>", "Filter JSON output with jq expression").option("--verbose", "Show HTTP request/response details").addHelpText(
+    "after",
+    `
+Examples:
+  $ fin conversation bulk-send --dry-run
+  $ fin conversation bulk-send --yes
+  $ fin conversation bulk-send --file ./my-working-set.yaml --yes
+  $ fin conversation bulk-send --json`
+  ).action(async function() {
+    const opts = this.optsWithGlobals();
+    const filePath = opts.file ?? join4(
+      process.cwd(),
+      "src",
+      "qa",
+      "bulk-actions",
+      "flagged-conversations.yaml"
+    );
+    let raw;
+    try {
+      raw = await readFile4(filePath, "utf-8");
+    } catch (err) {
+      const e = err;
+      if (e.code === "ENOENT") {
+        throw new CLIError(
+          `Working set file not found: ${filePath}
+Run "fin monitor pull-flagged <monitor>" to create one.`
+        );
+      }
+      throw new CLIError(`Failed to read working set file: ${e.message}`);
+    }
+    let ws;
+    try {
+      ws = parse(raw);
+    } catch (err) {
+      const e = err;
+      throw new CLIError(`Invalid YAML in working set file: ${e.message}`);
+    }
+    const errors = validateWorkingSet(ws);
+    if (errors.length > 0) {
+      throw new CLIError(
+        `Working set validation failed:
+${errors.map((e) => `  - ${e}`).join("\n")}`
+      );
+    }
+    const conversationIds = ws.conversations.map((c2) => c2.id);
+    const count = conversationIds.length;
+    if (opts.dryRun) {
+      const dryResult = {
+        dry_run: true,
+        action_type: ws.action,
+        conversation_count: count,
+        ...ws.message ? { message: ws.message } : {},
+        ...ws.close_after_reply ? { close_after_reply: true } : {},
+        ...ws.procedure_id ? { procedure_id: ws.procedure_id } : {},
+        ...ws.procedure_name ? { procedure_name: ws.procedure_name } : {},
+        ...ws.tag_id ? { tag_id: ws.tag_id } : {},
+        ...ws.tag_name ? { tag_name: ws.tag_name } : {}
+      };
+      render(dryResult, opts, () => {
+        const lines = [
+          `Dry run \u2014 no changes will be made.`,
+          `Action:        ${ws.action}`,
+          `Conversations: ${count}`
+        ];
+        if (ws.message) lines.push(`Message:       ${ws.message.trim()}`);
+        if (ws.close_after_reply) lines.push(`Close after:   yes`);
+        if (ws.procedure_id) lines.push(`Procedure ID:  ${ws.procedure_id}`);
+        if (ws.procedure_name) lines.push(`Procedure:     ${ws.procedure_name}`);
+        if (ws.tag_id) lines.push(`Tag ID:        ${ws.tag_id}`);
+        if (ws.tag_name) lines.push(`Tag:           ${ws.tag_name}`);
+        return lines.join("\n");
+      });
+      return;
+    }
+    if (process.stdout.isTTY && !opts.yes) {
+      console.log(
+        `About to send "${ws.action}" to ${count} conversation(s).`
+      );
+      if (ws.message) {
+        console.log(`Message: ${ws.message.trim()}`);
+      }
+      throw new CLIError(
+        `Add --yes to confirm, or use --dry-run to preview.`
+      );
+    }
+    const client = await resolveClient(opts);
+    const body = {
+      conversation_ids: conversationIds,
+      action_type: ws.action
+    };
+    if (ws.message) body.message = ws.message;
+    if (ws.close_after_reply != null) body.close_after_reply = ws.close_after_reply;
+    if (ws.procedure_id != null) body.procedure_id = ws.procedure_id;
+    if (ws.procedure_name != null) body.procedure_name = ws.procedure_name;
+    if (ws.tag_id != null) body.tag_id = ws.tag_id;
+    if (ws.tag_name != null) body.tag_name = ws.tag_name;
+    const result = await client.post(
+      "/fin-sdk/bulk-actions",
+      body
+    );
+    render(result, opts, () => {
+      return `Sent "${result.action_type}" to ${result.conversation_count} conversation(s). Status: ${result.status}`;
+    });
+  });
+}
+
 // src/commands/fin.ts
 function renderResourceTable(label, items) {
   if (items.length === 0) {
@@ -2939,19 +3365,21 @@ Examples:
   registerAudiencesCommand(fin);
   registerWorkflowsCommand(fin);
   registerSimulationsCommand(fin);
+  registerMonitorsCommand(fin);
+  registerConversationCommand(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);
+    await writeFile3(outputPath, buffer);
     console.log(`Downloaded ${buffer.length} bytes to ${outputPath}`);
   });
 }
 
 // src/commands/setup.ts
 import { readdirSync, readFileSync as readFileSync4, statSync } from "fs";
-import { join as join3, basename as basename2 } from "path";
+import { join as join5, basename as basename3 } from "path";
 function isGreenfield(opts) {
   return !!(opts.email && opts.name && (process.env.INTERCOM_PASSWORD || opts.passwordStdin));
 }
@@ -3009,8 +3437,8 @@ function buildPlan(opts) {
     }
     if (mdFiles.length > 0) {
       const articleCommands = mdFiles.map((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)`;
+        const title = basename3(file, ".md").replace(/-/g, " ").replace(/\b\w/g, (c2) => c2.toUpperCase());
+        return `intercom articles create -f title="${title}" -F body=@${join5(opts.articlesFrom, file)} -f author_id=$(intercom me --json | jq -r .id)`;
       });
       steps.push({
         step: stepNum++,
@@ -3076,8 +3504,8 @@ async function runPostAuthSteps(client, opts, results, appId) {
     let created = 0;
     let skipped = 0;
     for (const file of mdFiles) {
-      const title = basename2(file, ".md").replace(/-/g, " ").replace(/\b\w/g, (c2) => c2.toUpperCase());
-      const body = readFileSync4(join3(opts.articlesFrom, file), "utf-8");
+      const title = basename3(file, ".md").replace(/-/g, " ").replace(/\b\w/g, (c2) => c2.toUpperCase());
+      const body = readFileSync4(join5(opts.articlesFrom, file), "utf-8");
       if (existingTitles.has(title)) {
         skipped++;
       } else {
@@ -3554,7 +3982,7 @@ function registerPricingCommand(program) {
 }
 
 // src/commands/config.ts
-import { join as join4 } from "path";
+import { join as join6 } from "path";
 var SUPPORTED_KEYS = ["default_workspace", "timeout"];
 function configDir() {
   return process.env.INTERCOM_CONFIG_DIR ?? defaultConfigDir();
@@ -3643,7 +4071,7 @@ function registerConfigCommand(program) {
     console.log(`Set ${key} = ${value}`);
   });
   cmd.command("path").description("Show configuration file path").action(async function() {
-    console.log(join4(configDir(), "config.json"));
+    console.log(join6(configDir(), "config.json"));
   });
 }
 
@@ -3667,17 +4095,17 @@ function fullCommandName(cmd) {
 function createProgram() {
   const program = new Command();
   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("-n, --dry-run", "Print HTTP requests to stderr without executing them").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",
-    `
+  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("-n, --dry-run", "Print HTTP requests to stderr without executing them").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", () => {
+    emitClaudeCodeHint();
+    return `
 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.`
-  );
+Environment: Set INTERCOM_TOKEN to skip login entirely.`;
+  });
   registerApiCommand(program);
   registerAuthCommand(program);
   registerMeCommand(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intercom/cli",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "CLI tool for managing Intercom workspaces",
   "type": "module",
   "bin": {
@@ -28,7 +28,8 @@
     "adm-zip": "^0.5.16",
     "commander": "^14.0.3",
     "picocolors": "^1.1.1",
-    "turndown": "^7.2.2"
+    "turndown": "^7.2.2",
+    "yaml": "^2.8.3"
   },
   "devDependencies": {
     "@types/adm-zip": "^0.5.8",