@mangomagic/cli 0.1.5 → 0.1.6

package/README.md

@@ -21,7 +21,8 @@ at `~/.mangomagic/credentials.json` (mode 0600) so the next runs skip auth.
 | `mangomagic chat` | Start an interactive natural-language session. |
 | `mangomagic ask "..."` | Run one natural-language request. |
 | `mangomagic tools` | Show available MCP tools and near-next workflows. Add `--json` for machine-readable output. |
-| `mangomagic cards` | Open the Talking Cards workspace. Add `--no-open` to print the URL only. |
+| `mangomagic cards "idea"` | Create talking cards in the terminal and save them to your library. Add `--count 3`. |
+| `mangomagic open cards` | Open the Talking Cards workspace in a browser. |
 | `mangomagic splash` | Show the splash once. `--anim`, `--loop` supported. |
 | `mangomagic mcp` | Run as a stdio MCP server. Wire into Claude Desktop / Cursor. |
 | `mangomagic mcp-config` | Print MCP client JSON for copy-paste. |
@@ -49,6 +50,7 @@ you sign in first.
 ```bash
 npx -y @mangomagic/cli chat
 npx -y @mangomagic/cli create talking cards about AI adoption
+npx -y @mangomagic/cli cards "why founder-led sales stalls" --count 3
 ```
 
 Obvious requests are handled locally. Fuzzy routing uses MangoMagic's backend AI

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mangomagic/cli",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "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

