@gobi-ai/cli 1.1.0 → 1.3.0

package/dist/commands/space.js

@@ -9,27 +9,10 @@ function readContent(value) {
         return readFileSync("/dev/stdin", "utf8");
     return value;
 }
-function formatMessageLine(m) {
-    const isReply = m.parentThreadId != null;
-    const id = `[${isReply ? "r" : "t"}:${m.id}]`;
-    const kind = isReply ? "reply " : "thread";
-    const author = m.author?.name ||
-        `User ${m.authorId ?? "?"}`;
-    let label;
-    if (isReply) {
-        const text = m.content || "";
-        label = text.length > 80 ? text.slice(0, 80) + "…" : text;
-        label = label.replace(/\s+/g, " ").trim();
-    }
-    else {
-        label = m.title || m.content || "";
-    }
-    return `${id} ${kind} ${author}  "${label}"  ${m.createdAt}`;
-}
 export function registerSpaceCommand(program) {
     const space = program
         .command("space")
-        .description("Space commands. A Space is a shared room of members where they post threads and replies, organized by topics.")
+        .description("Space commands (threads, replies).")
         .option("--space-slug <slug>", "Space slug (overrides .gobi/settings.yaml)");
     // ── List spaces ──
     space
@@ -53,23 +36,6 @@ export function registerSpaceCommand(program) {
         }
         console.log(`Spaces (${items.length}):\n` + lines.join("\n"));
     });
-    // ── Get space ──
-    space
-        .command("get [spaceSlug]")
-        .description("Get details for a space. Pass a slug or omit to use the current space (from .gobi/settings.yaml or --space-slug).")
-        .action(async (spaceSlug) => {
-        const slug = spaceSlug || resolveSpaceSlug(space);
-        const resp = (await apiGet(`/spaces/${slug}`));
-        const s = unwrapResp(resp);
-        if (isJsonMode(space)) {
-            jsonOut(s);
-            return;
-        }
-        const desc = s.description ? `\n  Description: ${s.description}` : "";
-        console.log(`Space [${s.slug}] ${s.name}${desc}\n` +
-            `  ID: ${s.id}\n` +
-            `  Created: ${s.createdAt}`);
-    });
     // ── Warp (space selection) ──
     space
         .command("warp [spaceSlug]")
@@ -160,60 +126,6 @@ export function registerSpaceCommand(program) {
             lines.join("\n") +
             footer);
     });
-    // ── Messages (unified feed) ──
-    space
-        .command("messages")
-        .description("List the unified message feed (threads and replies, newest first) in a space.")
-        .option("--limit <number>", "Items per page", "20")
-        .option("--cursor <string>", "Pagination cursor from previous response")
-        .action(async (opts) => {
-        const spaceSlug = resolveSpaceSlug(space);
-        const params = {
-            limit: parseInt(opts.limit, 10),
-        };
-        if (opts.cursor)
-            params.cursor = opts.cursor;
-        const resp = (await apiGet(`/spaces/${spaceSlug}/messages`, params));
-        if (isJsonMode(space)) {
-            jsonOut({
-                items: resp.data || [],
-                pagination: resp.pagination || {},
-            });
-            return;
-        }
-        const items = (resp.data || []);
-        const pagination = (resp.pagination || {});
-        if (!items.length) {
-            console.log("No messages found.");
-            return;
-        }
-        const lines = items.map(formatMessageLine);
-        const footer = pagination.hasMore ? `\n  Next cursor: ${pagination.nextCursor}` : "";
-        console.log(`Messages (${items.length} items, newest first):\n` + lines.join("\n") + footer);
-    });
-    // ── Ancestors ──
-    space
-        .command("ancestors <threadId>")
-        .description("Show the ancestor lineage of a thread or reply (root → immediate parent).")
-        .action(async (threadId) => {
-        const spaceSlug = resolveSpaceSlug(space);
-        const resp = (await apiGet(`/spaces/${spaceSlug}/threads/${threadId}/ancestors`));
-        const data = unwrapResp(resp);
-        const ancestors = (data.ancestors || []);
-        if (isJsonMode(space)) {
-            jsonOut({ ancestors });
-            return;
-        }
-        if (!ancestors.length) {
-            console.log("No ancestors (this is a root thread).");
-            return;
-        }
-        const lines = [];
-        ancestors.forEach((a, i) => {
-            lines.push(`${i + 1}. ${formatMessageLine(a)}`);
-        });
-        console.log(`Ancestors (${ancestors.length} items, root first):\n` + lines.join("\n"));
-    });
     // ── Threads (get, list, create, edit, delete) ──
     space
         .command("get-thread <threadId>")

