@gobi-ai/cli 0.9.11 → 0.9.13

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

package/dist/commands/brain.js

@@ -259,4 +259,89 @@ export function registerBrainCommand(program) {
         }
         console.log(`Brain update ${updateId} deleted.`);
     });
+    // ── Update Replies (get-update, reply-to-update, edit-update-reply, delete-update-reply) ──
+    brain
+        .command("get-update <updateId>")
+        .description("Get a brain update and its replies (paginated).")
+        .option("--limit <number>", "Replies per page", "20")
+        .option("--cursor <string>", "Pagination cursor from previous response")
+        .option("--full", "Show full reply content without truncation")
+        .action(async (updateId, opts) => {
+        const params = {
+            limit: parseInt(opts.limit, 10),
+        };
+        if (opts.cursor)
+            params.cursor = opts.cursor;
+        const resp = (await apiGet(`/brain-updates/${updateId}`, params));
+        const data = unwrapResp(resp);
+        const pagination = (resp.pagination || {});
+        if (isJsonMode(brain)) {
+            jsonOut({ ...data, pagination });
+            return;
+        }
+        const update = (data.update || data);
+        const replies = (data.replies || []);
+        const author = update.author?.name ||
+            `User ${update.authorId}`;
+        const vault = update.vault?.vaultSlug || "?";
+        const replyLines = [];
+        for (const r of replies) {
+            const rAuthor = r.author?.name ||
+                `User ${r.authorId}`;
+            const text = r.content;
+            const truncated = opts.full || text.length <= 200 ? text : text.slice(0, 200) + "\u2026";
+            replyLines.push(`  - ${rAuthor}: ${truncated} (${r.createdAt})`);
+        }
+        const output = [
+            `Brain Update: ${update.title || "(no title)"}`,
+            `By: ${author} (vault: ${vault}) on ${update.createdAt}`,
+            "",
+            update.content,
+            "",
+            `Replies (${replies.length} items):`,
+            ...replyLines,
+            ...(pagination.hasMore
+                ? [`  Next cursor: ${pagination.nextCursor}`]
+                : []),
+        ].join("\n");
+        console.log(output);
+    });
+    brain
+        .command("reply-to-update <updateId>")
+        .description("Reply to a brain update.")
+        .requiredOption("--content <content>", 'Reply content (markdown supported, use "-" for stdin)')
+        .action(async (updateId, opts) => {
+        const content = opts.content === "-" ? readFileSync("/dev/stdin", "utf8") : opts.content;
+        const resp = (await apiPost(`/brain-updates/${updateId}/replies`, { content }));
+        const reply = unwrapResp(resp);
+        if (isJsonMode(brain)) {
+            jsonOut(reply);
+            return;
+        }
+        console.log(`Reply created!\n  ID: ${reply.id}\n  Created: ${reply.createdAt}`);
+    });
+    brain
+        .command("edit-update-reply <replyId>")
+        .description("Edit a brain update reply. You must be the author.")
+        .requiredOption("--content <content>", "New content for the reply (markdown supported)")
+        .action(async (replyId, opts) => {
+        const resp = (await apiPatch(`/brain-updates/replies/${replyId}`, { content: opts.content }));
+        const reply = unwrapResp(resp);
+        if (isJsonMode(brain)) {
+            jsonOut(reply);
+            return;
+        }
+        console.log(`Reply edited!\n  ID: ${reply.id}\n  Edited: ${reply.editedAt}`);
+    });
+    brain
+        .command("delete-update-reply <replyId>")
+        .description("Delete a brain update reply. You must be the author.")
+        .action(async (replyId) => {
+        await apiDelete(`/brain-updates/replies/${replyId}`);
+        if (isJsonMode(brain)) {
+            jsonOut({ replyId });
+            return;
+        }
+        console.log(`Brain update reply ${replyId} deleted.`);
+    });
 }

package/package.json

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

package/skills/gobi-brain/SKILL.md

