@gobi-ai/cli 0.8.0 → 0.9.1

package/.claude-plugin/marketplace.json

@@ -4,19 +4,23 @@
     "name": "gobi-ai"
   },
   "description": "Claude Code plugin for the Gobi collaborative knowledge platform CLI",
-  "version": "0.7.3",
+  "version": "0.9.0",
   "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.",
-      "version": "0.7.3",
+      "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",
       "author": {
         "name": "gobi-ai"
       },
       "homepage": "https://github.com/gobi-ai/gobi-cli",
       "source": "./",
       "skills": [
-        "./skills/gobi-cli",
+        "./skills/gobi-core",
+        "./skills/gobi-space",
+        "./skills/gobi-brain",
+        "./skills/gobi-media",
+        "./skills/gobi-sense",
         "./skills/gobi-homepage"
       ],
       "commands": "./commands"

package/.claude-plugin/plugin.json

@@ -1,13 +1,17 @@
 {
   "name": "gobi",
   "description": "Manage the Gobi collaborative knowledge platform from the command line",
-  "version": "0.7.3",
+  "version": "0.9.0",
   "author": {
     "name": "gobi-ai"
   },
   "homepage": "https://github.com/gobi-ai/gobi-cli",
   "skills": [
-    "./skills/gobi-cli",
+    "./skills/gobi-core",
+    "./skills/gobi-space",
+    "./skills/gobi-brain",
+    "./skills/gobi-media",
+    "./skills/gobi-sense",
     "./skills/gobi-homepage"
   ],
   "commands": "./commands"

package/dist/commands/media.js

@@ -3,7 +3,7 @@ import { BASE_URL, POLL_MAX_DURATION_MS } from "../constants.js";
 import { getValidToken } from "../auth/manager.js";
 import { ApiError } from "../errors.js";
 import { isJsonMode, jsonOut, unwrapResp } from "./utils.js";
-// ── Polling helper ──
+// ── Helpers ──
 async function pollStatus(path, terminalStates, intervalMs = 3000) {
     const start = Date.now();
     while (Date.now() - start < POLL_MAX_DURATION_MS) {
@@ -12,10 +12,16 @@ async function pollStatus(path, terminalStates, intervalMs = 3000) {
         const status = data.status || "";
         if (terminalStates.includes(status))
             return data;
+        // If no status field but downloadUrl exists, treat as completed
+        if (!status && extractImageUrl(data))
+            return data;
         await new Promise((r) => setTimeout(r, intervalMs));
     }
     throw new Error(`Polling timed out after ${POLL_MAX_DURATION_MS / 1000}s`);
 }
+function extractImageUrl(data) {
+    return (data.downloadUrl || data.download_url || data.url);
+}
 export function registerMediaCommand(program) {
     const media = program
         .command("media")
@@ -278,10 +284,17 @@ export function registerMediaCommand(program) {
             jsonOut(data);
             return;
         }
+        const imgUrl = extractImageUrl(data);
+        const status = data.status || "queued";
         console.log(`Image generation started!\n` +
             `  Job ID: ${jobId}\n` +
-            `  Status: ${data.status || "queued"}\n` +
-            `  Check:  gobi media image-status ${jobId}`);
+            `  Status: ${status}`);
+        if (imgUrl) {
+            console.log(`  Download URL: ${imgUrl}`);
+        }
+        else if (status === "queued" || status === "inference_started" || status === "inference_working") {
+            console.log(`  Check:  gobi media image-status ${jobId}`);
+        }
     });
     media
         .command("image-edit")
@@ -311,9 +324,13 @@ export function registerMediaCommand(program) {
             jsonOut(data);
             return;
         }
+        const imgUrl = extractImageUrl(data);
         console.log(`Image edit started!\n` +
             `  Job ID: ${jobId}\n` +
             `  Status: ${data.status || "queued"}`);
+        if (imgUrl) {
+            console.log(`  Download URL: ${imgUrl}`);
+        }
     });
     media
         .command("image-inpaint")
@@ -345,35 +362,82 @@ export function registerMediaCommand(program) {
             jsonOut(data);
             return;
         }
+        const imgUrl = extractImageUrl(data);
         console.log(`Inpainting started!\n` +
             `  Job ID: ${jobId}\n` +
             `  Status: ${data.status || "queued"}`);