@@ -22,7 +22,7 @@ function localPlan(text) {
     return { action: "open_brand_doc", args: {} };
   }
   if (t.includes("talking card") || t.includes("carousel") || /\bcards?\b/.test(t)) {
-    return { action: "open_cards", args: { focus: raw } };
+    return { action: "create_talking_cards", args: { focus: raw, count: inferCount(raw) } };
   }
   if (t.includes("mcp") && (t.includes("config") || t.includes("connect") || t.includes("claude") || t.includes("cursor") || t.includes("codex"))) {
     return { action: "mcp_config", args: {} };
@@ -40,6 +40,12 @@ function localPlan(text) {
   return null;
 }
 
+function inferCount(text) {
+  const match = text.match(/(?:^|\s)(?:make|create|generate)?\s*(\d{1,2})\s+(?:talking\s+)?cards?\b/i);
+  if (!match) return 3;
+  return Math.max(1, Math.min(Number(match[1]), 10));
+}
+
 function asArray(data) {
   if (Array.isArray(data)) return data;
   if (Array.isArray(data?.episodes)) return data.episodes;
@@ -76,12 +82,63 @@ function printEpisode(data) {
   if (ep.id) process.stdout.write(`\n${DIM}${ep.id}${RESET}\n`);
 }
 
+function cardUrl(card) {
+  return card?.id ? `https://mangomagic.live/carousels/${card.id}` : null;
+}
+
+export function printCards(result) {
+  const cards = Array.isArray(result?.carousels) ? result.carousels : [];
+  if (!cards.length) {
+    process.stdout.write("No cards were created.\n");
+    return;
+  }
+
+  process.stdout.write(`${BOLD}Created ${cards.length} talking card${cards.length === 1 ? "" : "s"}.${RESET}\n\n`);
+  for (const [idx, card] of cards.entries()) {
+    process.stdout.write(`${GOLD}${idx + 1}. ${card.title || "Untitled card"}${RESET}\n`);
+    if (card.seam) process.stdout.write(`   ${DIM}${card.seam}${RESET}\n`);
+    const slides = Array.isArray(card?.spec?.slides) ? card.spec.slides : [];
+    for (const slide of slides.slice(0, 8)) {
+      const line = (slide.lines || []).map((l) => l.text).filter(Boolean).join(" / ");
+      if (line) process.stdout.write(`   - ${line}\n`);
+    }
+    if (card.caption) process.stdout.write(`\n   Caption: ${card.caption.replace(/\n/g, "\n            ")}\n`);
+    const url = cardUrl(card);
+    if (url) process.stdout.write(`   Edit: ${url}\n`);
+    process.stdout.write("\n");
+  }
+}
+
+export async function createTalkingCards({ focus, count = 3 } = {}) {
+  const cleanFocus = compact(focus);
+  if (!cleanFocus) {
+    process.stdout.write(`Give me an idea, for example:\n  ${GOLD}mangomagic cards "why founder-led sales stalls" --count 3${RESET}\n`);
+    return;
+  }
+
+  process.stdout.write(`${DIM}Creating ${count} talking card${count === 1 ? "" : "s"}...${RESET}\n`);
+  try {
+    const result = await apiCall("cli-create-talking-cards", {
+      body: { focus: cleanFocus, count: Math.max(1, Math.min(Number(count || 3), 10)) },
+    });
+    printCards(result);
+  } catch (err) {
+    const message = err?.message ?? String(err);
+    if (message.includes("HTTP 404")) {
+      process.stdout.write(`${BOLD}The terminal card-creation backend is not deployed yet.${RESET}\n`);
+      process.stdout.write(`This CLI is ready, but MangoMagic Cloud still needs the \`cli-create-talking-cards\` function deployed.\n`);
+      return;
+    }
+    throw err;
+  }
+}
+
 export async function handleNaturalLanguage(text, actions, { allowModel = true } = {}) {
   let plan = localPlan(text);
   if (!plan && allowModel) {
     try {
       plan = await planWithKimi(text, {
-        availableTools: ["open_cards", "open_brand_doc", "show_tools", "mcp_config", "list_episodes", "search_episodes", "get_episode", "home"],
+        availableTools: ["create_talking_cards", "open_cards", "open_brand_doc", "show_tools", "mcp_config", "list_episodes", "search_episodes", "get_episode", "home"],
       });
     } catch (err) {
       process.stdout.write(`
@@ -107,6 +164,8 @@ ${DIM}${err?.message ?? err}${RESET}
   switch (action) {
     case "exit":
       return "exit";
+    case "create_talking_cards":
+      return createTalkingCards({ focus: args.focus || text, count: args.count || 3 });
     case "open_cards":
       return actions.cards({ path: "/carousels/generate", focus: args.focus });
     case "open_brand_doc":

package/src/index.mjs

@@ -1,5 +1,5 @@
 import { deviceLogin } from "./auth/device-flow.mjs";
-import { chat, handleNaturalLanguage } from "./chat/natural-language.mjs";
+import { chat, createTalkingCards, handleNaturalLanguage } from "./chat/natural-language.mjs";
 import { loadToken, saveToken, clearToken, credentialsPath } from "./auth/token-store.mjs";
 import { APP_ORIGIN } from "./config.mjs";
 import { openUrl } from "./system/open-url.mjs";
@@ -21,7 +21,8 @@ ${BOLD}mangomagic${RESET}  ${DIM}— sign into MangoMagic and bring your account
   ${GOLD}mangomagic home${RESET}        Show fast wins for creating value right now.
   ${GOLD}mangomagic chat${RESET}        Talk to MangoMagic in natural language.
   ${GOLD}mangomagic tools${RESET}       Show available MCP tools and next workflows.
-  ${GOLD}mangomagic cards${RESET}       Open the Talking Cards workspace.
+  ${GOLD}mangomagic cards "idea"${RESET} Create talking cards in the terminal.
+  ${GOLD}mangomagic open cards${RESET}  Open the Talking Cards workspace in a browser.
   ${GOLD}mangomagic splash${RESET}      Show the MangoMagic splash once. Add --anim or --loop for motion.
   ${GOLD}mangomagic mcp${RESET}         Run as a stdio MCP server (for Claude Desktop / Cursor).
   ${GOLD}mangomagic mcp-config${RESET}  Print MCP client config for copy-paste.
@@ -148,6 +149,25 @@ function cards({ openInBrowser = process.env.MANGOMAGIC_CLI_NO_OPEN !== "1", pat
   if (focus) process.stdout.write(`${DIM}Idea: ${focus}${RESET}\n`);
 }
 
+function parseCount(argv, fallback = 3) {
+  const flagIndex = argv.findIndex((v) => v === "--count" || v === "-n");
+  if (flagIndex >= 0 && argv[flagIndex + 1]) return Math.max(1, Math.min(Number(argv[flagIndex + 1]), 10));
+  const inline = argv.find((v) => /^--count=/.test(v));
+  if (inline) return Math.max(1, Math.min(Number(inline.split("=")[1]), 10));
+  return fallback;
+}
+
+function stripFlags(argv) {
+  const out = [];
+  for (let i = 0; i < argv.length; i++) {
+    const v = argv[i];
+    if (v === "--count" || v === "-n") { i++; continue; }
+    if (v.startsWith("--count=")) continue;
+    out.push(v);
+  }
+  return out;
+}
+
 async function mcpServer() {
   // Lazy-load so users who only run `login` don't pay the import cost.
   const { startMcpServer } = await import("./mcp/server.mjs");
@@ -180,7 +200,10 @@ export async function run(argv) {
     case "chat":       return chat(actions());
     case "ask":        return handleNaturalLanguage(argv.slice(1).join(" "), actions());
     case "tools":      return tools({ json: argv.includes("--json") });
-    case "cards":      return cards({ openInBrowser: !argv.includes("--no-open") && process.env.MANGOMAGIC_CLI_NO_OPEN !== "1" });
+    case "cards":      return createTalkingCards({ focus: stripFlags(argv.slice(1)).join(" "), count: parseCount(argv.slice(1)) });
+    case "open":
+      if (argv[1] === "cards" || argv[1] === "carousels") return cards({ openInBrowser: !argv.includes("--no-open") && process.env.MANGOMAGIC_CLI_NO_OPEN !== "1" });
+      return openPath(`/${argv[1] || ""}`);
     case "splash":     return playSplash({ mode: argv.includes("--loop") ? "loop" : argv.includes("--anim") ? "anim" : "static" });
     case "mcp":        return mcpServer();
     case "mcp-config": return mcpConfig();

package/src/tools/catalog.mjs

@@ -42,10 +42,9 @@ export const MCP_TOOL_CATALOG = [
 
 export const QUICK_WINS = [
   {
-    command: `${COMMAND_PREFIX} cards`,
+    command: `${COMMAND_PREFIX} cards "why founder-led sales stalls" --count 3`,
     title: "Create Talking Cards",
-    description: "Open the card workspace, build a Brand Doc, choose colours, and generate LinkedIn-ready cards.",
-    url: `${APP_ORIGIN}/carousels`,
+    description: "Generate LinkedIn-ready talking cards from the terminal and save them to your library.",
     status: "ready",
   },
   {
@@ -71,7 +70,7 @@ export const QUICK_WINS = [
 export const NEXT_WORKFLOWS = [
   {
     name: "create_talking_cards",
-    description: "Generate a batch of branded cards from a short idea, saved to the user's carousel library.",
+    description: "Generate a batch of branded talking cards from a short idea, saved to the user's carousel library.",
   },
   {
     name: "sync_linkedin_brand_context",