@@ -51,6 +51,63 @@ gobi --json brain search --query "machine learning"
 - `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.
 
+## BRAIN.md Frontmatter Reference
+
+`BRAIN.md` is the metadata file at the root of every vault. Its YAML frontmatter controls the vault's public profile, homepage, and AI agent behavior. Example:
+
+```yaml
+---
+title: My Brain
+tags:
+  - topic1
+  - topic2
+description: A short description of what this brain is about.
+thumbnail: "[[BRAIN.png]]"
+homepage: "[[app/home.html?nav=false]]"
+prompt: "[[system-prompt.md]]"
+---
+```
+
+### Fields
+
+- **`title`** (required) — Display name of the brain/vault.
+- **`description`** (required for public listing) — Short description shown on the brain card and public profile. Without both `title` and `description`, the brain won't appear in the public catalog.
+- **`tags`** — Tags for categorization and discovery. Supports YAML block list or inline array format:
+  ```yaml
+  # Block list
+  tags:
+    - ambient ai
+    - wearables
+
+  # Inline array
+  tags: [ambient ai, wearables]
+  ```
+- **`thumbnail`** — Profile image for the brain card. Uses wiki-link syntax pointing to an image file in the vault (e.g. `"[[BRAIN.png]]"`).
+- **`homepage`** — Custom HTML page to serve as the vault's public homepage at `gobispace.com/@{vaultSlug}`. Uses wiki-link syntax pointing to an HTML file in the vault. Supports a `nav` query parameter to control Gobi's sidebar navigation:
+  - `"[[app/home.html]]"` — Shows the Gobi sidebar alongside the homepage (default)
+  - `"[[app/home.html?nav=false]]"` — Full-screen, no Gobi sidebar/chrome
+- **`prompt`** — Wiki-link to a custom system prompt file for the brain's AI agent (e.g. `"[[system-prompt.md]]"`).
+
+> For details on building custom HTML homepages and using the `window.gobi` API, see the **gobi-homepage** skill.
+
+## Publishing Workflow
+
+After editing `BRAIN.md` frontmatter, follow these steps to make your changes live:
+
+1. **Edit `BRAIN.md`** in the vault root with the desired frontmatter fields.
+2. **Sync referenced files** — if the homepage HTML, thumbnail image, or prompt file is new or updated, upload them first:
+   ```bash
+   gobi sync
+   ```
+3. **Publish the brain**:
+   ```bash
+   gobi brain publish
+   ```
+   This uploads `BRAIN.md` to webdrive, triggers post-processing that extracts metadata (title, description, tags, thumbnail, homepage path), updates the vault's public profile, and sends a Discord notification.
+4. The vault is now live at `https://gobispace.com/@{vaultSlug}`.
+
+> **Important:** Any time you change `BRAIN.md` frontmatter (e.g. adding or updating `homepage`), you must re-run `gobi brain publish` for the changes to take effect.
+
 ## Reference Documentation
 
 - [gobi brain](references/brain.md)

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

@@ -6,19 +6,23 @@ Usage: gobi brain [options] [command]
 Brain commands (search, ask, publish, unpublish, updates).
 
 Options:
-  -h, --help                        display help for command
+  -h, --help                             display help for command
 
 Commands:
-  search [options]                  Search public brains by text and semantic similarity.
-  ask [options]                     Ask a brain a question. Creates a targeted session (1:1 conversation).
-  publish                           Upload BRAIN.md to the vault root on webdrive. Triggers post-processing (brain sync, metadata update, Discord notification).
-  unpublish                         Delete BRAIN.md from the vault on webdrive.
-  list-updates [options]            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.
-  post-update [options]             Post a brain update for a vault.
-  edit-update [options] <updateId>  Edit a published brain update. You must be the author.
-  delete-update <updateId>          Delete a published brain update. You must be the author.
-  help [command]                    display help for command
+  search [options]                       Search public brains by text and semantic similarity.
+  ask [options]                          Ask a brain a question. Creates a targeted session (1:1 conversation).
+  publish                                Upload BRAIN.md to the vault root on webdrive. Triggers post-processing (brain sync, metadata update, Discord notification).
+  unpublish                              Delete BRAIN.md from the vault on webdrive.
+  list-updates [options]                 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.
+  post-update [options]                  Post a brain update for a vault.
+  edit-update [options] <updateId>       Edit a published brain update. You must be the author.
+  delete-update <updateId>               Delete a published brain update. You must be the author.
+  get-update [options] <updateId>        Get a brain update and its replies (paginated).
+  reply-to-update [options] <updateId>   Reply to a brain update.
+  edit-update-reply [options] <replyId>  Edit a brain update reply. You must be the author.
+  delete-update-reply <replyId>          Delete a brain update reply. You must be the author.
+  help [command]                         display help for command
 ```
 
 ## search
@@ -126,3 +130,52 @@ Delete a published brain update. You must be the author.
 Options:
   -h, --help  display help for command
 ```
+
+## get-update
+
+```
+Usage: gobi brain get-update [options] <updateId>
+
+Get a brain update and its replies (paginated).
+
+Options:
+  --limit <number>   Replies per page (default: "20")
+  --cursor <string>  Pagination cursor from previous response
+  --full             Show full reply content without truncation
+  -h, --help         display help for command
+```
+
+## reply-to-update
+
+```
+Usage: gobi brain reply-to-update [options] <updateId>
+
+Reply to a brain update.
+
+Options:
+  --content <content>  Reply content (markdown supported, use "-" for stdin)
+  -h, --help           display help for command
+```
+
+## edit-update-reply
+
+```
+Usage: gobi brain edit-update-reply [options] <replyId>
+
+Edit a brain update reply. You must be the author.
+
+Options:
+  --content <content>  New content for the reply (markdown supported)
+  -h, --help           display help for command
+```
+
+## delete-update-reply
+
+```
+Usage: gobi brain delete-update-reply [options] <replyId>
+
+Delete a brain update reply. You must be the author.
+
+Options:
+  -h, --help  display help for command
+```