@gobi-ai/cli 0.9.4 → 0.9.6

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.3",
+  "version": "0.9.5",
   "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.3",
+      "version": "0.9.5",
       "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.3",
+  "version": "0.9.5",
   "author": {
     "name": "gobi-ai"
   },

package/dist/commands/media.js

@@ -122,7 +122,9 @@ export function registerMediaCommand(program) {
         .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 body = {
             name: opts.name,
             avatarId: opts.avatarId,
@@ -134,10 +136,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;

package/package.json

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

package/skills/gobi-media/SKILL.md

@@ -30,20 +30,48 @@ gobi --json media image-generate --prompt "a sunset over mountains"
 Single command — generate and download in one step:
 
 ```bash
-gobi --json media image-generate --prompt "a sunset over mountains" -o media/sunset.png
+gobi --json media image-generate --prompt "<PROMPT>" -o media/<NAME>.png
 ```
 
+Replace `<NAME>` with a short descriptive slug derived from the prompt (e.g., `happy-family`, `sunset-mountains`).
+
 The `-o` flag implies `--wait` and downloads the image when done.
 
-Then show the result as an embedded vault link: `![[media/sunset.png]]`
+**IMPORTANT: After downloading, show the image using Obsidian wiki-link syntax EXACTLY like this:**
+
+```
+![[media/<NAME>.png]]
+```
+
+Do NOT use markdown image syntax `![](...)` or `gobi://` URLs. Always use `![[media/<NAME>.png]]`.
 
 ### Key rules
-- Use `-o media/<name>.png` to generate AND download in one command. Pick a short descriptive name.
+- Replace `<NAME>` with a descriptive slug — NEVER use example names like `sunset.png` literally.
 - `--name` is **optional** — auto-derived from prompt if omitted.
 - Do NOT use the `downloadUrl` from the response — it is a frontend path, not a direct download link.
 - `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 --name "<NAME>" --avatar-id "<AVATAR_ID>" --voice-id "<VOICE_ID>" --script "<SCRIPT>" -o media/<NAME>.mp4
+```
+
+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: 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