clipbait 1.2.0 → 1.3.0

package/README.md

@@ -2,18 +2,18 @@
 
 Turn any video into short viral clips — and auto-clip live streams — from your terminal or an AI agent. Wraps the [Clipbait](https://clipbait.ai) API.
 
-## Fastest start — wire it into Claude Code in one command
+## Fastest start — one command
 ```bash
-npx clipbait init <your_api_key>      # get it at clipbait.ai → Me → Developers / API
+npx clipbait
 ```
-This saves your key, installs a **`/clipbait`** slash command, and connects the Clipbait MCP server to Claude Code. Then just type in Claude:
+It opens Clipbait so you can grab your key, then installs a **`/clipbait`** slash command and connects the Clipbait MCP server to Claude Code. Then just type in Claude:
 ```
 /clipbait https://youtube.com/watch?v=...
 ```
 
 ## Or use it straight from the terminal
 ```bash
-npx clipbait login <your_api_key>
+npx clipbait login <your_api_key>     # get it at clipbait.ai → Me → Developers / API
 npx clipbait generate "https://youtube.com/watch?v=..." --aspect 9:16 --max 9
 npx clipbait status <jobId>           # get finished clip URLs
 ```
@@ -21,7 +21,7 @@ npx clipbait status <jobId>           # get finished clip URLs
 ## Commands
 | Command | Description |
 |---|---|
-| `clipbait init <apiKey>` | One-command Claude Code setup (`/clipbait` + MCP) |
+| `clipbait` | One-command Claude Code setup (`/clipbait` + MCP) |
 | `clipbait login <apiKey>` | Save your API key (`~/.clipbait.json`) |
 | `clipbait generate <url> [--aspect 9:16] [--type talking_head] [--max 9]` | Generate clips |
 | `clipbait status <jobId>` | Check a job + get clip URLs |

package/index.js

@@ -2,8 +2,9 @@
 // clipbait — CLI + agent tool. Generate viral clips from any video, from your
 // terminal or an AI agent. Zero dependencies (Node 18+ built-in fetch).
 //
-// Auth: `clipbait login <cbk_live_...>` (saved to ~/.clipbait.json) or the
-// CLIPBAIT_API_KEY env var. Get your key at clipbait.ai → Me → API key.
+// Fastest start:  npx clipbait   (interactive: grabs your key, wires up Claude)
+// Auth: `clipbait login <cbk_live_...>` or the CLIPBAIT_API_KEY env var.
+// Get your key at clipbait.ai → Me → Developers / API.
 
 const fs = require("fs");
 const os = require("os");
@@ -11,6 +12,7 @@ const path = require("path");
 
 const CFG = path.join(os.homedir(), ".clipbait.json");
 const BASE = (process.env.CLIPBAIT_API_URL || "https://app.clipbait.ai/api").replace(/\/$/, "");
+const KEY_PAGE = "https://app.clipbait.ai/me";
 
 function loadKey() {
   if (process.env.CLIPBAIT_API_KEY) return process.env.CLIPBAIT_API_KEY;
@@ -38,10 +40,85 @@ function parseFlags(args) {
   return { o, rest };
 }
 
+function openBrowser(url) {
+  const { spawn } = require("child_process");
+  const cmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "cmd" : "xdg-open";
+  const cmdArgs = process.platform === "win32" ? ["/c", "start", "", url] : [url];
+  try { spawn(cmd, cmdArgs, { stdio: "ignore", detached: true }).unref(); } catch { /* ignore */ }
+}
+
+function prompt(question) {
+  const readline = require("readline");
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => rl.question(question, (a) => { rl.close(); resolve(a); }));
+}
+
+// The /clipbait Claude Code slash command. Installed by setup so users can type
+// "/clipbait <url>" and let Claude drive the whole clip pipeline.
+const SLASH_COMMAND = `---
+description: Turn any video into viral clips with Clipbait
+argument-hint: <video-url> [what you want]
+---
+You have the \`clipbait\` MCP tools connected. The user's request: $ARGUMENTS
+
+Do this, conversationally and fast:
+1. If there is no video URL in the request, ask for one (YouTube, Twitch VOD, Rumble, or Ganjing World). Otherwise don't ask for confirmation, just go.
+2. Read the intent and set params for \`generate_clips\`:
+   - vertical / shorts / tiktok / reels, or nothing specified => aspectRatio "9:16". landscape / widescreen / youtube => "16:9".
+   - if they mention a number of clips, use it as maxClips (1 to 20), otherwise 9.
+3. Call \`generate_clips\`, then poll \`get_job\` with the returned jobId every 30 seconds until status is "complete". Report progress between polls.
+4. When complete, list each finished clip as a numbered list: its hook and its URL.
+5. Then offer follow-ups and act on them by calling the tools again: regenerate at a different aspect ratio, pull more clips, or probe another video with \`probe_video\`.
+`;
+
+// Interactive one-command setup. Grabs the key (from arg / saved / by opening
+// the browser and prompting), installs the /clipbait command, and connects the
+// MCP server to Claude Code.
+async function runSetup(providedKey) {
+  let key = providedKey && providedKey.startsWith("cbk_") ? providedKey : loadKey();
+
+  if (!key) {
+    console.log("\n⚡ Let's connect Clipbait to Claude.\n");
+    if (!process.stdin.isTTY) {
+      console.error(`Run this in a terminal, or pass your key:  npx clipbait <cbk_live_...>\n  Get your key at ${KEY_PAGE}`);
+      process.exit(1);
+    }
+    console.log(`Opening ${KEY_PAGE} so you can copy your API key…`);
+    openBrowser(KEY_PAGE);
+    key = (await prompt("\nPaste your API key (starts with cbk_) and press Enter:\n> ")).trim();
+  }
+
+  if (!key || !key.startsWith("cbk_")) {
+    console.error(`\nThat doesn't look like a Clipbait key (it should start with cbk_). Get yours at ${KEY_PAGE}`);
+    process.exit(1);
+  }
+
+  fs.writeFileSync(CFG, JSON.stringify({ apiKey: key }, null, 2));
+  const mcpUrl = "https://app.clipbait.ai/api/mcp/" + key;
+
+  // 1) Install the /clipbait slash command for Claude Code.
+  const cmdDir = path.join(os.homedir(), ".claude", "commands");
+  fs.mkdirSync(cmdDir, { recursive: true });
+  fs.writeFileSync(path.join(cmdDir, "clipbait.md"), SLASH_COMMAND);
+  console.log("✓ Installed the /clipbait command for Claude Code");
+
+  // 2) Register the MCP server with Claude Code (if the `claude` CLI exists).
+  const { spawnSync } = require("child_process");
+  const r = spawnSync("claude", ["mcp", "add", "--transport", "http", "clipbait", mcpUrl], { stdio: "ignore" });
+  if (!r.error && r.status === 0) {
+    console.log("✓ Connected the Clipbait MCP server to Claude Code");
+  } else {
+    console.log("• Couldn't auto-connect the MCP server (Claude Code CLI not found). Run this once:");
+    console.log("    claude mcp add --transport http clipbait " + mcpUrl);
+  }
+
+  console.log("\n🎬 Done! Restart Claude Code, then type:\n    /clipbait https://youtube.com/watch?v=…\n");
+}
+
 const HELP = `clipbait — AI clip generation
 
-  clipbait init <apiKey>                              set up Claude Code: /clipbait command + MCP
-  clipbait login <apiKey>                             save your API key
+  npx clipbait                                        set up Claude Code (recommended)
+  clipbait login <apiKey>                             just save your API key
   clipbait generate <url> [--aspect 9:16] [--type talking_head] [--max 9]
   clipbait status <jobId>                             check a job + get clip URLs
   clipbait jobs                                       list recent jobs
@@ -53,6 +130,11 @@ Auth: CLIPBAIT_API_KEY env var or ~/.clipbait.json (via 'clipbait login').`;
 (async () => {
   const [cmd, ...args] = process.argv.slice(2);
   try {
+    // Bare `npx clipbait`  →  the one-command setup wizard (Remotion-style).
+    // Also accepts a pasted key as the first arg: `npx clipbait cbk_live_...`.
+    if (!cmd || (cmd && cmd.startsWith("cbk_"))) { await runSetup(cmd); return; }
+    if (cmd === "init" || cmd === "setup") { await runSetup(args[0]); return; }
+
     if (cmd === "login") {
       const key = args[0];
       if (!key) { console.error("Usage: clipbait login <cbk_live_...>"); process.exit(1); }
@@ -60,53 +142,10 @@ Auth: CLIPBAIT_API_KEY env var or ~/.clipbait.json (via 'clipbait login').`;
       console.log("✓ Saved API key to " + CFG);
       return;
     }
-    if (cmd === "init") {
-      // One-command Claude Code setup: save the key, install a /clipbait
-      // slash command, and register the Clipbait MCP server.
-      const key = args[0] && args[0].startsWith("cbk_") ? args[0] : loadKey();
-      if (!key) {
-        console.error("Usage: clipbait init <cbk_live_...>\n  Get your key at clipbait.ai → Me → Developers / API");
-        process.exit(1);
-      }
-      fs.writeFileSync(CFG, JSON.stringify({ apiKey: key }, null, 2));
-      const mcpUrl = "https://app.clipbait.ai/api/mcp/" + key;
+    if (cmd === "help" || cmd === "--help" || cmd === "-h") { console.log(HELP); return; }
 
-      // 1) Install the /clipbait slash command for Claude Code.
-      const cmdDir = path.join(os.homedir(), ".claude", "commands");
-      fs.mkdirSync(cmdDir, { recursive: true });
-      const slash = `---
-description: Turn any video into viral clips with Clipbait
-argument-hint: <video-url> [what you want]
----
-You have the \`clipbait\` MCP tools connected. The user's request: $ARGUMENTS
-
-Do this, conversationally and fast:
-1. If there is no video URL in the request, ask for one (YouTube, Twitch VOD, Rumble, or Ganjing World). Otherwise don't ask for confirmation, just go.
-2. Read the intent and set params for \`generate_clips\`:
-   - vertical / shorts / tiktok / reels, or nothing specified => aspectRatio "9:16". landscape / widescreen / youtube => "16:9".
-   - if they mention a number of clips, use it as maxClips (1 to 20), otherwise 9.
-3. Call \`generate_clips\`, then poll \`get_job\` with the returned jobId every 30 seconds until status is "complete". Report progress between polls.
-4. When complete, list each finished clip as a numbered list: its hook and its URL.
-5. Then offer follow-ups and act on them by calling the tools again: regenerate at a different aspect ratio, pull more clips, or probe another video with \`probe_video\`.
-`;
-      fs.writeFileSync(path.join(cmdDir, "clipbait.md"), slash);
-      console.log("✓ Installed /clipbait command → " + path.join(cmdDir, "clipbait.md"));
-
-      // 2) Register the MCP server with Claude Code (if the `claude` CLI exists).
-      const { spawnSync } = require("child_process");
-      const r = spawnSync("claude", ["mcp", "add", "--transport", "http", "clipbait", mcpUrl], { stdio: "ignore" });
-      if (!r.error && r.status === 0) {
-        console.log("✓ Connected the Clipbait MCP server to Claude Code");
-      } else {
-        console.log("• Couldn't auto-connect the MCP server (Claude Code CLI not found). Run this once:");
-        console.log("    claude mcp add --transport http clipbait " + mcpUrl);
-      }
-      console.log("\nDone. Restart Claude Code, then try:\n    /clipbait https://youtube.com/watch?v=...");
-      return;
-    }
-    if (!cmd || cmd === "help" || cmd === "--help" || cmd === "-h") { console.log(HELP); return; }
     if (!loadKey()) {
-      console.error("No API key. Run: clipbait login <key>  (get it at clipbait.ai → Me → API key)");
+      console.error("No API key. Run: npx clipbait  (get set up in one step)");
       process.exit(1);
     }
     const { o, rest } = parseFlags(args);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clipbait",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Clipbait CLI — turn any video into viral clips, and auto-clip live streams, from your terminal or AI agent.",
   "bin": { "clipbait": "index.js" },
   "type": "commonjs",