clipbait 1.6.0 → 1.7.0

package/README.md

@@ -1,38 +1,34 @@
 # clipbait
 
-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.
+Official CLI + MCP server for [Clipbait](https://clipbait.ai) — the AI video clipping tool for streamers and clippers.
+
+Let Claude (or any MCP-capable agent) turn long videos into viral vertical clips, check your credits, auto-clip live Twitch streams, and download finished clips to disk — on your Clipbait account. Also works as a plain terminal CLI.
+
+## Requires
+
+- **Node.js 18 or higher.**
+- **A paid Clipbait account.** Generate a key at [app.clipbait.ai/me](https://app.clipbait.ai/me) → **Developers / API**. Keys are prefixed `cbk_live_`.
+
+## Install
+
+### Fastest — one command (auto-configures Claude Code + Claude Desktop)
 
-## Fastest start — one command
 ```bash
 npx clipbait@latest
 ```
-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
+Opens Clipbait so you can copy your key, then installs a `/clipbait` slash command and wires the MCP server into Claude Code and Claude Desktop for you — no JSON to hand-write. Pass the key inline to skip the prompt: `npx clipbait@latest cbk_live_yourkey`. Restart Claude, then type `/clipbait <video url>`.
+
+### Claude Code
+
 ```bash
-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
+claude mcp add --transport http clipbait https://app.clipbait.ai/api/mcp/cbk_live_your_key_here
 ```
 
-## Commands
-| Command | Description |
-|---|---|
-| `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 |
-| `clipbait jobs` | List recent jobs |
-| `clipbait live <twitchUrl> [--cadence 7]` | Start live auto-clipping (Pro) |
-| `clipbait probe <url>` | Get a video's duration |
-
-Auth via `CLIPBAIT_API_KEY` env var or `~/.clipbait.json`. Requires Node 18+.
-
-## MCP server (Claude Desktop, Cursor, Cline, Windsurf)
-This package is also an MCP server. `npx clipbait@latest` auto-configures **Claude Code**. For other clients, add this to their MCP config:
+### Cursor / Cline / Windsurf / manual
+
+Drop this into the client's MCP config file (runs the local stdio server):
+
 ```json
 {
   "mcpServers": {
@@ -44,6 +40,52 @@ This package is also an MCP server. `npx clipbait@latest` auto-configures **Clau
   }
 }
 ```
-Tools: `generate_clips`, `get_job`, `list_recent_clips`, `get_credits`, `start_live_autoclip`, `probe_video`, and **`download_clip`** (saves a finished clip to your `~/Downloads`).
 
-Using **ChatGPT / claude.ai** (URL connectors, no local process)? Point them at the hosted MCP instead: `https://app.clipbait.ai/api/mcp/<your_api_key>`.
+> **ChatGPT / claude.ai** take a remote URL instead of a local process — point them at `https://app.clipbait.ai/api/mcp/<your_api_key>` (nothing runs on your machine, nothing to update).
+
+## Tools
+
+Seven tools are available to any agent:
+
+| Tool | What it does |
+|---|---|
+| `generate_clips` | Start a clipping job (`videoUrl`, optional `aspectRatio` 9:16\|16:9, `maxClips` 1–20). Returns a job id. |
+| `get_job` | Check a job's status and get finished clip URLs (`jobId`). |
+| `list_recent_clips` | List your recent jobs and clip counts. |
+| `get_credits` | Show credits remaining and your plan. No inputs. |
+| `start_live_autoclip` | Auto-clip a **live** Twitch stream continuously (`channelUrl`, optional `cadenceMin`). Pro plan. |
+| `probe_video` | Get a video's duration before clipping (`url`). |
+| `download_clip` | Save a finished clip to your `~/Downloads/` folder and return the path (`jobId`, `clipIndex` 1-based). Max 500 MB. |
+
+## Terminal usage
+
+```bash
+npx clipbait login cbk_live_your_key
+npx clipbait generate "https://youtube.com/watch?v=..." --aspect 9:16 --max 9
+npx clipbait status <jobId>       # get finished clip URLs
+npx clipbait jobs                 # list recent jobs
+npx clipbait live "https://twitch.tv/somestreamer"
+npx clipbait mcp                  # run the stdio MCP server (used in configs above)
+```
+
+Auth via the `CLIPBAIT_API_KEY` env var or `~/.clipbait.json`.
+
+## Security
+
+- **Never commit your `CLIPBAIT_API_KEY`.** Your agent's config file contains a secret — add it to `.gitignore`, or use a secrets manager (1Password CLI, direnv) instead of inline env vars.
+- If you leak your key, rotate it at [app.clipbait.ai/me](https://app.clipbait.ai/me) immediately — the old key stops working at once.
+- `download_clip` links are presigned and expire in ~1 hour. Save clips promptly.
+
+## Pricing
+
+Requires a **paid Clipbait account**. Clip generation spends credits (1 credit ≈ 1 minute of source video). See [clipbait.ai](https://clipbait.ai).
+
+## Links
+
+- Clipbait: https://clipbait.ai
+- API docs: https://app.clipbait.ai/docs
+- Get an API key: https://app.clipbait.ai/me
+
+## License
+
+MIT

package/index.js

@@ -114,9 +114,35 @@ Do this, conversationally and fast:
 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\`.
 `;
 
+// Claude Desktop config path per-OS.
+function desktopConfigPath() {
+  const home = os.homedir();
+  if (process.platform === "darwin") return path.join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json");
+  if (process.platform === "win32") return path.join(process.env.APPDATA || path.join(home, "AppData", "Roaming"), "Claude", "claude_desktop_config.json");
+  return path.join(home, ".config", "Claude", "claude_desktop_config.json");
+}
+
+// Configure Claude Desktop (stdio) if it's installed. Desktop can't use the
+// remote http MCP, and the local stdio server is what enables download_clip.
+// Returns false (silently) when Claude Desktop isn't present.
+function writeDesktopConfig(key) {
+  const cfgPath = desktopConfigPath();
+  try {
+    if (!fs.existsSync(path.dirname(cfgPath))) return false; // Desktop not installed
+    let cfg = {};
+    try { cfg = JSON.parse(fs.readFileSync(cfgPath, "utf8")); } catch { /* new file */ }
+    cfg.mcpServers = cfg.mcpServers || {};
+    cfg.mcpServers.clipbait = { command: "npx", args: ["-y", "clipbait@latest", "mcp"], env: { CLIPBAIT_API_KEY: key } };
+    const tmp = cfgPath + ".clipbait.tmp";
+    fs.writeFileSync(tmp, JSON.stringify(cfg, null, 2));
+    fs.renameSync(tmp, cfgPath);
+    return true;
+  } catch { return false; }
+}
+
 // 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.
+// MCP server to Claude Code and Claude Desktop.
 async function runSetup(providedKey) {
   let key = providedKey && providedKey.startsWith("cbk_") ? providedKey : loadKey();
 
@@ -163,6 +189,11 @@ async function runSetup(providedKey) {
     }
   }
 
+  // 3) Also configure Claude Desktop if installed (stdio server → download_clip).
+  if (writeDesktopConfig(key)) {
+    console.log("✓ Connected Clipbait to Claude Desktop (quit + reopen it to load)");
+  }
+
   console.log("\n🎬 Done! Restart Claude Code, then type:\n    /clipbait https://youtube.com/watch?v=…\n");
 }
 

package/package.json

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