@gobi-ai/cli 0.9.2 → 0.9.4

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

package/dist/commands/media.js

@@ -253,7 +253,9 @@ export function registerMediaCommand(program) {
         .option("--seed <seed>", "Random seed for reproducibility")
         .option("--reference-media-id <referenceMediaId>", "Reference image media ID")
         .option("--wait", "Poll until generation completes")
+        .option("-o, --output <path>", "Download image to this path when done (implies --wait)")
         .action(async (opts) => {
+        const shouldWait = opts.wait || !!opts.output;
         const name = opts.name || opts.prompt.slice(0, 50).replace(/[^a-zA-Z0-9-_ ]/g, "").trim().replace(/\s+/g, "-");
         const body = {
             prompt: opts.prompt,
@@ -272,7 +274,7 @@ export function registerMediaCommand(program) {
         const resp = (await apiPost("/media-gen/images/generate", body));
         let data = unwrapResp(resp);
         const jobId = data.jobId || data.id;
-        if (opts.wait && jobId) {
+        if (shouldWait && jobId) {
             console.log(`Image job ${jobId} queued — polling for completion…`);
             data = await pollStatus(`/media-gen/images/${jobId}`, [
                 "completed",
@@ -281,6 +283,31 @@ export function registerMediaCommand(program) {
                 "inference_failed",
             ]);
         }
+        // Download image to file if -o specified
+        if (opts.output && data) {
+            const id = data.jobId || data.id;
+            if (id) {
+                const token = await getValidToken();
+                const url = `${BASE_URL}/media-gen/images/${id}/download`;
+                const res = await fetch(url, {
+                    headers: { Authorization: `Bearer ${token}` },
+                });
+                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") || "image/png";
+                    if (isJsonMode(media)) {
+                        jsonOut({ ...data, filename: opts.output, contentType, size: buffer.length });
+                        return;
+                    }
+                    console.log(`Image saved to ${opts.output} (${buffer.length} bytes)`);
+                    return;
+                }
+            }
+        }
         if (isJsonMode(media)) {
             jsonOut(data);
             return;
@@ -404,6 +431,7 @@ export function registerMediaCommand(program) {
         .description("Download a generated image.")
         .option("--wait", "Poll until generation completes before downloading")
         .option("--type <type>", "Image type (image, thumbnail, asset)")
+        .option("-o, --output <path>", "Output file path (default: {jobId}.{ext} in current directory)")
         .action(async (jobId, opts) => {
         if (opts.wait) {
             console.log(`Waiting for image job ${jobId} to complete…`);
@@ -428,16 +456,22 @@ export function registerMediaCommand(program) {
         const ext = contentType.includes("jpeg") || contentType.includes("jpg") ? "jpg"
             : contentType.includes("webp") ? "webp"
                 : "png";
-        const filename = `${jobId}.${ext}`;
+        const filename = opts.output || `${jobId}.${ext}`;
         if (isJsonMode(media)) {
-            // In JSON mode, return base64-encoded image
+            // In JSON mode, save to file and return metadata
+            const { writeFile, mkdir } = await import("fs/promises");
+            const { dirname } = await import("path");
             const buffer = Buffer.from(await res.arrayBuffer());
-            jsonOut({ filename, contentType, size: buffer.length, base64: buffer.toString("base64") });
+            await mkdir(dirname(filename), { recursive: true });
+            await writeFile(filename, buffer);
+            jsonOut({ filename, contentType, size: buffer.length });
             return;
         }
         // Write to file
-        const { writeFile } = await import("fs/promises");
+        const { writeFile, mkdir } = await import("fs/promises");
+        const { dirname } = await import("path");
         const buffer = Buffer.from(await res.arrayBuffer());
+        await mkdir(dirname(filename), { recursive: true });
         await writeFile(filename, buffer);
         console.log(`Image saved to ${filename} (${buffer.length} bytes)`);
     });

package/package.json

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

package/skills/gobi-media/SKILL.md

@@ -27,15 +27,22 @@ gobi --json media image-generate --prompt "a sunset over mountains"
 
 ## Typical Workflow (Image Generation)
 
-Always use `--wait` to poll until completion in a single command:
+Single command — generate and download in one step:
 
 ```bash
-gobi --json media image-generate --prompt "a sunset over mountains" --wait
+gobi --json media image-generate --prompt "a sunset over mountains" -o media/sunset.png
 ```
 
+The `-o` flag implies `--wait` and downloads the image when done.
+
+Then show the result as an embedded vault link: `![[media/sunset.png]]`
+
+### Key rules
+- Use `-o media/<name>.png` to generate AND download in one command. Pick a short descriptive name.
 - `--name` is **optional** — auto-derived from prompt if omitted.
-- `--wait` avoids needing a separate `image-status` call.
-- `image-status` takes a **positional** jobId (NOT `--job-id`): `gobi media image-status <jobId>`
+- 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`.
 
 ## Available Commands
 

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

@@ -152,6 +152,7 @@ Options:
   --seed <seed>                            Random seed for reproducibility
   --reference-media-id <referenceMediaId>  Reference image media ID
   --wait                                   Poll until generation completes
+  -o, --output <path>                      Download image to this path when done (implies --wait)
   -h, --help                               display help for command
 ```
 
@@ -206,7 +207,8 @@ Usage: gobi media image-download [options] <jobId>
 Download a generated image.
 
 Options:
-  --wait         Poll until generation completes before downloading
-  --type <type>  Image type (image, thumbnail, asset)
-  -h, --help     display help for command
+  --wait               Poll until generation completes before downloading
+  --type <type>        Image type (image, thumbnail, asset)
+  -o, --output <path>  Output file path (default: {jobId}.{ext} in current directory)
+  -h, --help           display help for command
 ```