@gobi-ai/cli 0.9.1 → 0.9.3

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

package/dist/commands/media.js

@@ -246,7 +246,7 @@ export function registerMediaCommand(program) {
         .command("image-generate")
         .description("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")
         .requiredOption("--prompt <prompt>", "Text prompt for image generation")
-        .requiredOption("--name <name>", "Name for the generated image")
+        .option("--name <name>", "Name for the generated image (auto-generated from prompt if omitted)")
         .option("--type <type>", "Generation type: image (default), thumbnail (YouTube-optimized), asset (logo/product)")
         .option("--aspect-ratio <aspectRatio>", "Aspect ratio (1:1, 16:9, 9:16, 4:3, 3:4)")
         .option("--negative-prompt <negativePrompt>", "Negative prompt")
@@ -254,9 +254,10 @@ export function registerMediaCommand(program) {
         .option("--reference-media-id <referenceMediaId>", "Reference image media ID")
         .option("--wait", "Poll until generation completes")
         .action(async (opts) => {
+        const name = opts.name || opts.prompt.slice(0, 50).replace(/[^a-zA-Z0-9-_ ]/g, "").trim().replace(/\s+/g, "-");
         const body = {
             prompt: opts.prompt,
-            name: opts.name,
+            name,
         };
         if (opts.type)
             body.type = opts.type;
@@ -403,6 +404,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…`);
@@ -427,16 +429,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.1",
+  "version": "0.9.3",
   "description": "CLI client for the Gobi collaborative knowledge platform",
   "license": "MIT",
   "type": "module",

package/skills/gobi-media/SKILL.md

@@ -25,6 +25,27 @@ For programmatic/agent usage, always pass `--json` as a **global** option (befor
 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:
+
+```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
+
+# Step 2: Download to vault media/ folder
+gobi --json media image-download <jobId> -o media/<name>.png
+```
+
+Then show the result as an embedded vault link: `![[media/<name>.png]]`
+
+### Key rules
+- `--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>`
+
 ## Available Commands
 
 ### Upload

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

@@ -6,23 +6,24 @@ Usage: gobi media [options] [command]
 Media generation commands (videos, images).
 
 Options:
-  -h, --help                      display help for command
+  -h, --help                        display help for command
 
 Commands:
-  upload-init [options]           Get a presigned upload URL for a media file.
-  upload-finalize [options]       Confirm that a media upload is complete.
-  avatars                         List available avatars.
-  voices                          List available voices.
-  video-create [options]          Create an avatar video generation job.
-  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.
-  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.
-  image-status [options] <jobId>  Check image generation job status.
-  help [command]                  display help for command
+  upload-init [options]             Get a presigned upload URL for a media file.
+  upload-finalize [options]         Confirm that a media upload is complete.
+  avatars                           List available avatars.
+  voices                            List available voices.
+  video-create [options]            Create an avatar video generation job.
+  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.
+  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.
+  image-status [options] <jobId>    Check image generation job status.
+  image-download [options] <jobId>  Download a generated image.
+  help [command]                    display help for command
 ```
 
 ## upload-init
@@ -144,7 +145,7 @@ Generate an image from a text prompt. Types: image (default), thumbnail (YouTube
 
 Options:
   --prompt <prompt>                        Text prompt for image generation
-  --name <name>                            Name for the generated image
+  --name <name>                            Name for the generated image (auto-generated from prompt if omitted)
   --type <type>                            Generation type: image (default), thumbnail (YouTube-optimized), asset (logo/product)
   --aspect-ratio <aspectRatio>             Aspect ratio (1:1, 16:9, 9:16, 4:3, 3:4)
   --negative-prompt <negativePrompt>       Negative prompt
@@ -196,3 +197,17 @@ Options:
   --wait      Poll until a terminal state is reached
   -h, --help  display help for command
 ```
+
+## image-download
+
+```
+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
+```