package/dist/main.js

@@ -5,8 +5,8 @@ import { ApiError, GobiError } from "./errors.js";
 import { registerAuthCommand } from "./commands/auth.js";
 import { registerInitCommand, printContext } from "./commands/init.js";
 import { registerSpaceCommand } from "./commands/space.js";
-import { registerGlobalCommand } from "./commands/global.js";
-import { registerVaultCommand } from "./commands/vault.js";
+import { registerBrainCommand } from "./commands/brain.js";
+import { registerFeedCommand } from "./commands/feed.js";
 import { registerSessionsCommand } from "./commands/sessions.js";
 import { registerSenseCommand } from "./commands/sense.js";
 import { registerSyncCommand } from "./commands/sync.js";
@@ -33,8 +33,8 @@ export async function cli() {
     registerAuthCommand(program);
     registerInitCommand(program);
     registerSpaceCommand(program);
-    registerGlobalCommand(program);
-    registerVaultCommand(program);
+    registerBrainCommand(program);
+    registerFeedCommand(program);
     registerSessionsCommand(program);
     registerSenseCommand(program);
     registerSyncCommand(program);

package/package.json

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

package/skills/gobi-brain/SKILL.md

@@ -0,0 +1,103 @@
+---
+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 (post/edit/delete). Use when the user wants to
+  search knowledge, ask a brain, publish their brain document, or manage
+  their brain updates. To browse the global feed of brain updates from
+  others, see the gobi-feed skill.
+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}`.
+
+## 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 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.
+
+## 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

@@ -0,0 +1,110 @@
+# gobi brain
+
+```
+Usage: gobi brain [options] [command]
+
+Brain commands (search, ask, publish, unpublish, updates).
+
+Options:
+  -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.
+  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
+
+```
+Usage: gobi brain search [options]
+
+Search public brains by text and semantic similarity.
+
+Options:
+  --query <query>  Search query
+  -h, --help       display help for command
+```
+
+## ask
+
+```
+Usage: gobi brain ask [options]
+
+Ask a brain a question. Creates a targeted session (1:1 conversation).
+
+Options:
+  --vault-slug <vaultSlug>  Slug of the brain/vault to ask
+  --question <question>     The question to ask (markdown supported)
+  --rich-text <richText>    Rich-text JSON array (e.g. [{"type":"text","text":"hello"}])
+  --mode <mode>             Session mode: "auto" or "manual"
+  -h, --help                display help for command
+```
+
+## publish
+
+```
+Usage: gobi brain publish [options]
+
+Upload BRAIN.md to the vault root on webdrive. Triggers post-processing (brain sync, metadata update, Discord notification).
+
+Options:
+  -h, --help  display help for command
+```
+
+## unpublish
+
+```
+Usage: gobi brain unpublish [options]
+
+Delete BRAIN.md from the vault on webdrive.
+
+Options:
+  -h, --help  display help for command
+```
+
+## post-update
+
+```
+Usage: gobi brain post-update [options]
+
+Post a brain update for a vault.
+
+Options:
+  --vault-slug <vaultSlug>  Vault slug (overrides .gobi/settings.yaml)
+  --title <title>           Title of the update
+  --content <content>       Update content (markdown supported)
+  --auto-attachments        Upload wiki-linked [[files]] to webdrive before posting
+  -h, --help                display help for command
+```
+
+## edit-update
+
+```
+Usage: gobi brain edit-update [options] <updateId>
+
+Edit a published brain update. You must be the author.
+
+Options:
+  --title <title>           New title for the update
+  --content <content>       New content for the update (markdown supported)
+  --vault-slug <vaultSlug>  Vault slug for attachment uploads (overrides .gobi/settings.yaml)
+  --auto-attachments        Upload wiki-linked [[files]] to webdrive before editing
+  -h, --help                display help for command
+```
+
+## delete-update
+
+```
+Usage: gobi brain delete-update [options] <updateId>
+
+Delete a published brain update. You must be the author.
+
+Options:
+  -h, --help  display help for command
+```

package/skills/gobi-core/SKILL.md

@@ -38,8 +38,9 @@ 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, and connected vaults.
-- **Vault**: A personal knowledge container — a filetree storage of information and knowledge that can also be searched and asked questions like a knowledge base. 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`). Publish a `PUBLISH.md` document at the vault root to configure the vault's public profile and AI agent.
+- **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
 
@@ -55,7 +56,7 @@ 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 `PUBLISH.md` file if one doesn't exist
+4. Creates a `BRAIN.md` file if one doesn't exist
 
 ### Step 2: Select a Space
 
@@ -127,7 +128,7 @@ JSON responses have the shape `{ "success": true, "data": ... }` on success or `
 |------|-------------|
 | `~/.gobi/credentials.json` | Stored authentication tokens (auto-managed) |
 | `.gobi/settings.yaml` | Per-project vault and space configuration |
