@mangomagic/cli 0.1.1 → 0.1.2

package/README.md

@@ -17,6 +17,9 @@ at `~/.mangomagic/credentials.json` (mode 0600) so the next runs skip auth.
 | `mangomagic login` | Browser-based device-code sign-in + splash. Add `--no-open` to print the URL without opening a browser. |
 | `mangomagic logout` | Forget the cached token. |
 | `mangomagic whoami` | Show the cached identity. |
+| `mangomagic home` | Show fast wins after sign-in. |
+| `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 splash` | Replay the splash animation. `--static`, `--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. |

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@mangomagic/cli",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "MangoMagic CLI — sign in, manage episodes, and expose MangoMagic to MCP clients (Claude Desktop, Cursor).",
   "type": "module",
   "bin": {
+    "cli": "bin/mangomagic.mjs",
     "mangomagic": "bin/mangomagic.mjs"
   },
   "publishConfig": {

package/src/auth/device-flow.mjs

@@ -1,22 +1,8 @@
 // Browser-device OAuth-style flow against the cli-device-authorize / cli-device-poll edge fns.
 import { FN_BASE, SUPABASE_ANON_KEY } from "../config.mjs";
-import { spawn } from "node:child_process";
+import { openUrl } from "../system/open-url.mjs";
 import { hostname, platform } from "node:os";
 
-function openBrowser(url) {
-  const cmd = process.platform === "darwin" ? "open"
-            : process.platform === "win32"  ? "cmd"
-            : "xdg-open";
-  const args = process.platform === "win32" ? ["/c", "start", "", url] : [url];
-  try {
-    const child = spawn(cmd, args, { stdio: "ignore", detached: true });
-    child.unref();
-    return true;
-  } catch {
-    return false;
-  }
-}
-
 async function call(path, body) {
   const res = await fetch(`${FN_BASE}/${path}`, {
     method: "POST",
@@ -40,7 +26,7 @@ export async function deviceLogin({ onCode, onWaiting, openInBrowser = true } =
   const start = await call("cli-device-authorize", { client_name });
 
   onCode?.(start);
-  if (openInBrowser) openBrowser(start.verification_uri_complete);
+  if (openInBrowser) openUrl(start.verification_uri_complete);
 
   const deadline = Date.now() + (start.expires_in ?? 600) * 1000;
   let interval = (start.interval ?? 2) * 1000;

package/src/index.mjs

@@ -1,5 +1,8 @@
 import { deviceLogin } from "./auth/device-flow.mjs";
 import { loadToken, saveToken, clearToken, credentialsPath } from "./auth/token-store.mjs";
+import { APP_ORIGIN } from "./config.mjs";
+import { openUrl } from "./system/open-url.mjs";
+import { MCP_TOOL_CATALOG, NEXT_WORKFLOWS, QUICK_WINS } from "./tools/catalog.mjs";
 import { playSplash } from "./ui/splash.mjs";
 
 const GOLD = "\x1b[38;2;241;171;28m";
@@ -14,6 +17,9 @@ ${BOLD}mangomagic${RESET}  ${DIM}— sign into MangoMagic and bring your account
   ${GOLD}mangomagic login${RESET}       Authorize this terminal (opens your browser; add --no-open to print only).
   ${GOLD}mangomagic logout${RESET}      Forget the token cached on this machine.
   ${GOLD}mangomagic whoami${RESET}      Show the cached identity.
+  ${GOLD}mangomagic home${RESET}        Show fast wins for creating value right now.
+  ${GOLD}mangomagic tools${RESET}       Show available MCP tools and next workflows.
+  ${GOLD}mangomagic cards${RESET}       Open the Talking Cards workspace.
   ${GOLD}mangomagic splash${RESET}      Play the MangoMagic splash animation.
   ${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.
@@ -23,10 +29,63 @@ Token cache: ${credentialsPath()}
 `);
 }
 
