@gobi-ai/cli 1.3.8 → 2.0.1

package/skills/gobi-space/SKILL.md

@@ -1,36 +1,48 @@
 ---
 name: gobi-space
 description: >-
-  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.
+  Gobi space and global commands: read and write posts and replies, browse the
+  unified feed and topic feeds — in a community space (`gobi space`) or in the
+  public global feed of personal posts (`gobi global`). Personal Posts and
+  Space Posts share the same data model; only the scope differs. Use when the
+  user wants to read or write posts and replies. Space and member admin is
+  web-UI only.
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "0.9.13"
+  version: "2.0.0"
 ---
 
 # gobi-space
 
-Gobi space commands for community interaction (v0.9.13).
+Gobi space and global posts (v2.0.0).
 
-Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
+Requires gobi-cli installed and authenticated. See the **gobi-core** skill for setup.
 
-## Gobi Space — Community Channel
+## Two scopes, one data model
 
-`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.
+The same `Post` data type drives both surfaces — the difference is **scope**:
+
+- **Space Post** — `gobi space …` — lives in a community space's feed.
+- **Personal Post** — `gobi global …` — lives on the author's profile (their primary vault) and surfaces in the public global feed.
+
+Anything you can do to a Space Post (reply, edit, delete, attribute to a vault) you can do to a Personal Post.
 
 - 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`.
 
+## Author vault attribution (`--vault-slug`)
+
+Both `gobi space create-post` / `edit-post` and `gobi global create-post` / `edit-post` accept `--vault-slug <slug>`. When set, the slug becomes the post's `authorVaultSlug` — the vault the user is posting on behalf of. The caller must hold `role: 'owner'` on that vault. Pass `--vault-slug ""` on edit to detach.
+
+`--auto-attachments` resolves a vault for upload and **also** uses it as `authorVaultSlug` automatically — one flag, two effects.
+
 ## 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
+gobi space --space-slug <slug> list-posts
 ```
 
 ## Important: JSON Mode
@@ -38,7 +50,7 @@ gobi space --space-slug <slug> list-threads
 For programmatic/agent usage, always pass `--json` as a **global** option (before the subcommand):
 
 ```bash
-gobi --json space list-threads
+gobi --json space list-posts
 ```
 
 > Space and member administration (creating spaces, inviting/approving members, joining/leaving) is web-UI only and not available in the CLI.
@@ -47,35 +59,40 @@ gobi --json space list-threads
 
 ### Space details
 - `gobi space get` — Get details for a space.
+- `gobi space warp` — Select the active 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.
+- `gobi space list-topic-posts` — List posts tagged with a topic in a space (cursor-paginated).
+
+### Feed
+- `gobi space feed` — List the unified feed (posts and replies, newest first).
+
+### Space posts
+- `gobi space list-posts` — List posts in a space (paginated).
+- `gobi space get-post <postId>` — Get a post with its ancestors and replies (paginated). Ancestors and replies are returned together; there is no separate `ancestors` or `list-replies` command.
+- `gobi space create-post` — Create a space post. `--vault-slug` attributes it to a vault you own; `--auto-attachments` uploads `[[wikilinks]]` to that vault and uses it as `authorVaultSlug`.
+- `gobi space edit-post <postId>` — Edit a space post. You must be the author. `--vault-slug ""` detaches the vault.
+- `gobi space delete-post <postId>` — Delete a space post. You must be the author.
+
+### Space replies
+- `gobi space create-reply <postId>` — Create a reply to a space post.
+- `gobi space edit-reply <replyId>` — Edit a reply. You must be the author.
+- `gobi space delete-reply <replyId>` — Delete a reply. You must be the author.
+
+### Personal posts (global feed)
+
+`gobi global` is the same surface for Personal Posts — posts that live on the author's profile and surface in the public global feed.
+
+- `gobi global feed` — List the public global feed (posts and replies, newest first).
+- `gobi global list-posts` — List personal posts. `--mine` for your own; `--vault-slug <slug>` to filter by author vault.
+- `gobi global get-post <postId>` — Get a personal post with its ancestors and replies.
+- `gobi global create-post` — Create a personal post. `--vault-slug` and `--auto-attachments` work the same as on `space create-post`.
+- `gobi global edit-post <postId>` — Edit a personal post you authored. `--vault-slug ""` detaches the vault.
+- `gobi global delete-post <postId>` — Delete a personal post you authored.
+- `gobi global create-reply <postId>` — Reply to a personal post.
+- `gobi global edit-reply <replyId>` — Edit a reply you authored.
+- `gobi global delete-reply <replyId>` — Delete a reply you authored.
 
 ## Reference Documentation
 

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

@@ -3,80 +3,141 @@
 ```
 Usage: gobi global [options] [command]
 
