@gobi-ai/cli 0.9.13 → 1.0.0

package/package.json

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

package/skills/gobi-core/SKILL.md

@@ -38,9 +38,8 @@ 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.
+- **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 `BRAIN.md` document at the vault root to configure the vault's public profile and AI agent.
 
 ## First-Time Setup
 
@@ -128,7 +127,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 |
-| `BRAIN.md` | Brain document with YAML frontmatter, published via `gobi brain publish` |
+| `BRAIN.md` | Vault profile document with YAML frontmatter, published via `gobi vault publish` |
 
 ## Environment Variables
 

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

@@ -3,7 +3,7 @@
 ```
 Usage: gobi space [options] [command]
 
-Space commands (threads, replies).
+Space commands. A Space is a shared room of members where they post threads and replies, organized by topics.
 
 Options:
   --space-slug <slug>                       Space slug (overrides .gobi/settings.yaml)
@@ -11,9 +11,12 @@ 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-space/SKILL.md

@@ -1,19 +1,20 @@
 ---
 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.
+  Gobi space commands for community interaction: post threads and
+  replies, browse the unified message feed and topic feeds, walk reply
+  lineage, and post to the global (slugless) space. Use when the user
+  wants to read or write threads and replies in their Gobi community
+  spaces. Space and member administration is web-UI only.
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "0.8.0"
+  version: "0.9.13"
 ---
 
 # gobi-space
 
-Gobi space commands for community interaction (v0.8.0).
+Gobi space commands for community interaction (v0.9.13).
 
 Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
 
@@ -40,19 +41,43 @@ For programmatic/agent usage, always pass `--json` as a **global** option (befor
 gobi --json space list-threads
 ```
 
+> Space and member administration (creating spaces, inviting/approving members, joining/leaving) is web-UI only and not available in the CLI.
+
 ## Available Commands
 
+### Space details
+- `gobi space get` — Get details for a space.
+
+### Topics
 - `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).
+
+### Feed & lineage
+- `gobi space messages` — List the unified message feed (threads and replies, newest first).
+- `gobi space ancestors` — Show the ancestor lineage of a thread or reply (root → immediate parent).
+
+### Threads
 - `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.
+
+### Replies
 - `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.
 
+### Global thread space
+The global thread space has no slug and is visible across all spaces.
+
+- `gobi global messages` — List the global unified message feed (newest first).
+- `gobi global get-thread` — Get a global thread and its direct replies.
+- `gobi global ancestors` — Show the ancestor lineage of a global thread or reply.
+- `gobi global create-thread` — Create a thread in the global space.
+- `gobi global reply` — Reply to a thread in the global space.
+
 ## Reference Documentation
 
 - [gobi space](references/space.md)
+- [gobi global](references/global.md)

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

@@ -0,0 +1,82 @@
+# gobi global
+
+```
+Usage: gobi global [options] [command]
+
+Global thread commands. Global is the platform-wide thread feed visible to everyone on Gobi.
+
+Options:
+  -h, --help                       display help for command
+
+Commands:
+  messages [options]               List the global unified message feed (threads and replies, newest first).
+  get-thread [options] <threadId>  Get a global thread and its direct replies (paginated).
+  ancestors <threadId>             Show the ancestor lineage of a global thread or reply (root → immediate parent).
+  create-thread [options]          Create a global thread (visible platform-wide).
+  reply [options] <threadId>       Reply to a global thread.
+  help [command]                   display help for command
+```
+
+## messages
+
+```
+Usage: gobi global messages [options]
+
+List the global unified message feed (threads and replies, newest first).
+
+Options:
+  --limit <number>   Items per page (default: "20")
+  --cursor <string>  Pagination cursor from previous response
+  -h, --help         display help for command
+```
+
+## get-thread
+
+```
+Usage: gobi global get-thread [options] <threadId>
+
+Get a global thread and its direct replies (paginated).
+
+Options:
+  --limit <number>   Replies per page (default: "20")
+  --cursor <string>  Pagination cursor from previous response
+  -h, --help         display help for command
+```
+
+## ancestors
+
+```
+Usage: gobi global ancestors [options] <threadId>
+
+Show the ancestor lineage of a global thread or reply (root → immediate parent).
+
+Options:
+  -h, --help  display help for command
+```
+
+## create-thread
+
+```
+Usage: gobi global create-thread [options]
+
+Create a global thread (visible platform-wide).
+
+Options:
+  --title <title>         Title of the thread
+  --content <content>     Thread content (markdown supported, use "-" for stdin)
+  --rich-text <richText>  Rich-text JSON array (mutually exclusive with --content)
+  -h, --help              display help for command
+```
+
+## reply
+
+```
+Usage: gobi global reply [options] <threadId>
+
+Reply to a global thread.
+
+Options:
+  --content <content>     Reply content (markdown supported, use "-" for stdin)
+  --rich-text <richText>  Rich-text JSON array (mutually exclusive with --content)
+  -h, --help              display help for command
+```

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

@@ -3,7 +3,7 @@
 ```
 Usage: gobi space [options] [command]
 
-Space commands (threads, replies).
+Space commands. A Space is a shared room of members where they post threads and replies, organized by topics.
 
 Options:
   --space-slug <slug>                       Space slug (overrides .gobi/settings.yaml)
@@ -11,9 +11,12 @@ 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.
@@ -25,6 +28,17 @@ Commands:
   help [command]                            display help for command
 ```
 
+## get
+
+```
+Usage: gobi space get [options] [spaceSlug]
+
+Get details for a space. Pass a slug or omit to use the current space (from .gobi/settings.yaml or --space-slug).
+
+Options:
+  -h, --help  display help for command
+```
+
 ## list-topics
 
 ```