+function home() {
+  process.stdout.write(`
+${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(`
+${DIM}Try this in Claude, Cursor, or Codex after MCP is connected:${RESET}
+  "Use MangoMagic to search my episodes for AI adoption."
+  "Use MangoMagic to get my latest episode and draft five LinkedIn post ideas."
+
+${DIM}Open app:${RESET} ${APP_ORIGIN}
+${DIM}Token cache:${RESET} ${credentialsPath()}
+`);
+}
+
+function tools({ json = false } = {}) {
+  if (json) {
+    process.stdout.write(JSON.stringify({
+      mcpTools: MCP_TOOL_CATALOG,
+      quickWins: QUICK_WINS,
+      nextWorkflows: NEXT_WORKFLOWS,
+    }, null, 2) + "\n");
+    return;
+  }
+
+  process.stdout.write(`
+${BOLD}MangoMagic MCP Tools${RESET}
+
+${DIM}Available now:${RESET}
+`);
+  for (const tool of MCP_TOOL_CATALOG) {
+    process.stdout.write(`  ${GOLD}${tool.name.padEnd(18)}${RESET} ${tool.description}\n`);
+    process.stdout.write(`  ${DIM}${"".padEnd(18)} Try: ${tool.example}${RESET}\n`);
+  }
+
+  process.stdout.write(`
+${DIM}Next high-value workflows to wire in:${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}
+`);
+}
+
 async function login({ openInBrowser = true } = {}) {
   if (loadToken()) {
     process.stdout.write(`${DIM}You're already signed in. Run \`mangomagic logout\` first to switch accounts.${RESET}\n`);
     await playSplash({ greetingLine: "Welcome back to MangoMagic." });
+    home();
     return;
   }
 
@@ -47,6 +106,7 @@ ${BOLD}Sign in to MangoMagic${RESET}
     saveToken(creds);
     process.stdout.write("\n\n");
     await playSplash({ greetingLine: "You're in. Welcome to MangoMagic." });
+    home();
   });
 }
 
@@ -61,6 +121,15 @@ function whoami() {
   process.stdout.write(`Signed in (user ${t.userId ?? "?"}), approved ${t.approvedAt}\n`);
 }
 