-Global thread space commands (no slug; visible across all spaces).
+Global commands (posts and replies in the public feed across all vaults).
 
 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 thread in the global space.
-  reply [options] <threadId>       Reply to a thread in the global space.
+  feed [options]                   List the global public feed (posts and replies, newest first).
+  list-posts [options]             List posts in the global feed (paginated). Pass --mine to limit to your own posts.
+  get-post [options] <postId>      Get a global post with its ancestors and replies (paginated).
+  create-post [options]            Create a post in the global feed (publishes from your vault).
+  edit-post [options] <postId>     Edit a post you authored in the global feed.
+  delete-post <postId>             Delete a post you authored in the global feed.
+  create-reply [options] <postId>  Reply to a post in the global feed.
+  edit-reply [options] <replyId>   Edit a reply you authored in the global feed.
+  delete-reply <replyId>           Delete a reply you authored in the global feed.
   help [command]                   display help for command
 ```
 
-## messages
+## feed
 
 ```
-Usage: gobi global messages [options]
+Usage: gobi global feed [options]
 
-List the global unified message feed (threads and replies, newest first).
+List the global public feed (posts and replies, newest first).
 
 Options:
   --limit <number>   Items per page (default: "20")
   --cursor <string>  Pagination cursor from previous response
+  --following        Only include posts from authors you follow
   -h, --help         display help for command
 ```
 
-## get-thread
+## list-posts
 
 ```
-Usage: gobi global get-thread [options] <threadId>
+Usage: gobi global list-posts [options]
 
-Get a global thread and its direct replies (paginated).
+List posts in the global feed (paginated). Pass --mine to limit to your own posts.
+
+Options:
+  --limit <number>          Items per page (default: "20")
+  --cursor <string>         Pagination cursor from previous response
+  --mine                    Only include posts authored by you
+  --vault-slug <vaultSlug>  Filter by author vault slug
+  -h, --help                display help for command
+```
+
+## get-post
+
+```
+Usage: gobi global get-post [options] <postId>
+
+Get a global post with its ancestors and 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
 ```
 
-## ancestors
+## create-post
 
 ```
-Usage: gobi global ancestors [options] <threadId>
+Usage: gobi global create-post [options]
 
-Show the ancestor lineage of a global thread or reply (root → immediate parent).
+Create a post in the global feed (publishes from your vault).
 
 Options:
-  -h, --help  display help for command
+  --title <title>           Title of the post
+  --content <content>       Post content (markdown supported, use "-" for stdin)
+  --rich-text <richText>    Rich-text JSON array (mutually exclusive with --content)
+  --vault-slug <vaultSlug>  Author vault slug (overrides .gobi/settings.yaml)
+  --auto-attachments        Upload wiki-linked [[files]] to webdrive before posting
+  -h, --help                display help for command
 ```
 
-## create-thread
+## edit-post
 
 ```
-Usage: gobi global create-thread [options]
+Usage: gobi global edit-post [options] <postId>
 
-Create a thread in the global space.
+Edit a post you authored in the global feed.
 
 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
+  --title <title>           New title
+  --content <content>       New content (markdown supported, use "-" for stdin)
+  --rich-text <richText>    Rich-text JSON array (mutually exclusive with --content)
+  --vault-slug <vaultSlug>  Attribute the post to this vault (sets authorVaultId). Pass an empty string to detach.
+  -h, --help                display help for command
 ```
 
-## reply
+## delete-post
 
 ```
-Usage: gobi global reply [options] <threadId>
+Usage: gobi global delete-post [options] <postId>
 
-Reply to a thread in the global space.
+Delete a post you authored in the global feed.
+
+Options:
+  -h, --help  display help for command
+```
+
+## create-reply
+
+```
+Usage: gobi global create-reply [options] <postId>
+
+Reply to a post in the global feed.
 
 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
 ```
+
+## edit-reply
+
+```
+Usage: gobi global edit-reply [options] <replyId>
+
+Edit a reply you authored in the global feed.
+
+Options:
+  --content <content>  New reply content (markdown supported, use "-" for stdin)
+  -h, --help           display help for command
+```
+
+## delete-reply
+
+```
+Usage: gobi global delete-reply [options] <replyId>
+
+Delete a reply you authored in the global feed.
+
+Options:
+  -h, --help  display help for command
+```

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

@@ -3,29 +3,28 @@
 ```
 Usage: gobi space [options] [command]
 