@@ -50,6 +64,30 @@ Options:
   -h, --help         display help for command
 ```
 
+## messages
+
+```
+Usage: gobi space messages [options]
+
+List the unified message feed (threads and replies, newest first) in a space.
+
+Options:
+  --limit <number>   Items per page (default: "20")
+  --cursor <string>  Pagination cursor from previous response
+  -h, --help         display help for command
+```
+
+## ancestors
+
+```
+Usage: gobi space ancestors [options] <threadId>
+
+Show the ancestor lineage of a thread or reply (root → immediate parent).
+
+Options:
+  -h, --help  display help for command
+```
+
 ## get-thread
 
 ```

package/skills/{gobi-brain → gobi-vault}/SKILL.md

@@ -1,55 +1,42 @@
 ---
-name: gobi-brain
+name: gobi-vault
 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.
+  Gobi vault commands for knowledge management: search public vaults by text
+  and semantic similarity, ask vaults questions, and publish/unpublish
+  BRAIN.md. Use when the user wants to search knowledge, ask a vault, or
+  publish their vault document.
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "0.8.0"
+  version: "1.0.0"
 ---
 
-# gobi-brain
+# gobi-vault
 
-Gobi brain commands for knowledge management (v0.8.0).
+Gobi vault commands for knowledge management (v1.0.0).
 
 Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
 
-## Gobi Brain — Knowledge Management
+## Gobi Vault — 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 vault` commands manage your vault: search public vaults, ask them questions, and publish/unpublish your `BRAIN.md`. Public vaults 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.
+> **Vault updates have moved to threads.** To post user-level content, use `gobi global create-thread` (platform-wide global) or `gobi space create-thread` (a specific space). See the **gobi-space** skill.
 
 ## 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"
+gobi --json vault 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.
+- `gobi vault search` — Search public vaults by text and semantic similarity.
+- `gobi vault ask` — Ask a vault a question. Creates a targeted session (1:1 conversation).
+- `gobi vault publish` — Upload BRAIN.md to the vault root on webdrive. Triggers post-processing (vault sync, metadata update, Discord notification).
+- `gobi vault unpublish` — Delete BRAIN.md from the vault on webdrive.
 
 ## BRAIN.md Frontmatter Reference
 
@@ -57,11 +44,11 @@ gobi --json brain search --query "machine learning"
 
 ```yaml
 ---
-title: My Brain
+title: My Vault
 tags:
   - topic1
   - topic2
-description: A short description of what this brain is about.
+description: A short description of what this vault is about.
 thumbnail: "[[BRAIN.png]]"
 homepage: "[[app/home.html?nav=false]]"
 prompt: "[[system-prompt.md]]"
@@ -70,8 +57,8 @@ 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.
+- **`title`** (required) — Display name of the vault.
+- **`description`** (required for public listing) — Short description shown on the vault card and public profile. Without both `title` and `description`, the vault won't appear in the public catalog.
 - **`tags`** — Tags for categorization and discovery. Supports YAML block list or inline array format:
   ```yaml
   # Block list
@@ -82,11 +69,11 @@ prompt: "[[system-prompt.md]]"
   # 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]]"`).
+- **`thumbnail`** — Profile image for the vault 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]]"`).
+- **`prompt`** — Wiki-link to a custom system prompt file for the vault'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.
 
@@ -99,15 +86,15 @@ After editing `BRAIN.md` frontmatter, follow these steps to make your changes li
    ```bash
    gobi sync
    ```
-3. **Publish the brain**:
+3. **Publish the vault**:
    ```bash
-   gobi brain publish
+   gobi vault 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.
+> **Important:** Any time you change `BRAIN.md` frontmatter (e.g. adding or updating `homepage`), you must re-run `gobi vault publish` for the changes to take effect.
 
 ## Reference Documentation
 
-- [gobi brain](references/brain.md)
+- [gobi vault](references/vault.md)

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

@@ -0,0 +1,66 @@
+# gobi vault
+
+```
+Usage: gobi vault [options] [command]
+
+Vault commands. A Vault is your personal knowledge container — search public vaults, ask them questions, and publish your BRAIN.md profile.
+
+Options:
+  -h, --help        display help for command
+
+Commands:
+  search [options]  Search public vaults by text and semantic similarity.
+  ask [options]     Ask a vault a question. Creates a targeted session (1:1 conversation).
+  publish           Upload BRAIN.md to the vault root on webdrive. Triggers post-processing (vault sync, metadata update, Discord notification).
+  unpublish         Delete BRAIN.md from the vault on webdrive.
+  help [command]    display help for command
+```
+
+## search
+
+```
+Usage: gobi vault search [options]
+
+Search public vaults by text and semantic similarity.
+
+Options:
+  --query <query>  Search query
+  -h, --help       display help for command
+```
+
+## ask
+
+```
+Usage: gobi vault ask [options]
+
+Ask a vault a question. Creates a targeted session (1:1 conversation).
+
+Options:
+  --vault-slug <vaultSlug>  Slug of the 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 vault publish [options]
+
+Upload BRAIN.md to the vault root on webdrive. Triggers post-processing (vault sync, metadata update, Discord notification).
+
+Options:
+  -h, --help  display help for command
+```
+
+## unpublish
+
+```
+Usage: gobi vault unpublish [options]
+
+Delete BRAIN.md from the vault on webdrive.
+
+Options:
+  -h, --help  display help for command
+```