@gobi-ai/cli 0.9.3 → 0.9.5

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.2",
+  "version": "0.9.4",
   "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.2",
+      "version": "0.9.4",
       "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.2",
+  "version": "0.9.4",
   "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;

package/package.json

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

package/skills/gobi-media/SKILL.md

@@ -27,24 +27,30 @@ gobi --json media image-generate --prompt "a sunset over mountains"
 
 ## Typical Workflow (Image Generation)
 
-Always follow this two-step flow — generate, then download to vault:
+Single command — generate and download in one step:
 
 ```bash
-# Step 1: Generate (use --wait to poll until complete)
-gobi --json media image-generate --prompt "a sunset over mountains" --wait
-# → returns JSON with jobId
+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.
 
-# Step 2: Download to vault media/ folder
-gobi --json media image-download <jobId> -o media/<name>.png
+**IMPORTANT: After downloading, show the image using Obsidian wiki-link syntax EXACTLY like this:**
+
+```
+![[media/<NAME>.png]]
 ```
 
-Then show the result as an embedded vault link: `![[media/<name>.png]]`
+Do NOT use markdown image syntax `![](...)` or `gobi://` URLs. Always use `![[media/<NAME>.png]]`.
 
 ### Key rules
+- Replace `<NAME>` with a descriptive slug — NEVER use example names like `sunset.png` literally.
 - `--name` is **optional** — auto-derived from prompt if omitted.
-- `--wait` avoids needing a separate `image-status` call.
-- Always download with `-o media/<name>.png` — pick a short descriptive name (e.g., `happy-family.png`).
-- `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,8 +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)
-  -o, --output <path> Output file path (default: {jobId}.{ext} in current directory)
-  -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
 ```