+        if (imgUrl) {
+            console.log(`  Download URL: ${imgUrl}`);
+        }
     });
     media
         .command("image-status <jobId>")
         .description("Check image generation job status.")
         .option("--wait", "Poll until a terminal state is reached")
         .action(async (jobId, opts) => {
+        let data;
         if (opts.wait) {
-            const data = await pollStatus(`/media-gen/images/${jobId}`, [
+            data = await pollStatus(`/media-gen/images/${jobId}`, [
                 "completed",
                 "failed",
                 "inference_complete",
                 "inference_failed",
             ]);
-            if (isJsonMode(media)) {
-                jsonOut(data);
-                return;
-            }
-            console.log(`Image job ${jobId} — status: ${data.status}`);
-            return;
         }
-        const resp = (await apiGet(`/media-gen/images/${jobId}`));
-        const data = unwrapResp(resp);
+        else {
+            const resp = (await apiGet(`/media-gen/images/${jobId}`));
+            data = unwrapResp(resp);
+        }
         if (isJsonMode(media)) {
             jsonOut(data);
             return;
         }
+        const imgUrl = extractImageUrl(data);
         console.log(`Image job ${jobId} — status: ${data.status || "unknown"}`);
+        if (imgUrl) {
+            console.log(`  Download URL: ${imgUrl}`);
+        }
+    });
+    media
+        .command("image-download <jobId>")
+        .description("Download a generated image.")
+        .option("--wait", "Poll until generation completes before downloading")
+        .option("--type <type>", "Image type (image, thumbnail, asset)")
+        .action(async (jobId, opts) => {
+        if (opts.wait) {
+            console.log(`Waiting for image job ${jobId} to complete…`);
+            await pollStatus(`/media-gen/images/${jobId}`, [
+                "completed",
+                "failed",
+                "inference_complete",
+                "inference_failed",
+            ]);
+        }
+        const token = await getValidToken();
+        const query = opts.type ? `?type=${opts.type}` : "";
+        const url = `${BASE_URL}/media-gen/images/${jobId}/download${query}`;
+        const res = await fetch(url, {
+            headers: { Authorization: `Bearer ${token}` },
+        });
+        if (!res.ok) {
+            const text = (await res.text()) || "(no body)";
+            throw new ApiError(res.status, `/media-gen/images/${jobId}/download`, text);
+        }
+        const contentType = res.headers.get("content-type") || "image/png";
+        const ext = contentType.includes("jpeg") || contentType.includes("jpg") ? "jpg"
+            : contentType.includes("webp") ? "webp"
+                : "png";
+        const filename = `${jobId}.${ext}`;
+        if (isJsonMode(media)) {
+            // In JSON mode, return base64-encoded image
+            const buffer = Buffer.from(await res.arrayBuffer());
+            jsonOut({ filename, contentType, size: buffer.length, base64: buffer.toString("base64") });
+            return;
+        }
+        // Write to file
+        const { writeFile } = await import("fs/promises");
+        const buffer = Buffer.from(await res.arrayBuffer());
+        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.8.0",
+  "version": "0.9.1",
   "description": "CLI client for the Gobi collaborative knowledge platform",
   "license": "MIT",
   "type": "module",
@@ -40,7 +40,7 @@
     "dev": "tsx src/index.ts",
     "start": "node dist/index.js",
     "test": "node --test dist/*.test.js dist/**/*.test.js",
-    "generate-skill-docs": "npm run build && npx tsx skills/gobi/scripts/generate-docs.ts",
+    "generate-skill-docs": "npm run build && npx tsx scripts/generate-skill-docs.ts",
     "prepare": "npm run build",
     "prepublishOnly": "npm run build"
   },

package/skills/gobi-brain/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: gobi-brain
+description: >-
+  Gobi brain commands for knowledge management: search public brains by text
+  and semantic similarity, ask brains questions, publish/unpublish BRAIN.md,
+  and manage brain updates (list/post/edit/delete). Use when the user wants
+  to search knowledge, ask a brain, publish their brain document, or manage
+  brain updates.
+allowed-tools: Bash(gobi:*)
+metadata:
+  author: gobi-ai
+  version: "0.8.0"
+---
+
+# gobi-brain
+
+Gobi brain commands for knowledge management (v0.8.0).
+
+Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
+
+## Gobi Brain — Knowledge Management
+
+`gobi brain` commands manage your vault's brain: search across all spaces, ask brains questions, and publish/unpublish your BRAIN.md. Public brains are accessible at `https://gobispace.com/@{vaultSlug}`.
+
+## Space Slug Override
+
+For `gobi brain list-updates`, you can filter by space with a subcommand option:
+
+```bash
+gobi brain list-updates --space-slug <slug>
+```
+
+Note: `--space-slug` is not available on other `brain` subcommands.
+
+## Important: JSON Mode
+
+For programmatic/agent usage, always pass `--json` as a **global** option (before the subcommand):
+
+```bash
+gobi --json brain search --query "machine learning"
+```
+
+## Available Commands
+
+- `gobi brain search` — Search public brains by text and semantic similarity.
+- `gobi brain ask` — Ask a brain a question. Creates a targeted session (1:1 conversation).
+- `gobi brain publish` — Upload BRAIN.md to the vault root on webdrive. Triggers post-processing (brain sync, metadata update, Discord notification).
+- `gobi brain unpublish` — Delete BRAIN.md from the vault on webdrive.
+- `gobi brain list-updates` — List recent brain updates. Without --space-slug, lists all updates for you. With --space-slug, lists updates for that space. Use --mine to show only updates by you.
+- `gobi brain post-update` — Post a brain update for a vault.
+- `gobi brain edit-update` — Edit a published brain update. You must be the author.
+- `gobi brain delete-update` — Delete a published brain update. You must be the author.
+
+## Reference Documentation
+
+- [gobi brain](references/brain.md)

package/skills/{gobi-cli/SKILL.template.md → gobi-core/SKILL.md}

@@ -1,21 +1,20 @@
 ---
-name: gobi-cli
+name: gobi-core
 description: >-
-  Manage the Gobi collaborative knowledge platform from the command line.
-  Gobi space is the user's main channel for social interactions and engaging with
-  the outside world — checking what's happening, reading and writing threads,
-  and collaborating with others.
-  Use when the user wants to interact with Gobi spaces, vaults, brains, threads,
-  sessions, or brain updates.
+  Core Gobi CLI: authentication (login/logout/status), vault initialization
+  (gobi init), space selection (gobi space warp/list), file sync (gobi sync),
+  CLI updates (gobi update), and session management (list/get/reply to
+  conversations). Use when the user needs to set up Gobi, authenticate,
+  sync files, manage sessions, or update the CLI.
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "{{VERSION}}"
+  version: "0.8.0"
 ---
 
-# gobi-cli
+# gobi-core
 
-A CLI client for the Gobi collaborative knowledge platform (v{{VERSION}}).
+Core CLI commands for the Gobi collaborative knowledge platform (v0.8.0).
 
 ## Prerequisites
 
@@ -89,74 +88,39 @@ gobi auth status
 
 **Important for agents**: Before running any `space` command, check if `.gobi/settings.yaml` exists in the current directory with both `vaultSlug` and `selectedSpaceSlug`. If the vault is missing, guide the user through `gobi init`. If only the space is missing, guide the user through `gobi space warp`. These commands require user input (interactive prompts), so the agent cannot run them silently.
 
-## Gobi Space — Community Channel
-
-`gobi space` is the main interface for interacting with the user's Gobi community. When the user asks about what's happening, what others are discussing, or wants to engage with their community — use `gobi space` commands. Think of it as the user's community feed and communication hub.
-
-- When the user wants to explore or catch up on what's happening in their space, invoke `/gobi:space-explore`.
-- When the user wants to share or post learnings from the current session, invoke `/gobi:space-share`.
-
-## Gobi Brain — Knowledge Management
-
-`gobi brain` commands manage your vault's brain: search across all spaces, ask brains questions, and publish/unpublish your BRAIN.md. Public brains are accessible at `https://gobispace.com/@{vaultSlug}`.
-
-## Gobi Session — Conversations
-
-`gobi session` commands manage your conversations: list, read, and reply to sessions.
-
 ## Important: JSON Mode
 
 For programmatic/agent usage, always pass `--json` as a **global** option (before the subcommand) to get structured JSON output:
 
-```bash
-gobi --json space list-threads
-```
-
-or
-
 ```bash
 gobi --json session list
 ```
 
 JSON responses have the shape `{ "success": true, "data": ... }` on success or `{ "success": false, "error": "..." }` on failure.
 
-## Space Slug Override
-
-`gobi space` commands use the space from `.gobi/settings.yaml`. Override it with a parent-level flag:
-
-```bash
-gobi space --space-slug <slug> list-threads
-```
-
-For `gobi brain list-updates`, you can filter by space with a subcommand option:
-
-```bash
-gobi brain list-updates --space-slug <slug>
-```
-
-Note: `--space-slug` is not available on other `brain` subcommands or on `session` commands.
-
 ## Available Commands
 
-{{COMMANDS}}
+- `gobi auth` — Authentication commands.
+  - `gobi auth login` — Log in to Gobi. Opens a browser URL for Google OAuth, then polls until authentication is complete.
+  - `gobi auth status` — Check whether you are currently authenticated with Gobi.
+  - `gobi auth logout` — Log out of Gobi and remove stored credentials.
+- `gobi init` — Log in (if needed) and select or create the vault for the current directory.
+- `gobi space list` — List spaces you are a member of.
+- `gobi space warp` — Select the active space. Pass a slug to warp directly, or omit for interactive selection.
+- `gobi session` — Session commands (get, list, reply).
+  - `gobi session get` — Get a session and its messages (paginated).
+  - `gobi session list` — List all sessions you are part of, sorted by most recent activity.
+  - `gobi session reply` — Send a human reply to a session you are a member of.
+- `gobi sync` — Sync local vault files with Gobi Webdrive.
+- `gobi update` — Update gobi-cli to the latest version.
 
 ## Reference Documentation
 
-{{REFERENCE_TOC}}
-
-## Discovering Options
-
-Run `--help` on any command for details:
-
-```bash
-gobi --help
-gobi auth --help
-gobi space --help
-gobi brain --help
-gobi session --help
-gobi sense --help
-gobi sync --help
-```
+- [gobi auth](references/auth.md)
+- [gobi init](references/init.md)
+- [gobi session](references/session.md)
+- [gobi sync](references/sync.md)
+- [gobi update](references/update.md)
 
 ## Configuration Files
 

package/skills/gobi-core/references/space.md

@@ -0,0 +1,48 @@
+# gobi space
+
+```
+Usage: gobi space [options] [command]
+
+Space commands (threads, replies).
+
+Options:
+  --space-slug <slug>                       Space slug (overrides .gobi/settings.yaml)
+  -h, --help                                display help for command
+
+Commands:
+  list                                      List spaces you are a member of.
+  warp [spaceSlug]                          Select the active space. Pass a slug to warp directly, or omit for interactive selection.
+  list-topics [options]                     List topics in a space, ordered by most recent content linkage.
+  list-topic-threads [options] <topicSlug>  List threads tagged with a topic in a space (cursor-paginated).
+  get-thread [options] <threadId>           Get a thread and its replies (paginated).
+  list-threads [options]                    List threads in a space (paginated).
+  create-thread [options]                   Create a thread in a space.
+  edit-thread [options] <threadId>          Edit a thread. You must be the author.
+  delete-thread <threadId>                  Delete a thread. You must be the author.
+  create-reply [options] <threadId>         Create a reply to a thread in a space.
+  edit-reply [options] <replyId>            Edit a reply. You must be the author.
+  delete-reply <replyId>                    Delete a reply. You must be the author.
+  help [command]                            display help for command
+```
+
+## list
+
+```
+Usage: gobi space list [options]
+
+List spaces you are a member of.
+
+Options:
+  -h, --help  display help for command
+```
+
+## warp
+
+```
+Usage: gobi space warp [options] [spaceSlug]
+
+Select the active space. Pass a slug to warp directly, or omit for interactive selection.
+
+Options:
+  -h, --help  display help for command
+```

package/skills/gobi-media/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: gobi-media
+description: >-
+  Gobi media generation: generate images from text prompts (thumbnails,
+  assets, logos), edit and inpaint images, create avatar videos with voice
+  narration, list available avatars and voices, upload media files. Use when
+  the user wants to generate images, create videos, or manage media.
+allowed-tools: Bash(gobi:*)
+metadata:
+  author: gobi-ai
+  version: "0.8.0"
+---
+
+# gobi-media
+
+Gobi media generation commands (v0.8.0).
+
+Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
+
+## Important: JSON Mode
+
+For programmatic/agent usage, always pass `--json` as a **global** option (before the subcommand):
+
+```bash
+gobi --json media image-generate --prompt "a sunset over mountains"
+```
+
+## Available Commands
+
+### Upload
+
+- `gobi media upload-init` — Get a presigned upload URL for a media file.
+- `gobi media upload-finalize` — Confirm that a media upload is complete.
+
+### Avatars & Voices
+
+- `gobi media avatars` — List available avatars.
+- `gobi media voices` — List available voices.
+
+### Videos
+
+- `gobi media video-create` — Create an avatar video generation job.
+- `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.
+
+### Images
+
+- `gobi media image-generate` — 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
+- `gobi media image-edit` — Edit an existing image with a prompt (image-to-image).
+- `gobi media image-inpaint` — Inpaint an image region using a mask.
+- `gobi media image-status` — Check image generation job status.
+
+## Reference Documentation
+
+- [gobi media](references/media.md)

package/skills/{gobi-cli → gobi-media}/references/media.md

@@ -25,23 +25,6 @@ Commands:
   help [command]                  display help for command
 ```
 
-## Async Workflow
-
-Video and image generation are async:
-1. Call the create/generate endpoint — receive a job ID
-2. Poll with `--wait` or manually check status until terminal state
-3. Retrieve or download the result
-
-## Media Upload
-
-Upload media files (images, videos) for use as backgrounds, references, or masks:
-
-1. `gobi media upload-init` — get a presigned S3 upload URL
-2. PUT your file to the returned `uploadUrl`
-3. `gobi media upload-finalize` — confirm the upload
-
-The returned `mediaId` can then be used with `--background-media-id`, `--reference-media-id`, `--media-id`, or `--mask-media-id`.
-
 ## upload-init
 
 ```

package/skills/gobi-sense/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: gobi-sense
+description: >-
+  Gobi sense commands for activity and transcription data: fetch activity
+  records and transcription records within a time range. Use when the user
+  wants to review their activities or transcriptions from Gobi Sense.
+allowed-tools: Bash(gobi:*)
+metadata:
+  author: gobi-ai
+  version: "0.8.0"
+---
+
+# gobi-sense
+
+Gobi sense commands for activity and transcription data (v0.8.0).
+
+Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
+
+## Important: JSON Mode
+
+For programmatic/agent usage, always pass `--json` as a **global** option (before the subcommand):
+
+```bash
+gobi --json sense activities --from 2024-01-01 --to 2024-01-31
+```
+
+## Available Commands
+
+- `gobi sense activities` — Fetch activity records within a time range.
+- `gobi sense transcriptions` — Fetch transcription records within a time range.
+
+## Reference Documentation
+
+- [gobi sense](references/sense.md)

package/skills/gobi-space/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: gobi-space
+description: >-
+  Gobi space commands for community interaction: list/create/edit/delete
+  threads and replies, browse topics and topic threads, explore what's
+  happening in a space. Use when the user wants to read, write, or manage
+  threads and replies in their Gobi community spaces.
+allowed-tools: Bash(gobi:*)
+metadata:
+  author: gobi-ai
+  version: "0.8.0"
+---
+
+# gobi-space
+
+Gobi space commands for community interaction (v0.8.0).
+
+Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
+
+## Gobi Space — Community Channel
+
+`gobi space` is the main interface for interacting with the user's Gobi community. When the user asks about what's happening, what others are discussing, or wants to engage with their community — use `gobi space` commands. Think of it as the user's community feed and communication hub.
+
+- When the user wants to explore or catch up on what's happening in their space, invoke `/gobi:space-explore`.
+- When the user wants to share or post learnings from the current session, invoke `/gobi:space-share`.
+
+## Space Slug Override
+
+`gobi space` commands use the space from `.gobi/settings.yaml`. Override it with a parent-level flag:
+
+```bash
+gobi space --space-slug <slug> list-threads
+```
+
+## Important: JSON Mode
+
+For programmatic/agent usage, always pass `--json` as a **global** option (before the subcommand):
+
+```bash
+gobi --json space list-threads
+```
+
+## Available Commands
+
+- `gobi space list-topics` — List topics in a space, ordered by most recent content linkage.
+- `gobi space list-topic-threads` — List threads tagged with a topic in a space (cursor-paginated).
+- `gobi space get-thread` — Get a thread and its replies (paginated).
+- `gobi space list-threads` — List threads in a space (paginated).
+- `gobi space create-thread` — Create a thread in a space.
+- `gobi space edit-thread` — Edit a thread. You must be the author.
+- `gobi space delete-thread` — Delete a thread. You must be the author.
+- `gobi space create-reply` — Create a reply to a thread in a space.
+- `gobi space edit-reply` — Edit a reply. You must be the author.
+- `gobi space delete-reply` — Delete a reply. You must be the author.
+
+## Reference Documentation
+
+- [gobi space](references/space.md)

package/skills/{gobi-cli → gobi-space}/references/space.md

@@ -25,28 +25,6 @@ Commands:
   help [command]                            display help for command
 ```
 
-## list
-
-```
-Usage: gobi space list [options]
-
-List spaces you are a member of.
-
-Options:
-  -h, --help  display help for command
-```
-
-## warp
-
-```
-Usage: gobi space warp [options] [spaceSlug]
-
-Select the active space. Pass a slug to warp directly, or omit for interactive selection.
-
-Options:
-  -h, --help  display help for command
-```
-
 ## list-topics
 
 ```

package/skills/gobi-cli/SKILL.md

@@ -1,240 +0,0 @@
----
-name: gobi-cli
-description: >-
-  Manage the Gobi collaborative knowledge platform from the command line.
-  Gobi space is the user's main channel for social interactions and engaging with
-  the outside world — checking what's happening, reading and writing threads,
-  and collaborating with others.
-  Use when the user wants to interact with Gobi spaces, vaults, brains, threads,
-  sessions, brain updates, or media generation (images, videos, thumbnails).
-allowed-tools: Bash(gobi:*)
-metadata:
-  author: gobi-ai
-  version: "0.7.3"
----
-
-# gobi-cli
-
-A CLI client for the Gobi collaborative knowledge platform (v0.7.3).
-
-## Prerequisites
-
-Verify the CLI is installed:
-
-```bash
-gobi --version
-```
-
-If not installed:
-
-```bash
-npm install -g @gobi-ai/cli
-```
-
-Or via Homebrew:
-
-```bash
-brew tap gobi-ai/tap && brew install gobi
-```
-
-## Key Concepts
-
-- **Space**: A shared space for a group or community. A logged-in user can be a member of one or more spaces. A space contains threads, sessions, brain updates, and connected vaults.
-- **Vault**: A filetree storage of information and knowledge. A local directory becomes a vault when it contains `.gobi/settings.yaml` with a vault slug and a space slug. Each vault is identified by a slug (e.g. `brave-path-zr962w`).
-- **Brain**: Another name for a vault when referring to its AI-searchable knowledge. You can search brains, ask them questions, and publish a `BRAIN.md` document to configure your vault's brain.
-
-## First-Time Setup
-
-The CLI requires three setup steps: authentication, vault initialization, and space selection.
-
-### Step 1: Initialize (Login + Vault)
-
-```bash
-gobi init
-```
-
-This is an **interactive** command that:
-1. Logs in automatically if not already authenticated (opens a browser URL for Google OAuth)
-2. Prompts the user to select an existing vault or create a new one
-3. Writes `.gobi/settings.yaml` in the current directory with the chosen vault slug
-4. Creates a `BRAIN.md` file if one doesn't exist
-
-### Step 2: Select a Space
-
-```bash
-gobi space warp
-```
-
-This is an **interactive** command that prompts the user to select a space from their available spaces, then saves it to `.gobi/settings.yaml`.
-
-After both steps, `.gobi/settings.yaml` will contain:
-```yaml
-vaultSlug: brave-path-zr962w
-selectedSpaceSlug: cmds
-```
-
-### Standalone Login
-
-If the user only needs to log in (without vault setup):
-
-```bash
-gobi auth login
-```
-
-Check auth status anytime:
-
-```bash
-gobi auth status
-```
-
-**Important for agents**: Before running any `space` command, check if `.gobi/settings.yaml` exists in the current directory with both `vaultSlug` and `selectedSpaceSlug`. If the vault is missing, guide the user through `gobi init`. If only the space is missing, guide the user through `gobi space warp`. These commands require user input (interactive prompts), so the agent cannot run them silently.
-
-## Gobi Space — Community Channel
-
-`gobi space` is the main interface for interacting with the user's Gobi community. When the user asks about what's happening, what others are discussing, or wants to engage with their community — use `gobi space` commands. Think of it as the user's community feed and communication hub.
-
-- When the user wants to explore or catch up on what's happening in their space, invoke `/gobi:space-explore`.
-- When the user wants to share or post learnings from the current session, invoke `/gobi:space-share`.
-
-## Gobi Brain — Knowledge Management
-
-`gobi brain` commands manage your vault's brain: search across all spaces, ask brains questions, and publish/unpublish your BRAIN.md. Public brains are accessible at `https://gobispace.com/@{vaultSlug}`.
-
-## Gobi Media — Image & Video Generation
-
-`gobi media` commands generate images, thumbnails, assets, and avatar videos using AI. All generation is async: create a job, poll for status (or use `--wait`), then retrieve the result.
-
-- **Images**: Generate from text prompts, edit existing images, or inpaint with masks. Supports types: `image` (default), `thumbnail` (YouTube-optimized), `asset` (logo/product).
-- **Videos**: Create avatar videos with script narration. Choose an avatar and voice, provide a script, and generate a talking-head video.
-- **Upload**: Upload custom media files (backgrounds, references, masks) via presigned S3 URLs for use in generation.
-
-## Gobi Session — Conversations
-
-`gobi session` commands manage your conversations: list, read, and reply to sessions.
-
-## Important: JSON Mode
-
-For programmatic/agent usage, always pass `--json` as a **global** option (before the subcommand) to get structured JSON output:
-
-```bash
-gobi --json space list-threads
-```
-
-or
-
-```bash
-gobi --json session list
-```
-
-JSON responses have the shape `{ "success": true, "data": ... }` on success or `{ "success": false, "error": "..." }` on failure.
-
-## Space Slug Override
-
-`gobi space` commands use the space from `.gobi/settings.yaml`. Override it with a parent-level flag:
-
-```bash
-gobi space --space-slug <slug> list-threads
-```
-
-For `gobi brain list-updates`, you can filter by space with a subcommand option:
-
-```bash
-gobi brain list-updates --space-slug <slug>
-```
-
-Note: `--space-slug` is not available on other `brain` subcommands or on `session` commands.
-
-## Available Commands
-
-- `gobi auth` — Authentication commands.
-  - `gobi auth login` — Log in to Gobi. Opens a browser URL for Google OAuth, then polls until authentication is complete.
-  - `gobi auth status` — Check whether you are currently authenticated with Gobi.
-  - `gobi auth logout` — Log out of Gobi and remove stored credentials.
-- `gobi init` — Log in (if needed) and select or create the vault for the current directory.
-- `gobi space` — Space commands (threads, replies).
-  - `gobi space list` — List spaces you are a member of.
-  - `gobi space warp` — Select the active space. Pass a slug to warp directly, or omit for interactive selection.
-  - `gobi space list-topics` — List topics in a space, ordered by most recent content linkage.
-  - `gobi space list-topic-threads` — List threads tagged with a topic in a space (cursor-paginated).
-  - `gobi space get-thread` — Get a thread and its replies (paginated).
-  - `gobi space list-threads` — List threads in a space (paginated).
-  - `gobi space create-thread` — Create a thread in a space.
-  - `gobi space edit-thread` — Edit a thread. You must be the author.
-  - `gobi space delete-thread` — Delete a thread. You must be the author.
-  - `gobi space create-reply` — Create a reply to a thread in a space.
-  - `gobi space edit-reply` — Edit a reply. You must be the author.
-  - `gobi space delete-reply` — Delete a reply. You must be the author.
-- `gobi brain` — Brain commands (search, ask, publish, unpublish, updates).
-  - `gobi brain search` — Search public brains by text and semantic similarity.
-  - `gobi brain ask` — Ask a brain a question. Creates a targeted session (1:1 conversation).
-  - `gobi brain publish` — Upload BRAIN.md to the vault root on webdrive. Triggers post-processing (brain sync, metadata update, Discord notification).
-  - `gobi brain unpublish` — Delete BRAIN.md from the vault on webdrive.
-  - `gobi brain list-updates` — List recent brain updates. Without --space-slug, lists all updates for you. With --space-slug, lists updates for that space. Use --mine to show only updates by you.
-  - `gobi brain post-update` — Post a brain update for a vault.
-  - `gobi brain edit-update` — Edit a published brain update. You must be the author.
-  - `gobi brain delete-update` — Delete a published brain update. You must be the author.
-- `gobi session` — Session commands (get, list, reply).
-  - `gobi session get` — Get a session and its messages (paginated).
-  - `gobi session list` — List all sessions you are part of, sorted by most recent activity.
-  - `gobi session reply` — Send a human reply to a session you are a member of.
-- `gobi media` — Media generation commands (images, videos).
-  - `gobi media upload-init` — Get a presigned upload URL for a media file. Requires `--file-name`, `--content-type`, `--file-size`.
-  - `gobi media upload-finalize` — Confirm that a media upload is complete.
-  - `gobi media avatars` — List available avatars.
-  - `gobi media voices` — List available voices.
-  - `gobi media video-create` — Create an avatar video generation job. Requires `--name`, `--avatar-id`, `--voice-id`, `--script`.
-  - `gobi media video-list` — List all videos.
-  - `gobi media video-get <id>` — Get video metadata.
-  - `gobi media video-status <id>` — Poll video generation status. Use `--wait` to block until complete.
-  - `gobi media video-download <id>` — Get the download URL for a completed video.
-  - `gobi media image-generate` — Generate an image from a text prompt. Requires `--prompt`, `--name`. Optional: `--type` (image|thumbnail|asset), `--aspect-ratio`, `--negative-prompt`, `--seed`, `--reference-media-id`. Use `--wait` to block until complete.
-  - `gobi media image-edit` — Edit an existing image with a prompt. Requires `--media-id`, `--prompt`, `--name`.
-  - `gobi media image-inpaint` — Inpaint an image region using a mask. Requires `--media-id`, `--mask-media-id`, `--prompt`, `--name`.
-  - `gobi media image-status <jobId>` — Check image generation job status. Use `--wait` to block until complete.
-- `gobi sense` — Sense commands (activities, transcriptions).
-  - `gobi sense activities` — Fetch activity records within a time range.
-  - `gobi sense transcriptions` — Fetch transcription records within a time range.
-- `gobi sync` — Sync local vault files with Gobi Webdrive.
-- `gobi update` — Update gobi-cli to the latest version.
-
-## Reference Documentation
-
-- [gobi auth](references/auth.md)
-- [gobi init](references/init.md)
-- [gobi space](references/space.md)
-- [gobi brain](references/brain.md)
-- [gobi session](references/session.md)
-- [gobi media](references/media.md)
-- [gobi sense](references/sense.md)
-- [gobi sync](references/sync.md)
-- [gobi update](references/update.md)
-
-## Discovering Options
-
-Run `--help` on any command for details:
-
-```bash
-gobi --help
-gobi auth --help
-gobi space --help
-gobi brain --help
-gobi session --help
-gobi media --help
-gobi sense --help
-gobi sync --help
-```
-
-## Configuration Files
-
-| Path | Description |
-|------|-------------|
-| `~/.gobi/credentials.json` | Stored authentication tokens (auto-managed) |
-| `.gobi/settings.yaml` | Per-project vault and space configuration |
-| `BRAIN.md` | Brain document with YAML frontmatter, published via `gobi brain publish` |
-
-## Environment Variables
-
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `GOBI_BASE_URL` | `https://api.joingobi.com` | API server URL |
-| `GOBI_WEBDRIVE_BASE_URL` | `https://webdrive.joingobi.com` | File storage URL |

package/skills/gobi-cli/scripts/generate-docs.ts

@@ -1,199 +0,0 @@
-import { execSync } from "node:child_process";
-import {
-  readFileSync,
-  writeFileSync,
-  mkdirSync,
-  existsSync,
-  readdirSync,
-  unlinkSync,
-} from "node:fs";
-import { join, dirname } from "node:path";
-import { fileURLToPath } from "node:url";
-import { createRequire } from "node:module";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const SKILL_DIR = join(__dirname, "..");
-const REFERENCES_DIR = join(SKILL_DIR, "references");
-const TEMPLATE_PATH = join(SKILL_DIR, "SKILL.template.md");
-const OUTPUT_PATH = join(SKILL_DIR, "SKILL.md");
-const PROJECT_ROOT = join(SKILL_DIR, "..", "..");
-// Read version from package.json
-const require = createRequire(import.meta.url);
-const { version } = require(join(PROJECT_ROOT, "package.json")) as {
-  version: string;
-};
-
-// Use the built dist/index.js so this works in CI without global install
-const GOBI_BIN = join(PROJECT_ROOT, "dist", "index.js");
-
-if (!existsSync(GOBI_BIN)) {
-  console.error(
-    "Error: dist/index.js not found. Run 'npm run build' first."
-  );
-  process.exit(1);
-}
-
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-
-function runHelp(args: string[]): string {
-  const cmd = `node ${GOBI_BIN} ${args.join(" ")} --help`;
-  return execSync(cmd, {
-    encoding: "utf-8",
-    env: { ...process.env, NO_COLOR: "1" },
-    timeout: 10_000,
-  }).trim();
-}
-
-interface CommandInfo {
-  name: string;
-  description: string;
-}
-
-/**
- * Parse Commander.js help output to extract the Commands section.
- * Commander format:
- *   Commands:
- *     name [options]  description
- *     help [command]  display help for command
- */
-function parseCommands(helpText: string): CommandInfo[] {
-  const commands: CommandInfo[] = [];
-  const lines = helpText.split("\n");
-  let inCommands = false;
-
-  for (const line of lines) {
-    if (line.trim() === "Commands:") {
-      inCommands = true;
-      continue;
-    }
-    if (inCommands) {
-      // Match: leading whitespace, command name, possible args, 2+ spaces, description
-      const match = line.match(/^\s{2,}(\S+)\s+.*?\s{2,}(.+)$/);
-      if (match) {
-        const [, name, desc] = match;
-        if (name !== "help") {
-          commands.push({ name, description: desc.trim() });
-        }
-      } else if (line.trim() === "") {
-        break;
-      } else if (commands.length > 0 && line.match(/^\s{10,}\S/)) {
-        // Continuation line of the previous command's wrapped description
-        commands[commands.length - 1].description += " " + line.trim();
-      }
-    }
-  }
-
-  return commands;
-}
-
-// ---------------------------------------------------------------------------
-// Generate reference docs
-// ---------------------------------------------------------------------------
-
-function generateReferenceDoc(
-  commandPath: string[],
-  helpText: string,
-  subcommands: { name: string; helpText: string }[]
-): string {
-  const lines: string[] = [];
-  const fullCommand = ["gobi", ...commandPath].join(" ");
-
-  lines.push(`# ${fullCommand}`);
-  lines.push("");
-  lines.push("```");
-  lines.push(helpText);
-  lines.push("```");
-
-  for (const sub of subcommands) {
-    lines.push("");
-    lines.push(`## ${sub.name}`);
-    lines.push("");
-    lines.push("```");
-    lines.push(sub.helpText);
-    lines.push("```");
-  }
-
-  return lines.join("\n") + "\n";
-}
-
-// ---------------------------------------------------------------------------
-// Main
-// ---------------------------------------------------------------------------
-
-// Ensure references directory exists
-if (!existsSync(REFERENCES_DIR)) {
-  mkdirSync(REFERENCES_DIR, { recursive: true });
-}
-
-// Clean existing generated reference files
-for (const file of readdirSync(REFERENCES_DIR)) {
-  if (file.endsWith(".md")) {
-    unlinkSync(join(REFERENCES_DIR, file));
-  }
-}
-
-// 1. Get top-level commands
-const topHelp = runHelp([]);
-const topCommands = parseCommands(topHelp);
-
-// 2. Generate reference files for each command group
-const referenceFiles: { name: string; path: string; title: string }[] = [];
-const commandLines: string[] = [];
-
-for (const cmd of topCommands) {
-  let cmdHelp: string;
-  try {
-    cmdHelp = runHelp([cmd.name]);
-  } catch {
-    // Leaf command with no subcommands — use top-level help
-    cmdHelp = `${cmd.description}`;
-  }
-
-  const subCommands = parseCommands(cmdHelp);
-
-  // Build command listing
-  commandLines.push(`- \`gobi ${cmd.name}\` — ${cmd.description}`);
-
-  const subHelpTexts: { name: string; helpText: string }[] = [];
-  for (const sub of subCommands) {
-    try {
-      const subHelp = runHelp([cmd.name, sub.name]);
-      subHelpTexts.push({ name: sub.name, helpText: subHelp });
-      commandLines.push(
-        `  - \`gobi ${cmd.name} ${sub.name}\` — ${sub.description}`
-      );
-    } catch {
-      // Skip commands that fail (e.g. interactive-only)
-    }
-  }
-
-  const refContent = generateReferenceDoc([cmd.name], cmdHelp, subHelpTexts);
-  const refFile = `${cmd.name}.md`;
-  writeFileSync(join(REFERENCES_DIR, refFile), refContent);
-  referenceFiles.push({
-    name: refFile,
-    path: `references/${refFile}`,
-    title: `gobi ${cmd.name}`,
-  });
-}
-
-// 3. Build placeholders
-const COMMANDS = commandLines.join("\n");
-const REFERENCE_TOC = referenceFiles
-  .map((ref) => `- [${ref.title}](${ref.path})`)
-  .join("\n");
-
-// 4. Read template and fill placeholders
-let template = readFileSync(TEMPLATE_PATH, "utf-8");
-template = template.replace(/\{\{VERSION\}\}/g, version);
-template = template.replace("{{COMMANDS}}", COMMANDS);
-template = template.replace("{{REFERENCE_TOC}}", REFERENCE_TOC);
-
-// 5. Write generated SKILL.md
-writeFileSync(OUTPUT_PATH, template);
-
-console.log(`Generated SKILL.md (v${version})`);
-console.log(`Generated ${referenceFiles.length} reference files`);