-| `PUBLISH.md` | Vault profile document with YAML frontmatter, published via `gobi vault publish` |
+| `BRAIN.md` | Brain document with YAML frontmatter, published via `gobi brain publish` |
 
 ## Environment Variables
 

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

@@ -3,7 +3,7 @@
 ```
 Usage: gobi space [options] [command]
 
-Space commands. A Space is a shared room of members where they post threads and replies, organized by topics.
+Space commands (threads, replies).
 
 Options:
   --space-slug <slug>                       Space slug (overrides .gobi/settings.yaml)
@@ -11,12 +11,9 @@ Options:
 
 Commands:
   list                                      List spaces you are a member of.
-  get [spaceSlug]                           Get details for a space. Pass a slug or omit to use the current space (from .gobi/settings.yaml or --space-slug).
   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).
-  messages [options]                        List the unified message feed (threads and replies, newest first) in a space.
-  ancestors <threadId>                      Show the ancestor lineage of a thread or reply (root → immediate parent).
   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.

package/skills/gobi-feed/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: gobi-feed
+description: >-
+  Gobi feed commands for the global brain-update feed: list recent brain
+  updates from people across the platform, read a single update with its
+  replies, and post replies. Use when the user wants to browse what others
+  are sharing, follow public discussions, or join a thread.
+allowed-tools: Bash(gobi:*)
+metadata:
+  author: gobi-ai
+  version: "1.3.0"
+---
+
+# gobi-feed
+
+Gobi feed commands for the global brain-update feed (v1.3.0).
+
+Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
+
+## What is the feed?
+
+The feed is the platform-wide stream of brain updates from public vaults — short posts, learnings, and announcements people share publicly. Use `gobi feed` to read what others are posting and to reply to a discussion.
+
+To post your own brain update, use `gobi brain post-update` (the feed is read-mostly; posts are scoped to your vault).
+
+## Important: JSON Mode
+
+For programmatic/agent usage, always pass `--json` as a **global** option (before the subcommand):
+
+```bash
+gobi --json feed list
+```
+
+## Available Commands
+
+- `gobi feed` — Feed of brain updates from people across the platform.
+  - `gobi feed list` — List recent brain updates from the global public feed.
+  - `gobi feed get` — Get a feed brain update and its replies (paginated).
+  - `gobi feed reply` — Reply to a brain update in the feed.
+
+## Reference Documentation
+
+- [gobi feed](references/feed.md)

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

@@ -0,0 +1,80 @@
+# gobi feed
+
+```
+Usage: gobi feed [options] [command]
+
+Feed of brain updates from people across the platform.
+
+Options:
+  -h, --help                       display help for command
+
+Commands:
+  list [options]                   List recent brain updates from the global public feed.
+  get [options] <updateId>         Get a feed brain update and its replies (paginated).
+  post-reply [options] <updateId>  Post a reply to a brain update in the feed.
+  edit-reply [options] <replyId>   Edit a reply you authored in the feed.
+  delete-reply <replyId>           Delete a reply you authored in the feed.
+  help [command]                   display help for command
+```
+
+## list
+
+```
+Usage: gobi feed list [options]
+
+List recent brain updates from the global public feed.
+
+Options:
+  --limit <number>   Items per page (default: "20")
+  --cursor <string>  Pagination cursor from previous response
+  -h, --help         display help for command
+```
+
+## get
+
+```
+Usage: gobi feed get [options] <updateId>
+
+Get a feed 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
+```
+
+## post-reply
+
+```
+Usage: gobi feed post-reply [options] <updateId>
+
+Post a reply to a brain update in the feed.
+
+Options:
+  --content <content>  Reply content (markdown supported, use "-" for stdin)
+  -h, --help           display help for command
+```
+
+## edit-reply
+
+```
+Usage: gobi feed edit-reply [options] <replyId>
+
+Edit a reply you authored in the feed.
+
+Options:
+  --content <content>  New reply content (markdown supported, use "-" for stdin)
+  -h, --help           display help for command
+```
+
+## delete-reply
+
+```
+Usage: gobi feed delete-reply [options] <replyId>
+
+Delete a reply you authored in the feed.
+
+Options:
+  -h, --help  display help for command
+```