+function cards({ openInBrowser = true } = {}) {
+  const url = `${APP_ORIGIN}/carousels`;
+  if (openInBrowser) {
+    const opened = openUrl(url);
+    process.stdout.write(opened ? "Opening Talking Cards...\n" : "Could not open a browser automatically.\n");
+  }
+  process.stdout.write(`${GOLD}${url}${RESET}\n`);
+}
+
 async function mcpServer() {
   // Lazy-load so users who only run `login` don't pay the import cost.
   const { startMcpServer } = await import("./mcp/server.mjs");
@@ -80,11 +149,14 @@ function mcpConfig() {
 }
 
 export async function run(argv) {
-  const cmd = argv[0] ?? (loadToken() ? "splash" : "login");
+  const cmd = argv[0] ?? (loadToken() ? "home" : "login");
   switch (cmd) {
     case "login":      return login({ openInBrowser: !argv.includes("--no-open") && process.env.MANGOMAGIC_CLI_NO_OPEN !== "1" });
     case "logout":     return logout();
     case "whoami":     return whoami();
+    case "home":       return home();
+    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 "splash":     return playSplash({ mode: argv.includes("--loop") ? "loop" : argv.includes("--static") ? "static" : "anim" });
     case "mcp":        return mcpServer();
     case "mcp-config": return mcpConfig();

package/src/mcp/server.mjs

@@ -9,38 +9,18 @@ import {
 } from "@modelcontextprotocol/sdk/types.js";
 import { apiCall } from "../api.mjs";
 import { loadToken } from "../auth/token-store.mjs";
+import { MCP_TOOL_CATALOG } from "../tools/catalog.mjs";
 
-const TOOLS = [
-  {
-    name: "list_episodes",
-    description: "List the signed-in user's MangoMagic episodes (most recent first).",
-    inputSchema: {
-      type: "object",
-      properties: { limit: { type: "integer", minimum: 1, maximum: 50, default: 10 } },
-    },
-    handler: async ({ limit = 10 }) => apiCall("cli-list-episodes", { body: { limit } }),
-  },
-  {
-    name: "get_episode",
-    description: "Get full details for one episode (transcript, summary, takeaways) by ID or slug.",
-    inputSchema: {
-      type: "object",
-      properties: { episode: { type: "string", description: "Episode id or slug" } },
-      required: ["episode"],
-    },
-    handler: async ({ episode }) => apiCall("cli-get-episode", { body: { episode } }),
-  },
-  {
-    name: "search_episodes",
-    description: "Full-text search across the signed-in user's episodes.",
-    inputSchema: {
-      type: "object",
-      properties: { query: { type: "string" } },
-      required: ["query"],
-    },
-    handler: async ({ query }) => apiCall("cli-search-episodes", { body: { query } }),
-  },
-];
+const TOOL_HANDLERS = {
+  list_episodes: async ({ limit = 10 }) => apiCall("cli-list-episodes", { body: { limit } }),
+  get_episode: async ({ episode }) => apiCall("cli-get-episode", { body: { episode } }),
+  search_episodes: async ({ query }) => apiCall("cli-search-episodes", { body: { query } }),
+};
+
+const TOOLS = MCP_TOOL_CATALOG.map((tool) => ({
+  ...tool,
+  handler: TOOL_HANDLERS[tool.name],
+}));
 
 export async function startMcpServer() {
   if (!loadToken()) {

package/src/system/open-url.mjs

@@ -0,0 +1,16 @@
+import { spawn } from "node:child_process";
+
+export function openUrl(url) {
+  const cmd = process.platform === "darwin" ? "open"
+            : process.platform === "win32" ? "cmd"
+            : "xdg-open";
+  const args = process.platform === "win32" ? ["/c", "start", "", url] : [url];
+
+  try {
+    const child = spawn(cmd, args, { stdio: "ignore", detached: true });
+    child.unref();
+    return true;
+  } catch {
+    return false;
+  }
+}

package/src/tools/catalog.mjs

@@ -0,0 +1,76 @@
+import { APP_ORIGIN } from "../config.mjs";
+
+export const MCP_TOOL_CATALOG = [
+  {
+    name: "list_episodes",
+    description: "List the signed-in user's MangoMagic episodes, newest first.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        limit: { type: "integer", minimum: 1, maximum: 50, default: 10 },
+      },
+    },
+    example: "Use MangoMagic to list my three most recent episodes.",
+  },
+  {
+    name: "get_episode",
+    description: "Get full details for one episode, including transcript, summary, and takeaways.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        episode: { type: "string", description: "Episode id or slug" },
+      },
+      required: ["episode"],
+    },
+    example: "Use MangoMagic to get episode <id> and turn it into LinkedIn talking points.",
+  },
+  {
+    name: "search_episodes",
+    description: "Search across the signed-in user's episodes.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        query: { type: "string" },
+      },
+      required: ["query"],
+    },
+    example: "Use MangoMagic to search my episodes for customer discovery.",
+  },
+];
+
+export const QUICK_WINS = [
+  {
+    command: "mangomagic cards",
+    title: "Create Talking Cards",
+    description: "Open the card workspace, build a Brand Doc, choose colours, and generate LinkedIn-ready cards.",
+    url: `${APP_ORIGIN}/carousels`,
+    status: "ready",
+  },
+  {
+    command: "mangomagic mcp-config",
+    title: "Connect Claude, Cursor, or Codex",
+    description: "Print the MCP config that lets your AI client use MangoMagic tools.",
+    status: "ready",
+  },
+  {
+    command: "mangomagic tools",
+    title: "See Every Tool",
+    description: "Show the full MCP tool list plus the next high-value workflows to wire in.",
+    status: "ready",
+  },
+];
+
+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.",
+  },
+  {
+    name: "sync_linkedin_brand_context",
+    description: "Use LinkedIn profile context to draft or refresh the user's Brand Doc.",
+  },
+  {
+    name: "publish_talking_card",
+    description: "Publish an approved card to LinkedIn or prepare the post for manual approval.",
+  },
+];