@mangomagic/cli 0.1.11 → 0.1.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mangomagic/cli",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "MangoMagic CLI — sign in, manage episodes, and expose MangoMagic to MCP clients (Claude Desktop, Cursor).",
   "type": "module",
   "bin": {

package/src/chat/natural-language.mjs

@@ -2,13 +2,25 @@ import readline from "node:readline/promises";
 import { stdin as input, stdout as output } from "node:process";
 import { apiCall } from "../api.mjs";
 import { planWithKimi } from "../ai/kimi.mjs";
-import { ALL_MCP_TOOL_CATALOG } from "../tools/catalog.mjs";
 import { runCatalogTool } from "../tools/run.mjs";
 
 const GOLD = "\x1b[38;2;241;171;28m";
 const DIM = "\x1b[2m";
 const BOLD = "\x1b[1m";
 const RESET = "\x1b[0m";
+const CHAT_TOOL_NAMES = [
+  "create_talking_cards",
+  "list_episodes",
+  "search_episodes",
+  "get_episode",
+  "get_user_episodes",
+  "get_user_clips",
+  "get_user_leads",
+  "get_user_stats",
+  "get_upcoming_meetings",
+  "get_bookings",
+  "get_inbox",
+];
 
 function compact(s) {
   return String(s || "").trim().replace(/\s+/g, " ");
@@ -20,21 +32,66 @@ function localPlan(text) {
   if (!t) return { action: "answer", args: { text: "" } };
 
   if (/^(exit|quit|bye)$/i.test(t)) return { action: "exit", args: {} };
+  if (/^(hi|hey|hello|yo)\??$/i.test(t)) {
+    return {
+      action: "answer",
+      args: {
+        text: "Hey. I'm here in the terminal now. Ask for episodes, talking cards, tools, or MCP setup.",
+      },
+    };
+  }
+  if (t.includes("understand me")) {
+    return {
+      action: "answer",
+      args: {
+        text: "Yes. Type at the mango> prompt and I will route natural language to MangoMagic tools.",
+      },
+    };
+  }
   if (t.includes("brand doc") || t.includes("brand colour") || t.includes("brand color")) {
     return { action: "open_brand_doc", args: {} };
   }
   if (t.includes("talking card") || t.includes("carousel") || /\bcards?\b/.test(t)) {
     return { action: "create_talking_cards", args: { focus: raw, count: inferCount(raw) } };
   }
+  if (/\b(email|emails|inbox|messages?)\b/.test(t) && /\b(show|list|get|what|my|check)\b/.test(t)) {
+    return { action: "list_inbox", args: { limit: 5 } };
+  }
+  if (/\b(stats?|account|credits?|streak|level|usage)\b/.test(t) && /\b(show|get|what|my|how|check)\b/.test(t)) {
+    return { action: "account_stats", args: {} };
+  }
+  if (/\b(clips?|highlights?)\b/.test(t) && /\b(show|list|get|my|what)\b/.test(t)) {
+    return { action: "list_clips", args: { limit: 5 } };
+  }
+  if (/\b(guests?|leads?|contacts?)\b/.test(t) && /\b(analy[sz]e|qualify|score|best|priority|prioritise|prioritize)\b/.test(t)) {
+    return { action: "analyze_guests", args: { limit: 10 } };
+  }
+  if (/\b(guests?|leads?|contacts?)\b/.test(t) && /\b(show|list|get|my|what)\b/.test(t)) {
+    return { action: "list_leads", args: { limit: 8 } };
+  }
+  if (/\b(meetings?|recording sessions?|sessions?)\b/.test(t) && /\b(show|list|get|upcoming|my|what)\b/.test(t)) {
+    return { action: "list_meetings", args: { limit: 5 } };
+  }
+  if (/\b(bookings?|booking requests?)\b/.test(t) && /\b(show|list|get|my|what)\b/.test(t)) {
+    return { action: "list_bookings", args: { limit: 5 } };
+  }
   if (t.includes("mcp") && (t.includes("config") || t.includes("connect") || t.includes("claude") || t.includes("cursor") || t.includes("codex"))) {
     return { action: "mcp_config", args: {} };
   }
-  if (t.includes("tool") || t.includes("what can")) return { action: "show_tools", args: {} };
-  if (t.includes("latest episode") || t.includes("recent episode") || t === "episodes" || t.includes("list episodes")) {
-    return { action: "list_episodes", args: { limit: 5 } };
+  if (t.includes("tool") || t.includes("what can")) {
+    return { action: "show_tools", args: { all: /\b(all|every|full|complete)\b/.test(t) } };
   }
   const searchMatch = raw.match(/search(?: my)? episodes? (?:for|about)\s+(.+)/i);
   if (searchMatch?.[1]) return { action: "search_episodes", args: { query: searchMatch[1] } };
+  if (
+    t.includes("latest episode") ||
+    t.includes("recent episode") ||
+    t === "episodes" ||
+    t.includes("list episodes") ||
+    (/\bepisodes?\b/.test(t) && /\b(what|which|have|got|my|show)\b/.test(t))
+  ) {
+    return { action: "list_episodes", args: { limit: 5 } };
+  }
   const getMatch = raw.match(/(?:get|show|open)(?: episode)?\s+([a-z0-9][a-z0-9_-]{5,})/i);
   if (getMatch?.[1]) return { action: "get_episode", args: { episode: getMatch[1] } };
   if (t.includes("home") || t.includes("help")) return { action: "home", args: {} };
@@ -56,6 +113,28 @@ function asArray(data) {
   return [];
 }
 
+function items(data) {
+  if (Array.isArray(data?.items)) return data.items;
+  return asArray(data).map((row) => ({
+    id: row.id,
+    title: row.title || row.name || [row.first_name, row.last_name].filter(Boolean).join(" ") || row.subject || row.id,
+    subtitle: row.subtitle || row.company || row.participant_email || row.status || "",
+    link: row.link,
+    metadata: row.metadata || row,
+  }));
+}
+
+function formatDate(value) {
+  if (!value) return "";
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime())) return "";
+  return date.toLocaleDateString("en-AU", { month: "short", day: "numeric", year: "numeric" });
+}
+
+function plural(count, singular, pluralName = `${singular}s`) {
+  return `${count} ${count === 1 ? singular : pluralName}`;
+}
+
 function printEpisodeList(data) {
   const rows = asArray(data);
   if (!rows.length) {
@@ -69,6 +148,177 @@ function printEpisodeList(data) {
   }
 }
 
+function printInbox(data) {
+  const rows = asArray(data);
+  if (!rows.length) {
+    process.stdout.write("No MangoMagic inbox threads found.\n");
+    return;
+  }
+  const unread = rows.reduce((sum, row) => sum + Number(row.unread_count || 0), 0);
+  process.stdout.write(`${BOLD}MangoMagic inbox:${RESET} ${plural(rows.length, "thread")} shown${unread ? `, ${plural(unread, "unread message")}` : ""}.\n\n`);
+  for (const row of rows.slice(0, 8)) {
+    const sender = row.participant_name || row.participant_email || "Unknown sender";
+    const unreadText = Number(row.unread_count || 0) ? `${row.unread_count} unread` : "read";
+    const when = formatDate(row.last_message_at);
+    process.stdout.write(`  ${GOLD}${row.subject || "Untitled thread"}${RESET}\n`);
+    process.stdout.write(`  ${DIM}${sender} • ${unreadText}${when ? ` • ${when}` : ""}${RESET}\n`);
+  }
+  process.stdout.write(`\n${DIM}This is your MangoMagic inbox. Ask "show my stats" or "analyse my guests" for the next useful snapshot.${RESET}\n`);
+}
+
+function printStats(data) {
+  const stats = data?.data || data;
+  if (!stats || typeof stats !== "object") {
+    process.stdout.write("No account stats found.\n");
+    return;
+  }
+  process.stdout.write(`${BOLD}Account snapshot${RESET}\n`);
+  process.stdout.write(`  Level: ${GOLD}${stats.level ?? "?"}${RESET}${stats.xp_points != null ? ` (${stats.xp_points} XP)` : ""}\n`);
+  process.stdout.write(`  Streak: ${GOLD}${stats.current_streak ?? 0}${RESET} days\n`);
+  process.stdout.write(`  Recordings: ${GOLD}${stats.total_recordings ?? 0}${RESET}${stats.total_minutes_recorded != null ? ` • ${stats.total_minutes_recorded} minutes` : ""}\n`);
+  process.stdout.write(`  Clips: ${GOLD}${stats.total_clips_created ?? 0}${RESET}\n`);
+  process.stdout.write(`  Credits: ${GOLD}${stats.credit_balance ?? stats.episodes_remaining ?? "?"}${RESET}\n`);
+}
+
+function printClips(data) {
+  const rows = asArray(data);
+  if (!rows.length) {
+    process.stdout.write("No clips found yet.\n");
+    return;
+  }
+  const failed = rows.filter((row) => row.status === "failed").length;
+  process.stdout.write(`${BOLD}Recent clips${RESET}${failed ? ` ${DIM}(${failed} need attention)${RESET}` : ""}\n\n`);
+  for (const clip of rows.slice(0, 8)) {
+    const status = clip.status || clip.metadata?.status || "unknown";
+    const views = clip.view_count ?? clip.metadata?.view_count ?? 0;
+    const link = clip.slug ? `https://mangomagic.live/clips/${clip.slug}` : clip.link ? `https://mangomagic.live${clip.link}` : "";
+    process.stdout.write(`  ${GOLD}${clip.title || "Untitled clip"}${RESET}\n`);
+    process.stdout.write(`  ${DIM}${status} • ${plural(Number(views), "view")}${link ? ` • ${link}` : ""}${RESET}\n`);
+  }
+}
+
+function leadName(row) {
+  return row.title || [row.first_name, row.last_name].filter(Boolean).join(" ") || row.name || row.email || row.id || "Unnamed lead";
+}
+
+function printLeads(data) {
+  const rows = asArray(data);
+  if (!rows.length) {
+    process.stdout.write("No guests or leads found yet.\n");
+    return;
+  }
+  process.stdout.write(`${BOLD}Guests and leads${RESET}\n\n`);
+  for (const lead of rows.slice(0, 10)) {
+    const role = [lead.position, lead.company].filter(Boolean).join(" at ");
+    const stage = lead.stage || lead.metadata?.stage || "unknown stage";
+    const enrichment = lead.enrichment_status || lead.metadata?.enrichment_status;
+    process.stdout.write(`  ${GOLD}${leadName(lead)}${RESET}\n`);
+    process.stdout.write(`  ${DIM}${[role, stage, enrichment].filter(Boolean).join(" • ")}${RESET}\n`);
+  }
+}
+
+function printGuestAnalysis(data) {
+  const rows = asArray(data);
+  if (!rows.length) {
+    process.stdout.write("I could not find guests or leads to analyse yet.\n");
+    return;
+  }
+
+  const stageCounts = new Map();
+  const pending = [];
+  const ready = [];
+  for (const lead of rows) {
+    const stage = lead.stage || "unknown";
+    stageCounts.set(stage, (stageCounts.get(stage) || 0) + 1);
+    if ((lead.enrichment_status || "").toLowerCase() === "pending") pending.push(lead);
+    if (lead.email || lead.profile_url) ready.push(lead);
+  }
+
+  process.stdout.write(`${BOLD}Guest pipeline snapshot${RESET}\n`);
+  process.stdout.write(`  Analysed: ${GOLD}${plural(rows.length, "guest")}${RESET}\n`);
+  process.stdout.write(`  Contactable now: ${GOLD}${ready.length}${RESET}\n`);
+  process.stdout.write(`  Need enrichment: ${GOLD}${pending.length}${RESET}\n`);
+  if (stageCounts.size) {
+    const summary = [...stageCounts.entries()].map(([stage, count]) => `${stage}: ${count}`).join(", ");
+    process.stdout.write(`  Stages: ${DIM}${summary}${RESET}\n`);
+  }
+
+  process.stdout.write(`\n${BOLD}Best immediate moves${RESET}\n`);
+  for (const lead of ready.slice(0, 5)) {
+    const contact = lead.email || lead.profile_url || "contact details available";
+    process.stdout.write(`  ${GOLD}${leadName(lead)}${RESET} ${DIM}${contact}${RESET}\n`);
+  }
+  const lead = leadName(ready[0] || pending[0]);
+  process.stdout.write(`\n${DIM}Next: ask "show me my leads" or "create talking cards about why ${lead} should join my podcast".${RESET}\n`);
+}
+
+function printMeetings(data) {
+  const rows = asArray(data);
+  if (!rows.length) {
+    process.stdout.write("No upcoming meetings found.\n");
+    return;
+  }
+  process.stdout.write(`${BOLD}Upcoming meetings${RESET}\n\n`);
+  for (const meeting of rows.slice(0, 8)) {
+    const when = formatDate(meeting.scheduled_at || meeting.scheduledAt || meeting.start_time);
+    process.stdout.write(`  ${GOLD}${meeting.title || meeting.name || "Untitled meeting"}${RESET}\n`);
+    process.stdout.write(`  ${DIM}${[when, meeting.status, meeting.guest_email || meeting.guestEmail].filter(Boolean).join(" • ")}${RESET}\n`);
+  }
+}
+
+function printBookings(data) {
+  const rows = asArray(data);
+  if (!rows.length) {
+    process.stdout.write("No bookings found.\n");
+    return;
+  }
+  process.stdout.write(`${BOLD}Bookings${RESET}\n\n`);
+  for (const booking of rows.slice(0, 8)) {
+    const when = formatDate(booking.scheduled_at || booking.created_at);
+    process.stdout.write(`  ${GOLD}${booking.title || booking.name || booking.guest_name || "Booking"}${RESET}\n`);
+    process.stdout.write(`  ${DIM}${[booking.status, when, booking.email || booking.guest_email].filter(Boolean).join(" • ")}${RESET}\n`);
+  }
+}
+
+function printGenericResult(name, data) {
+  const rows = items(data);
+  if (rows.length) {
+    process.stdout.write(`${BOLD}${name}${RESET}\n\n`);
+    for (const row of rows.slice(0, 10)) {
+      process.stdout.write(`  ${GOLD}${row.title || row.id || "Result"}${RESET}\n`);
+      if (row.subtitle) process.stdout.write(`  ${DIM}${row.subtitle}${RESET}\n`);
+      if (row.link) process.stdout.write(`  ${DIM}https://mangomagic.live${row.link}${RESET}\n`);
+    }
+    return;
+  }
+  const message = data?.message || data?.summary || data?.status;
+  process.stdout.write(message ? `${message}\n` : `${BOLD}Done.${RESET}\n`);
+}
+
+function printToolResult(name, data) {
+  switch (name) {
+    case "get_inbox":
+      return printInbox(data);
+    case "get_user_stats":
+      return printStats(data);
+    case "get_user_clips":
+      return printClips(data);
+    case "get_user_leads":
+      return printLeads(data);
+    case "get_upcoming_meetings":
+      return printMeetings(data);
+    case "get_bookings":
+      return printBookings(data);
+    case "get_user_episodes":
+    case "list_episodes":
+    case "search_user_episodes":
+    case "search_episodes":
+      return printEpisodeList(data);
+    default:
+      return printGenericResult(name, data);
+  }
+}
+
 function printEpisode(data) {
   const ep = data?.episode || data?.data || data;
   if (!ep || typeof ep !== "object") {
@@ -142,12 +392,17 @@ export async function handleNaturalLanguage(text, actions, { allowModel = true }
       plan = await planWithKimi(text, {
         availableTools: [
           "create_talking_cards",
-          "open_cards",
-          "open_brand_doc",
+          "list_inbox",
+          "list_leads",
+          "analyze_guests",
+          "list_clips",
+          "account_stats",
+          "list_meetings",
+          "list_bookings",
           "show_tools",
           "mcp_config",
           "home",
-          ...ALL_MCP_TOOL_CATALOG.map((tool) => tool.name),
+          ...CHAT_TOOL_NAMES,
         ],
       });
     } catch (err) {
@@ -181,11 +436,39 @@ ${DIM}${err?.message ?? err}${RESET}
     case "open_brand_doc":
       return actions.openPath("/carousels/doc");
     case "show_tools":
-      return actions.tools();
+      return actions.tools({ all: Boolean(args.all) });
     case "mcp_config":
       return actions.mcpConfig();
     case "home":
       return actions.home();
+    case "list_inbox": {
+      const data = await runCatalogTool("get_inbox", { limit: Math.max(1, Math.min(Number(args.limit || 5), 10)) });
+      return printInbox(data);
+    }
+    case "account_stats": {
+      const data = await runCatalogTool("get_user_stats", {});
+      return printStats(data);
+    }
+    case "list_clips": {
+      const data = await runCatalogTool("get_user_clips", { limit: Math.max(1, Math.min(Number(args.limit || 5), 10)) });
+      return printClips(data);
+    }
+    case "list_leads": {
+      const data = await runCatalogTool("get_user_leads", { limit: Math.max(1, Math.min(Number(args.limit || 8), 20)) });
+      return printLeads(data);
+    }
+    case "analyze_guests": {
+      const data = await runCatalogTool("get_user_leads", { limit: Math.max(1, Math.min(Number(args.limit || 10), 20)) });
+      return printGuestAnalysis(data);
+    }
+    case "list_meetings": {
+      const data = await runCatalogTool("get_upcoming_meetings", { limit: Math.max(1, Math.min(Number(args.limit || 5), 10)) });
+      return printMeetings(data);
+    }
+    case "list_bookings": {
+      const data = await runCatalogTool("get_bookings", { limit: Math.max(1, Math.min(Number(args.limit || 5), 10)) });
+      return printBookings(data);
+    }
     case "list_episodes": {
       const data = await apiCall("cli-list-episodes", { body: { limit: Math.max(1, Math.min(Number(args.limit || 5), 10)) } });
       return printEpisodeList(data);
@@ -211,10 +494,29 @@ ${DIM}${err?.message ?? err}${RESET}
         process.stdout.write("Which tool should I run?\n");
         return;
       }
+      if (String(args.toolName).startsWith("edge_")) {
+        process.stdout.write(`That is a developer/admin edge function. In chat mode I only run value-facing actions.\n`);
+        process.stdout.write(`Use ${GOLD}npx -y @mangomagic/cli tool ${args.toolName} '{"dryRun":true}'${RESET} if you want the raw operational tool.\n`);
+        return;
+      }
       const data = await runCatalogTool(args.toolName, args.args || {});
-      process.stdout.write(JSON.stringify(data, null, 2) + "\n");
+      printToolResult(args.toolName, data);
       return;
     }
+    case "get_inbox":
+    case "get_user_stats":
+    case "get_user_clips":
+    case "get_user_leads":
+    case "get_upcoming_meetings":
+    case "get_bookings":
+    case "get_user_episodes": {
+      const data = await runCatalogTool(action, args);
+      return printToolResult(action, data);
+    }
+    case "qualify_leads": {
+      const data = await runCatalogTool("get_user_leads", { limit: Math.max(1, Math.min(Number(args.limit || 10), 20)) });
+      return printGuestAnalysis(data);
+    }
     case "answer":
       process.stdout.write(`${args.text || "I can help with MangoMagic episodes, talking cards, and MCP setup."}\n`);
       return;
@@ -223,17 +525,25 @@ ${DIM}${err?.message ?? err}${RESET}
   }
 }
 
-export async function chat(actions) {
+export async function chat(actions, { showHeader = true } = {}) {
   const rl = readline.createInterface({ input, output });
-  process.stdout.write(`
+  if (showHeader) {
+    process.stdout.write(`
 ${BOLD}MangoMagic Chat${RESET}
 Type what you want. Try: ${GOLD}create talking cards about AI adoption${RESET}
 Type ${DIM}exit${RESET} to leave.
 
 `);
+  }
   try {
     while (true) {
-      const text = await rl.question(`${GOLD}mango>${RESET} `);
+      let text;
+      try {
+        text = await rl.question(`${GOLD}mango>${RESET} `);
+      } catch (err) {
+        if (err?.message === "readline was closed") break;
+        throw err;
+      }
       const result = await handleNaturalLanguage(text, actions);
       if (result === "exit") break;
       process.stdout.write("\n");

package/src/index.mjs

@@ -35,7 +35,21 @@ ${BOLD}mangomagic${RESET}  ${DIM}— sign into MangoMagic and bring your account
 Token cache: ${credentialsPath()}
 
 If \`mangomagic\` is not installed globally, use:
-  ${GOLD}${COMMAND_PREFIX} chat${RESET}
+  ${GOLD}${COMMAND_PREFIX} login${RESET}
+`);
+}
+
+function sessionIntro() {
+  process.stdout.write(`
+${BOLD}You can type naturally now.${RESET}
+
+Try:
+  ${GOLD}create 3 talking cards about founder-led sales${RESET}
+  ${GOLD}analyse my guests${RESET}
+  ${GOLD}show me my clips${RESET}
+  ${GOLD}what episodes do I have?${RESET}
+
+${DIM}Type ${BOLD}exit${RESET}${DIM} to leave. Add ${BOLD}--home${RESET}${DIM} next time if you only want the menu.${RESET}
 `);
 }
 
@@ -46,8 +60,9 @@ ${BOLD}What can MangoMagic do now?${RESET}
 ${DIM}Fast wins:${RESET}
 `);
   for (const item of QUICK_WINS) {
-    process.stdout.write(`  ${GOLD}${item.command.padEnd(24)}${RESET} ${BOLD}${item.title}${RESET}\n`);
-    process.stdout.write(`  ${DIM}${"".padEnd(24)} ${item.description}${RESET}\n`);
+    process.stdout.write(`  ${BOLD}${item.title}${RESET}\n`);
+    process.stdout.write(`  ${GOLD}${item.command}${RESET}\n`);
+    process.stdout.write(`  ${DIM}${item.description}${RESET}\n\n`);
   }
   process.stdout.write(`
 ${DIM}Try this in Claude, Cursor, or Codex after MCP is connected:${RESET}
@@ -84,10 +99,16 @@ ${DIM}Core tools available now:${RESET}
   }
 
   process.stdout.write(`
+${DIM}Value actions that work in chat now:${RESET}
+  ${GOLD}analyse my guests${RESET}
+  ${GOLD}show me my clips${RESET}
+  ${GOLD}show me my emails${RESET}
+  ${GOLD}show me my stats${RESET}
+
 ${DIM}Catalog:${RESET} ${ALL_MCP_TOOL_CATALOG.length} tools total (${MCP_TOOL_CATALOG.length} core, ${ALL_MCP_TOOL_CATALOG.length - MCP_TOOL_CATALOG.length} business/admin/raw tools).
-${DIM}Run:${RESET} ${GOLD}mangomagic tool get_user_stats${RESET}
-${DIM}Run with JSON:${RESET} ${GOLD}mangomagic tool get_user_episodes '{"limit":3}'${RESET}
-${DIM}Full list:${RESET} ${GOLD}mangomagic tools --all${RESET}
+${DIM}Run:${RESET} ${GOLD}${COMMAND_PREFIX} tool get_user_stats${RESET}
+${DIM}Run with JSON:${RESET} ${GOLD}${COMMAND_PREFIX} tool get_user_episodes '{"limit":3}'${RESET}
+${DIM}Full list:${RESET} ${GOLD}${COMMAND_PREFIX} tools --all${RESET}
 `);
 
   if (all) {
@@ -106,14 +127,14 @@ ${DIM}Full list:${RESET} ${GOLD}mangomagic tools --all${RESET}
   }
 
   process.stdout.write(`
-${DIM}Next high-value workflows to wire in:${RESET}
+${DIM}High-value workflows:${RESET}
 `);
   for (const workflow of NEXT_WORKFLOWS) {
     process.stdout.write(`  ${GOLD}${workflow.name.padEnd(28)}${RESET} ${workflow.description}\n`);
   }
 
   process.stdout.write(`
-${DIM}Use \`mangomagic mcp-config\` to connect an MCP client.${RESET}
+${DIM}Use \`${COMMAND_PREFIX} mcp-config\` to connect an MCP client.${RESET}
 `);
 }
 
@@ -150,15 +171,15 @@ function splashMode() {
 
 async function enterChatAfterLogin(startChat) {
   if (!startChat) return;
-  process.stdout.write(`\n${DIM}You're in chat mode now. Type ${BOLD}exit${RESET}${DIM} to leave.${RESET}\n`);
-  await chat(actions());
+  sessionIntro();
+  await chat(actions(), { showHeader: false });
 }
 
 async function login({ openInBrowser = true, startChat = false } = {}) {
   if (loadToken()) {
-    process.stdout.write(`${DIM}You're already signed in. Run \`mangomagic logout\` first to switch accounts.${RESET}\n`);
+    process.stdout.write(`${DIM}You're already signed in. Continuing in MangoMagic.${RESET}\n`);
     await playSplash({ mode: splashMode(), greetingLine: "Welcome back to MangoMagic." });
-    home();
+    if (!startChat) home();
     await enterChatAfterLogin(startChat);
     return;
   }
@@ -180,7 +201,7 @@ ${BOLD}Sign in to MangoMagic${RESET}
     saveToken(creds);
     process.stdout.write("\n\n");
     await playSplash({ mode: splashMode(), greetingLine: "You're in. Welcome to MangoMagic." });
-    home();
+    if (!startChat) home();
     await enterChatAfterLogin(startChat);
   });
 }

package/src/tools/catalog.mjs

@@ -69,9 +69,9 @@ export const QUICK_WINS = [
     status: "ready",
   },
   {
-    command: `${COMMAND_PREFIX} chat`,
+    command: `${COMMAND_PREFIX} login`,
     title: "Talk To MangoMagic",
-    description: "Type natural language and let the CLI choose the right MangoMagic action.",
+    description: "Enter chat mode, type natural language, and let the CLI choose the right MangoMagic action.",
     status: "ready",
   },
   {
@@ -91,14 +91,14 @@ export const QUICK_WINS = [
 export const NEXT_WORKFLOWS = [
   {
     name: "create_talking_cards",
-    description: "Generate a batch of branded talking cards from a short idea, saved to the user's carousel library.",
+    description: "Generate a batch of branded talking cards from a short idea and save them to the user's carousel library.",
   },
   {
     name: "sync_linkedin_brand_context",
-    description: "Use LinkedIn profile context to draft or refresh the user's Brand Doc.",
+    description: "Use LinkedIn profile context to draft or refresh the user's Brand Doc. Coming next.",
   },
   {
     name: "publish_talking_card",
-    description: "Publish an approved card to LinkedIn or prepare the post for manual approval.",
+    description: "Publish an approved card to LinkedIn or prepare the post for manual approval. Coming next.",
   },
 ];

package/src/ui/splash.mjs

@@ -35,6 +35,7 @@ const WHITEC = [255, 255, 255];
 const DIMC   = [110, 78, 12];
 
 const RESET = "\x1b[0m";
+const ESC = "\x1b[";
 
 const rgb = (c) => `\x1b[38;2;${c[0]};${c[1]};${c[2]}m`;
 const lerp = (a, b, t) => [
@@ -217,9 +218,15 @@ export async function playSplash({ mode = "static", greetingLine = null } = {})
   }
 
   const fps = 14;
-  const total = mode === "loop" ? Number.MAX_SAFE_INTEGER : Math.floor(2.8 * fps);
-
-  process.stdout.write("\x1b[?25l"); // hide cursor
+  const total = mode === "loop" ? Number.MAX_SAFE_INTEGER : Math.floor(1.15 * fps);
+  const useAltScreen = process.stdout.isTTY && process.env.MANGOMAGIC_SPLASH_INLINE !== "1";
+  const renderFrame = (body) => {
+    process.stdout.write(`${ESC}H${ESC}2J`);
+    process.stdout.write(body);
+    process.stdout.write("\n\n" + tag + greet + "\n");
+  };
+
+  process.stdout.write(useAltScreen ? `${ESC}?1049h${ESC}?25l` : `${ESC}?25l`);
   let interrupted = false;
   const onSig = () => { interrupted = true; };
   process.on("SIGINT", onSig);
@@ -229,15 +236,17 @@ export async function playSplash({ mode = "static", greetingLine = null } = {})
       if (Math.random() < 0.08 && shooters.length < 2) shooters.push(new Shooter(width, height));
       for (const sh of shooters) sh.life += 1;
       shooters = shooters.filter(s => s.life < 6);
-      process.stdout.write("\x1b[H\x1b[2J");
-      process.stdout.write(render(width, height, iconTop, wordTop, stars, shooters, f));
-      process.stdout.write("\n\n" + tag + greet + "\n");
+      renderFrame(render(width, height, iconTop, wordTop, stars, shooters, f));
       await sleep(1000 / fps);
     }
   } finally {
     process.off("SIGINT", onSig);
-    process.stdout.write("\x1b[H\x1b[2J");
-    process.stdout.write(renderSettled());
-    process.stdout.write("\n\n" + tag + greet + "\n\x1b[?25h");
+    if (useAltScreen) {
+      process.stdout.write(`${ESC}?25h${ESC}?1049l`);
+      process.stdout.write(renderSettled() + "\n\n" + tag + greet + "\n");
+    } else {
+      renderFrame(renderSettled());
+      process.stdout.write(`${ESC}?25h`);
+    }
   }
 }