-Space commands (threads, replies). Space and member admin is web-UI only.
+Space commands (posts, replies). Space and member admin is web-UI only.
 
 Options:
-  --space-slug <slug>                       Space slug (overrides .gobi/settings.yaml)
-  -h, --help                                display help for command
+  --space-slug <slug>                     Space slug (overrides .gobi/settings.yaml)
+  -h, --help                              display help for command
 
 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.
-  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                                    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-posts [options] <topicSlug>  List posts tagged with a topic in a space (cursor-paginated).
+  feed [options]                          List the unified feed (posts and replies, newest first) in a space.
+  get-post [options] <postId>             Get a post with its ancestors and replies (paginated).
+  list-posts [options]                    List posts in a space (paginated).
+  create-post [options]                   Create a post in a space.
+  edit-post [options] <postId>            Edit a post. You must be the author.
+  delete-post <postId>                    Delete a post. You must be the author.
+  create-reply [options] <postId>         Create a reply to a post 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
 ```
 
 ## get
@@ -51,12 +50,12 @@ Options:
   -h, --help        display help for command
 ```
 
-## list-topic-threads
+## list-topic-posts
 
 ```
-Usage: gobi space list-topic-threads [options] <topicSlug>
+Usage: gobi space list-topic-posts [options] <topicSlug>
 
-List threads tagged with a topic in a space (cursor-paginated).
+List posts tagged with a topic in a space (cursor-paginated).
 
 Options:
   --limit <number>   Items per page (default: "20")
@@ -64,12 +63,12 @@ Options:
   -h, --help         display help for command
 ```
 
-## messages
+## feed
 
 ```
-Usage: gobi space messages [options]
+Usage: gobi space feed [options]
 
-List the unified message feed (threads and replies, newest first) in a space.
+List the unified feed (posts and replies, newest first) in a space.
 
 Options:
   --limit <number>   Items per page (default: "20")
@@ -77,23 +76,12 @@ Options:
   -h, --help         display help for command
 ```
 
-## ancestors
+## get-post
 
 ```
-Usage: gobi space ancestors [options] <threadId>
+Usage: gobi space get-post [options] <postId>
 
-Show the ancestor lineage of a thread or reply (root → immediate parent).
-
-Options:
-  -h, --help  display help for command
-```
-
-## get-thread
-
-```
-Usage: gobi space get-thread [options] <threadId>
-
-Get a thread and its replies (paginated).
+Get a post with its ancestors and replies (paginated).
 
 Options:
   --limit <number>   Replies per page (default: "20")
@@ -101,12 +89,12 @@ Options:
   -h, --help         display help for command
 ```
 
-## list-threads
+## list-posts
 
 ```
-Usage: gobi space list-threads [options]
+Usage: gobi space list-posts [options]
 
-List threads in a space (paginated).
+List posts in a space (paginated).
 
 Options:
   --limit <number>   Items per page (default: "20")
@@ -114,42 +102,42 @@ Options:
   -h, --help         display help for command
 ```
 
-## create-thread
+## create-post
 
 ```
-Usage: gobi space create-thread [options]
+Usage: gobi space create-post [options]
 
-Create a thread in a space.
+Create a post in a space.
 
 Options:
-  --title <title>           Title of the thread
-  --content <content>       Thread content (markdown supported)
-  --auto-attachments        Upload wiki-linked [[files]] to webdrive before posting
-  --vault-slug <vaultSlug>  Vault slug for attachment uploads (overrides .gobi/settings.yaml)
+  --title <title>           Title of the post
+  --content <content>       Post content (markdown supported)
+  --auto-attachments        Upload wiki-linked [[files]] to webdrive before posting (also attributes the post to that vault)
+  --vault-slug <vaultSlug>  Attribute the post to this vault (sets authorVaultId). Also used as upload destination for --auto-attachments.
   -h, --help                display help for command
 ```
 
-## edit-thread
+## edit-post
 
 ```
-Usage: gobi space edit-thread [options] <threadId>
+Usage: gobi space edit-post [options] <postId>
 
-Edit a thread. You must be the author.
+Edit a post. You must be the author.
 
 Options:
-  --title <title>           New title for the thread
-  --content <content>       New content for the thread (markdown supported)
-  --auto-attachments        Upload wiki-linked [[files]] to webdrive before editing
-  --vault-slug <vaultSlug>  Vault slug for attachment uploads (overrides .gobi/settings.yaml)
+  --title <title>           New title for the post
+  --content <content>       New content for the post (markdown supported)
+  --auto-attachments        Upload wiki-linked [[files]] to webdrive before editing (also attributes the post to that vault)
+  --vault-slug <vaultSlug>  Attribute the post to this vault (sets authorVaultId). Also used as upload destination for --auto-attachments. Pass an empty string to detach.
   -h, --help                display help for command
 ```
 
