@gobi-ai/cli 0.9.5 → 0.9.7

package/.claude-plugin/marketplace.json

@@ -4,12 +4,12 @@
     "name": "gobi-ai"
   },
   "description": "Claude Code plugin for the Gobi collaborative knowledge platform CLI",
-  "version": "0.9.4",
+  "version": "0.9.7",
   "plugins": [
     {
       "name": "gobi",
       "description": "Manage the Gobi collaborative knowledge platform from the command line. Search and ask brains, publish brain documents, create threads, manage sessions, generate images and videos.",
-      "version": "0.9.4",
+      "version": "0.9.7",
       "author": {
         "name": "gobi-ai"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "gobi",
   "description": "Manage the Gobi collaborative knowledge platform from the command line",
-  "version": "0.9.4",
+  "version": "0.9.7",
   "author": {
     "name": "gobi-ai"
   },

package/dist/commands/media.js

@@ -116,15 +116,18 @@ export function registerMediaCommand(program) {
     media
         .command("video-create")
         .description("Create an avatar video generation job.")
-        .requiredOption("--name <name>", "Name for the video")
+        .option("--name <name>", "Name for the video (auto-generated if omitted)")
         .requiredOption("--avatar-id <avatarId>", "Avatar to use")
         .requiredOption("--voice-id <voiceId>", "Voice to use")
         .requiredOption("--script <script>", "Script for the avatar to read")
         .option("--background-media-id <backgroundMediaId>", "Background media ID (from upload)")
         .option("--wait", "Poll until generation completes")
+        .option("-o, --output <path>", "Download video to this path when done (implies --wait)")
         .action(async (opts) => {
+        const shouldWait = opts.wait || !!opts.output;
+        const autoName = opts.name || `video-${new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19)}`;
         const body = {
-            name: opts.name,
+            name: autoName,
             avatarId: opts.avatarId,
             voiceId: opts.voiceId,
             script: opts.script,
@@ -134,10 +137,56 @@ export function registerMediaCommand(program) {
         const resp = (await apiPost("/media-gen/videos", body));
         let data = unwrapResp(resp);
         const videoId = data.id || data.videoId;
-        if (opts.wait && videoId) {
+        if (shouldWait && videoId) {
             console.log(`Video ${videoId} queued — polling for completion…`);
             data = await pollStatus(`/media-gen/videos/${videoId}/status`, ["inference_complete", "inference_failed"]);
         }
+        // Download video to file if -o specified
+        if (opts.output && videoId && data.status === "inference_complete") {
+            const token = await getValidToken();
+            const dlUrl = `${BASE_URL}/media-gen/videos/${videoId}/download`;
+            const dlRes = await fetch(dlUrl, {
+                headers: { Authorization: `Bearer ${token}` },
+                redirect: "follow",
+            });
+            if (dlRes.ok) {
+                const { writeFile, mkdir } = await import("fs/promises");
+                const { dirname } = await import("path");
+                const buffer = Buffer.from(await dlRes.arrayBuffer());
+                await mkdir(dirname(opts.output), { recursive: true });
+                await writeFile(opts.output, buffer);
+                const contentType = dlRes.headers.get("content-type") || "video/mp4";
+                if (isJsonMode(media)) {
+                    jsonOut({ ...data, filename: opts.output, contentType, size: buffer.length });
+                    return;
+                }
+                console.log(`Video saved to ${opts.output} (${buffer.length} bytes)`);
+                return;
+            }
+            // If direct download fails, try getting the URL and fetching that
+            const dlRes2 = await fetch(dlUrl, {
+                headers: { Authorization: `Bearer ${token}` },
+                redirect: "manual",
+            });
+            const location = dlRes2.headers.get("location");
+            if (location) {
+                const videoRes = await fetch(location);
+                if (videoRes.ok) {
+                    const { writeFile, mkdir } = await import("fs/promises");
+                    const { dirname } = await import("path");
+                    const buffer = Buffer.from(await videoRes.arrayBuffer());
+                    await mkdir(dirname(opts.output), { recursive: true });
+                    await writeFile(opts.output, buffer);
+                    const contentType = videoRes.headers.get("content-type") || "video/mp4";
+                    if (isJsonMode(media)) {
+                        jsonOut({ ...data, filename: opts.output, contentType, size: buffer.length });
+                        return;
+                    }
+                    console.log(`Video saved to ${opts.output} (${buffer.length} bytes)`);
+                    return;
+                }
+            }
+        }
         if (isJsonMode(media)) {
             jsonOut(data);
             return;
@@ -188,9 +237,57 @@ export function registerMediaCommand(program) {
         .command("video-status <id>")
         .description("Poll video generation status.")
         .option("--wait", "Poll until a terminal state is reached")
+        .option("-o, --output <path>", "Download video to this path when complete (implies --wait)")
         .action(async (id, opts) => {
-        if (opts.wait) {
+        const shouldWait = opts.wait || !!opts.output;
+        if (shouldWait) {
             const data = await pollStatus(`/media-gen/videos/${id}/status`, ["inference_complete", "inference_failed"]);
+            // Download if -o specified and completed
+            if (opts.output && data.status === "inference_complete") {
+                const token = await getValidToken();
+                const dlUrl = `${BASE_URL}/media-gen/videos/${id}/download`;
+                const dlRes = await fetch(dlUrl, {
+                    headers: { Authorization: `Bearer ${token}` },
+                    redirect: "follow",
+                });
+                if (dlRes.ok) {
+                    const { writeFile, mkdir } = await import("fs/promises");
+                    const { dirname } = await import("path");
+                    const buffer = Buffer.from(await dlRes.arrayBuffer());
+                    await mkdir(dirname(opts.output), { recursive: true });
+                    await writeFile(opts.output, buffer);
+                    const contentType = dlRes.headers.get("content-type") || "video/mp4";
+                    if (isJsonMode(media)) {
+                        jsonOut({ ...data, filename: opts.output, contentType, size: buffer.length });
+                        return;
+                    }
+                    console.log(`Video ${id} — ${data.status}\nSaved to ${opts.output} (${buffer.length} bytes)`);
+                    return;
+                }
+                // Try manual redirect
+                const dlRes2 = await fetch(dlUrl, {
+                    headers: { Authorization: `Bearer ${token}` },
+                    redirect: "manual",
+                });
+                const location = dlRes2.headers.get("location");
+                if (location) {
+                    const videoRes = await fetch(location);
+                    if (videoRes.ok) {
+                        const { writeFile, mkdir } = await import("fs/promises");
+                        const { dirname } = await import("path");
+                        const buffer = Buffer.from(await videoRes.arrayBuffer());
+                        await mkdir(dirname(opts.output), { recursive: true });
+                        await writeFile(opts.output, buffer);
+                        const contentType = videoRes.headers.get("content-type") || "video/mp4";
+                        if (isJsonMode(media)) {
+                            jsonOut({ ...data, filename: opts.output, contentType, size: buffer.length });
+                            return;
+                        }
+                        console.log(`Video ${id} — ${data.status}\nSaved to ${opts.output} (${buffer.length} bytes)`);
+                        return;
+                    }
+                }
+            }
             if (isJsonMode(media)) {
                 jsonOut(data);
                 return;
@@ -208,10 +305,57 @@ export function registerMediaCommand(program) {
     });
     media
         .command("video-download <id>")
-        .description("Get the download URL for a completed video.")
-        .action(async (id) => {
+        .description("Download a completed video (or get its URL).")
+        .option("-o, --output <path>", "Save video to this file path")
+        .action(async (id, opts) => {
         const token = await getValidToken();
         const url = `${BASE_URL}/media-gen/videos/${id}/download`;
+        // If -o specified, download directly to file
+        if (opts.output) {
+            const res = await fetch(url, {
+                headers: { Authorization: `Bearer ${token}` },
+                redirect: "follow",
+            });
+            if (res.ok) {
+                const { writeFile, mkdir } = await import("fs/promises");
+                const { dirname } = await import("path");
+                const buffer = Buffer.from(await res.arrayBuffer());
+                await mkdir(dirname(opts.output), { recursive: true });
+                await writeFile(opts.output, buffer);
+                const contentType = res.headers.get("content-type") || "video/mp4";
+                if (isJsonMode(media)) {
+                    jsonOut({ filename: opts.output, contentType, size: buffer.length });
+                    return;
+                }
+                console.log(`Video saved to ${opts.output} (${buffer.length} bytes)`);
+                return;
+            }
+            // If direct follow didn't work, try manual redirect
+            const res2 = await fetch(url, {
+                headers: { Authorization: `Bearer ${token}` },
+                redirect: "manual",
+            });
+            const location = res2.headers.get("location");
+            if (location) {
+                const videoRes = await fetch(location);
+                if (videoRes.ok) {
+                    const { writeFile, mkdir } = await import("fs/promises");
+                    const { dirname } = await import("path");
+                    const buffer = Buffer.from(await videoRes.arrayBuffer());
+                    await mkdir(dirname(opts.output), { recursive: true });
+                    await writeFile(opts.output, buffer);
+                    const contentType = videoRes.headers.get("content-type") || "video/mp4";
+                    if (isJsonMode(media)) {
+                        jsonOut({ filename: opts.output, contentType, size: buffer.length });
+                        return;
+                    }
+                    console.log(`Video saved to ${opts.output} (${buffer.length} bytes)`);
+                    return;
+                }
+            }
+            throw new ApiError(res.status, `/media-gen/videos/${id}/download`, "Failed to download video");
+        }
+        // No -o: just return the URL (existing behavior)
         const res = await fetch(url, {
             headers: { Authorization: `Bearer ${token}` },
             redirect: "manual",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gobi-ai/cli",
-  "version": "0.9.5",
+  "version": "0.9.7",
   "description": "CLI client for the Gobi collaborative knowledge platform",
   "license": "MIT",
   "type": "module",

package/skills/gobi-media/SKILL.md

@@ -52,6 +52,40 @@ Do NOT use markdown image syntax `![](...)` or `gobi://` URLs. Always use `![[me
 - `image-download` takes a **positional** jobId (NOT `--job-id`): `gobi media image-download <jobId>`
 - The `jobId` (or `id`) field is what you pass to `image-download` / `image-status` — NOT `mediaId`.
 
+## Typical Workflow (Video Generation)
+
+Single command — create and download in one step:
+
+```bash
+gobi --json media video-create --avatar-id "<AVATAR_ID>" --voice-id "<VOICE_ID>" --script "<SCRIPT>" -o media/<NAME>.mp4
+```
+
+`--name` is optional (auto-generated if omitted). Replace `<NAME>` with a short descriptive slug. Use `gobi media avatars` and `gobi media voices` to list available IDs.
+
+The `-o` flag implies `--wait` and downloads the video when done.
+
+**IMPORTANT: Avatars are pre-built system avatars ONLY.** You CANNOT create custom avatars from uploaded images. The `gobi media avatars` list is the complete set of available avatars. Do NOT attempt to upload an image and use its mediaId as an avatarId — it will fail.
+
+To use a custom image (e.g. a generated image) as the **background** of a video, upload it first via `upload-init` / `upload-finalize`, then pass the mediaId as `--background-media-id`:
+
+```bash
+# 1. Upload custom image as background
+gobi --json media upload-init --file-name "bg.png" --content-type "image/png" --file-size <SIZE>
+curl -T "media/bg.png" -H "Content-Type: image/png" "<UPLOAD_URL>"
+gobi --json media upload-finalize --media-id "<MEDIA_ID>"
+
+# 2. Create video with pre-built avatar + custom background
+gobi --json media video-create --avatar-id "<AVATAR_ID>" --voice-id "<VOICE_ID>" --script "<SCRIPT>" --background-media-id "<MEDIA_ID>" -o media/<NAME>.mp4
+```
+
+**IMPORTANT: After downloading, show the video using Obsidian wiki-link syntax EXACTLY like this:**
+
+```
+![[media/<NAME>.mp4]]
+```
+
+Do NOT use markdown image/link syntax `![](...)` or `gobi://` URLs. Always use `![[media/<NAME>.mp4]]`.
+
 ## Available Commands
 
 ### Upload
@@ -70,7 +104,7 @@ Do NOT use markdown image syntax `![](...)` or `gobi://` URLs. Always use `![[me
 - `gobi media video-list` — List all videos.
 - `gobi media video-get` — Get video metadata.
 - `gobi media video-status` — Poll video generation status.
-- `gobi media video-download` — Get the download URL for a completed video.
+- `gobi media video-download` — Download a completed video (`-o` to save to file).
 
 ### Images
 

package/skills/gobi-media/references/media.md

@@ -17,7 +17,7 @@ Commands:
   video-list                        List all videos.
   video-get <id>                    Get video metadata.
   video-status [options] <id>       Poll video generation status.
-  video-download <id>               Get the download URL for a completed video.
+  video-download [options] <id>     Download a completed video (or get its URL).
   image-generate [options]          Generate an image from a text prompt. Types: image (default), thumbnail (YouTube-optimized), asset (logo/product). Aspect ratios: 1:1, 16:9, 9:16, 4:3, 3:4
   image-edit [options]              Edit an existing image with a prompt (image-to-image).
   image-inpaint [options]           Inpaint an image region using a mask.
@@ -82,12 +82,13 @@ Usage: gobi media video-create [options]
 Create an avatar video generation job.
 
 Options:
-  --name <name>                              Name for the video
+  --name <name>                              Name for the video (auto-generated if omitted)
   --avatar-id <avatarId>                     Avatar to use
   --voice-id <voiceId>                       Voice to use
   --script <script>                          Script for the avatar to read
   --background-media-id <backgroundMediaId>  Background media ID (from upload)
   --wait                                     Poll until generation completes
+  -o, --output <path>                        Download video to this path when done (implies --wait)
   -h, --help                                 display help for command
 ```
 
@@ -121,8 +122,9 @@ Usage: gobi media video-status [options] <id>
 Poll video generation status.
 
 Options:
-  --wait      Poll until a terminal state is reached
-  -h, --help  display help for command
+  --wait               Poll until a terminal state is reached
+  -o, --output <path>  Download video to this path when complete (implies --wait)
+  -h, --help           display help for command
 ```
 
 ## video-download
@@ -130,10 +132,11 @@ Options:
 ```
 Usage: gobi media video-download [options] <id>
 
-Get the download URL for a completed video.
+Download a completed video (or get its URL).
 
 Options:
-  -h, --help  display help for command
+  -o, --output <path>  Save video to this file path
+  -h, --help           display help for command
 ```
 
 ## image-generate