-## delete-thread
+## delete-post
 
 ```
-Usage: gobi space delete-thread [options] <threadId>
+Usage: gobi space delete-post [options] <postId>
 
-Delete a thread. You must be the author.
+Delete a post. You must be the author.
 
 Options:
   -h, --help  display help for command
@@ -158,9 +146,9 @@ Options:
 ## create-reply
 
 ```
-Usage: gobi space create-reply [options] <threadId>
+Usage: gobi space create-reply [options] <postId>
 
-Create a reply to a thread in a space.
+Create a reply to a post in a space.
 
 Options:
   --content <content>  Reply content (markdown supported)

package/skills/gobi-vault/SKILL.md

@@ -0,0 +1,92 @@
+---
+name: gobi-vault
+description: >-
+  Gobi vault commands for publishing your vault profile and syncing files:
+  publish/unpublish PUBLISH.md and run the local-to-webdrive sync. Use when
+  the user wants to publish their vault, unpublish it, or push/pull files.
+allowed-tools: Bash(gobi:*)
+metadata:
+  author: gobi-ai
+  version: "2.0.0"
+---
+
+# gobi-vault
+
+Gobi vault commands for publishing your vault profile and syncing files (v2.0.0).
+
+Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
+
+## Gobi Vault
+
+A "vault" is your file-backed knowledge home. Public vaults are accessible at `https://gobispace.com/@{vaultSlug}`. Each vault has a profile written to `PUBLISH.md` at its root; publishing pushes that file to webdrive, which then updates vault metadata and the public profile.
+
+## Important: JSON Mode
+
+For programmatic/agent usage, always pass `--json` as a **global** option (before the subcommand):
+
+```bash
+gobi --json vault publish
+```
+
+## Available Commands
+
+- `gobi vault publish` — Upload `PUBLISH.md` to the vault root on webdrive. Triggers post-processing (vault profile sync, metadata update, Discord notification).
+- `gobi vault unpublish` — Delete `PUBLISH.md` from the vault on webdrive.
+- `gobi vault sync` — Sync local vault files with Gobi Webdrive. Supports `--upload-only`, `--download-only`, `--conflict <ask|server|client|skip>`, `--dry-run`, `--full`, `--path <p>`, `--plan-file`, `--execute`.
+
+## PUBLISH.md Frontmatter Reference
+
+`PUBLISH.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 Vault
+tags:
+  - topic1
+  - topic2
+description: A short description of what this vault is about.
+thumbnail: "[[PROFILE.png]]"
+homepage: "[[app/home.html?nav=false]]"
+prompt: "[[system-prompt.md]]"
+---
+```
+
+### Fields
+
+- **`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
+  tags:
+    - ambient ai
+    - wearables
+
+  # Inline array
+  tags: [ambient ai, wearables]
+  ```
+- **`thumbnail`** — Profile image for the vault card. Uses wiki-link syntax pointing to an image file in the vault (e.g. `"[[PROFILE.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 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.
+
+## Publishing Workflow
+
+After editing `PUBLISH.md` frontmatter, follow these steps to make your changes live:
+
+1. **Edit `PUBLISH.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 vault sync
+   ```
+3. **Publish the vault**:
+   ```bash
+   gobi vault publish
+   ```
+   This uploads `PUBLISH.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 `PUBLISH.md` frontmatter (e.g. adding or updating `homepage`), you must re-run `gobi vault publish` for the changes to take effect.

package/skills/{gobi-core/references/sync.md → gobi-vault/references/vault.md}

@@ -1,7 +1,46 @@
-# gobi sync
+# gobi vault
 
 ```
-Usage: gobi sync [options]
+Usage: gobi vault [options] [command]
+
+Vault commands (publish/unpublish profile, sync files).
+
+Options:
+  -h, --help      display help for command
+
+Commands:
+  publish         Upload PUBLISH.md to the vault root on webdrive. Triggers post-processing (vault sync, metadata update, Discord notification).
+  unpublish       Delete PUBLISH.md from the vault on webdrive.
+  sync [options]  Sync local vault files with Gobi Webdrive.
+  help [command]  display help for command
+```
+
+## publish
+
+```
+Usage: gobi vault publish [options]
+
+Upload PUBLISH.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 PUBLISH.md from the vault on webdrive.
+
+Options:
+  -h, --help  display help for command
+```
+
+## sync
+
+```
+Usage: gobi vault sync [options]
 
 Sync local vault files with Gobi Webdrive.