@gobi-ai/cli 1.3.8 → 2.0.0

package/skills/gobi-core/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
 ```
 
 ## list

package/skills/gobi-draft/SKILL.md

@@ -52,7 +52,7 @@ For programmatic/agent usage, always pass `--json` as a **global** option (befor
 
 ```bash
 gobi --json draft list --limit 20
-gobi --json draft add "Concise titles" "Prefer concise titles for brain updates." --action "Apply" --action "Skip" --priority 50
+gobi --json draft add "Concise titles" "Prefer concise titles for vault posts." --action "Apply" --action "Skip" --priority 50
 gobi --json draft action <draftId> 0
 ```
 

package/skills/gobi-homepage/SKILL.md

@@ -8,7 +8,7 @@ description: >-
 
 # Gobi Homepage Developer Guide
 
-A **Gobi Homepage** is a custom HTML page hosted on a vault's webdrive and served as its public homepage at `https://gobispace.com/@{vaultSlug}`. Gobi injects a `window.gobi` bridge before any scripts run, giving the homepage access to vault data, files, brain updates, and chat.
+A **Gobi Homepage** is a custom HTML page hosted on a vault's webdrive and served as its public homepage at `https://gobispace.com/@{vaultSlug}`. Gobi injects a `window.gobi` bridge before any scripts run, giving the homepage access to vault data, files, vault posts, and chat.
 
 > **Sandbox:** The homepage runs in a sandboxed iframe with `origin: null`. Direct `fetch()` / `XMLHttpRequest` calls are blocked by CORS. All data access must go through `window.gobi.*`.
 
@@ -18,9 +18,9 @@ A **Gobi Homepage** is a custom HTML page hosted on a vault's webdrive and serve
 
 1. Create an HTML file in the vault (e.g. `app/home.html`) and upload:
    ```bash
-   gobi sync
+   gobi vault sync
    ```
-2. Set `homepage` in BRAIN.md (homepage property):
+2. Set `homepage` in PUBLISH.md (homepage property):
    - `homepage: "[[app/home.html]]"` — Gobi sidebars visible alongside the homepage
    - `homepage: "[[app/home.html?nav=false]]"` — full-screen, no Gobi chrome
 
@@ -67,10 +67,10 @@ function getFileUrl(path) {
 }
 ```
 
-### Brain Updates
+### Vault posts
 
 ```js
-const { data: updates, pagination } = await gobi.listBrainUpdates({ limit: 10, cursor: null });
+const { data: updates, pagination } = await gobi.listVaultPosts({ limit: 10, cursor: null });
 // updates[i] → {
 //   id: 42,
 //   title: 'New insights',
@@ -88,7 +88,7 @@ for (const u of updates) {
 // Pagination — load the next page using the cursor
 if (pagination.hasMore) {
   const { data: moreUpdates, pagination: nextPage } =
-    await gobi.listBrainUpdates({ limit: 10, cursor: pagination.nextCursor });
+    await gobi.listVaultPosts({ limit: 10, cursor: pagination.nextCursor });
 }
 ```
 
@@ -119,7 +119,7 @@ const { messages, hasMore, nextCursor } = await gobi.loadMessages('sess_abc', {
 //   sendMessage(sessionId, text, options, onDelta)  → Promise<{ content }>
 //
 // options.context tells the AI what the user is looking at:
-//   { brainUpdateId?: number, brainUpdateTitle?: string, filePath?: string }
+//   { postId?: number, postTitle?: string, filePath?: string }
 
 let reply = '';
 await gobi.sendMessage(sessionId, 'Hello', (delta) => {
@@ -129,7 +129,7 @@ await gobi.sendMessage(sessionId, 'Hello', (delta) => {
 
 // With context
 await gobi.sendMessage(sessionId, 'Tell me more', {
-  context: { brainUpdateId: 42, brainUpdateTitle: 'New insights' }
+  context: { postId: 42, postTitle: 'New insights' }
 }, (delta) => { reply += delta; renderReply(reply); });
 
 await gobi.sendMessage(sessionId, 'Explain this', {
@@ -144,7 +144,7 @@ sessionId = crypto.randomUUID();
 
 ## Rendering Markdown
 
-Brain update `content` and any markdown read via `readFile` may contain Obsidian-style wiki embeds (`![[path|width]]`). Resolve them before passing to a renderer.
+Post `content` and any markdown read via `readFile` may contain Obsidian-style wiki embeds (`![[path|width]]`). Resolve them before passing to a renderer.
 
 The examples below use [marked](https://cdn.jsdelivr.net/npm/marked/marked.min.js) — include it in your `<head>`:
 
@@ -204,7 +204,7 @@ Pair with Google Fonts (e.g. Space Grotesk for headings, IBM Plex Mono for meta,
 
 ### Knowledge Graph from BU topics
 
-Brain updates carry a `topics` array. Treat each topic as a node and any two topics co-occurring in the same BU as an edge — you get a force-directed graph of the vault's themes for free. Use [d3](https://cdn.jsdelivr.net/npm/d3@7/dist/d3.min.js).
+Vault posts carry a `topics` array. Treat each topic as a node and any two topics co-occurring in the same post as an edge — you get a force-directed graph of the vault's themes for free. Use [d3](https://cdn.jsdelivr.net/npm/d3@7/dist/d3.min.js).
 
 ```js
 // Separate data-building from rendering so the same graph can be drawn at multiple sizes.
@@ -272,7 +272,7 @@ function openOverlay(renderInto) {
 
 Always restore `body.overflow` on close, and always remove the `keydown` listener.
 
-### Brain update card — preview/full toggle
+### Vault post card — preview/full toggle
 
 Show a truncated card that expands in place on click:
 
@@ -292,7 +292,7 @@ card.onclick = (event) => {
 Empty chat looks dead. Show clickable prompt chips until the first message is sent:
 
 ```js
-const prompts = ['What is this brain about?', 'Summarize the latest update', 'What topics come up most?'];
+const prompts = ['What is this vault about?', 'Summarize the latest post', 'What topics come up most?'];
 chips.innerHTML = prompts.map(p => `<button class="chip">${escapeHtml(p)}</button>`).join('');
 chips.querySelectorAll('.chip').forEach((btn, i) => {
   btn.onclick = () => { input.value = prompts[i]; chips.remove(); input.focus(); };
@@ -361,7 +361,7 @@ Single breakpoint at `768px` is enough for most homepages:
   </div>
 
   <script>
-    document.title = gobi.vault.title || 'Brain';
+    document.title = gobi.vault.title || 'Vault';
 
     // ── Helpers ──────────────────────────────────────
 
@@ -389,11 +389,11 @@ Single breakpoint at `768px` is enough for most homepages:
         `https://gobispace.com/login?redirect_uri=${encodeURIComponent(window.location.href)}`;
     }
 
-    // ── Brain updates ────────────────────────────────
+    // ── Vault posts ──────────────────────────────────
 
     async function loadUpdates() {
       try {
-        const { data: updates } = await gobi.listBrainUpdates({ limit: 5 });
+        const { data: updates } = await gobi.listVaultPosts({ limit: 5 });
         const el = document.getElementById('updates');
         for (const u of updates) {
           const div = document.createElement('div');
@@ -402,7 +402,7 @@ Single breakpoint at `768px` is enough for most homepages:
           el.appendChild(div);
         }
       } catch (err) {
-        console.error('Failed to load brain updates:', err);
+        console.error('Failed to load vault posts:', err);
       }
     }
 

package/skills/gobi-saved/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: gobi-saved
+description: >-
+  Gobi saved commands for the user's personal saved-knowledge collection:
+  saved notes (create/list/get/edit/delete) and saved posts (snapshot a
+  post/reply you bookmarked from feed/space; list/get/delete). Use when the
+  user wants to capture their own notes or bookmark/manage posts they've
+  saved.
+allowed-tools: Bash(gobi:*)
+metadata:
+  author: gobi-ai
+  version: "1.3.9"
+---
+
+# gobi-saved
+
+Gobi saved-knowledge commands (v1.3.9).
+
+Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
+
+## What is "saved"?
+
+`gobi saved` is the user's personal saved-knowledge collection. It has two subgroups:
+
+- **`gobi saved note`** — User-authored notes (private, dated entries).
+- **`gobi saved post`** — Snapshots of posts (or replies) that the user has bookmarked from a space or the global feed.
+
+Both are user-private — only the author can see/edit/delete their own items.
+
+## Timezone
+
+`gobi saved note list` and `gobi saved note create` need a timezone to compute the calendar day. The CLI auto-detects your system timezone via `Intl.DateTimeFormat().resolvedOptions().timeZone`. Override with `--timezone <iana-name>` (e.g. `America/Los_Angeles`).
+
+## Important: JSON Mode
+
+For programmatic/agent usage, always pass `--json` as a **global** option (before the subcommand):
+
+```bash
+gobi --json saved note list --date 2026-04-27
+```
+
+## Available Commands
+
+### Notes
+- `gobi saved note list` — List your notes. Without `--date`, returns recent notes via cursor pagination. With `--date YYYY-MM-DD`, returns all notes for that day.
+- `gobi saved note get <noteId>` — Get a single note by id.
+- `gobi saved note create --content <md>` — Create a note. Use `'-'` for stdin.
+- `gobi saved note edit <noteId>` — Edit a note. Provide `--content` and/or `--agent-id`.
+- `gobi saved note delete <noteId>` — Delete a note you authored.
+
+### Posts
+- `gobi saved post list` — List posts you have saved (paginated). Filter with `--type all|article|space-post`.
+- `gobi saved post get <postId>` — Get a saved post snapshot by post id.
+- `gobi saved post create --source <id>` — Save a post or reply by id. Records a snapshot in your saved-posts collection.
+- `gobi saved post delete <postId>` — Remove a post from your saved-posts collection.
+
+## Reference Documentation
+
+- [gobi saved](references/saved.md)

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

@@ -0,0 +1,52 @@
+# gobi saved
+
+```
+Usage: gobi saved [options] [command]
+
+Saved-knowledge commands (notes and posts).
+
+Options:
+  -h, --help      display help for command
+
+Commands:
+  note            Personal saved notes (create, list, get, edit, delete).
+  post            Saved posts (snapshots of posts and replies you bookmark).
+  help [command]  display help for command
+```
+
+## note
+
+```
+Usage: gobi saved note [options] [command]
+
+Personal saved notes (create, list, get, edit, delete).
+
+Options:
+  -h, --help               display help for command
+
+Commands:
+  list [options]           List your notes. Without --date, returns recent notes via cursor pagination. With --date, returns all notes for that day.
+  get <noteId>             Get a single note by id.
+  create [options]         Create a note. Provide --content (use '-' for stdin) and/or attachments.
+  edit [options] <noteId>  Edit a note. Provide --content and/or --agent-id.
+  delete <noteId>          Delete a note you authored.
+  help [command]           display help for command
+```
+
+## post
+
+```
+Usage: gobi saved post [options] [command]
+
+Saved posts (snapshots of posts and replies you bookmark).
+
+Options:
+  -h, --help        display help for command
+
+Commands:
+  list [options]    List posts you have saved.
+  get <postId>      Get a saved post snapshot by post id.
+  create [options]  Save a post or reply. Records a snapshot in your saved-posts collection.
+  delete <postId>   Remove a post from your saved-posts collection.
+  help [command]    display help for command
+```

package/skills/gobi-space/SKILL.md

@@ -1,11 +1,10 @@
 ---
 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 specific space or in the global
+  public feed. Use when the user wants to read or write posts and replies
+  in their Gobi community. Space and member administration is web-UI only.
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
@@ -14,13 +13,13 @@ metadata:
 
 # gobi-space
 
-Gobi space commands for community interaction (v0.9.13).
+Gobi space and global commands for community interaction (v0.9.13).
 
 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.
+`gobi space` is the main interface for posts within a single space. `gobi global` is the same surface but for posts in the public global feed (no slug). When the user wants to engage with their community — use these commands.
 
 - 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`.
@@ -30,7 +29,7 @@ Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
 `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 +37,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 +46,39 @@ 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).
+- `gobi space list-topic-posts` — List posts 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).
+### Feed
+- `gobi space feed` — List the unified feed (posts and replies, newest first).
 
-### 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.
+### 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 post in a space.
+- `gobi space edit-post <postId>` — Edit a post. You must be the author.
+- `gobi space delete-post <postId>` — Delete a post. 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 create-reply <postId>` — Create a reply to a post in a space.
+- `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.
+
+### Global feed
+`gobi global` is the same surface, but operates on the public global feed (no space slug). Posts are vault-authored and visible across all spaces.
+
+- `gobi global feed` — List the global public feed (posts and replies, newest first).
+- `gobi global list-posts` — List posts in the global feed. Pass `--mine` for your own posts; `--vault-slug <slug>` to filter by vault.
+- `gobi global get-post <postId>` — Get a global post with its ancestors and replies.
+- `gobi global create-post` — Create a post in the global feed (publishes from your vault).
+- `gobi global edit-post <postId>` — Edit a post you authored.
+- `gobi global delete-post <postId>` — Delete a post you authored.
+- `gobi global create-reply <postId>` — Reply to a post in the global feed.
+- `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,140 @@
 ```
 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)
+  --title <title>         New title
+  --content <content>     New content (markdown supported, use "-" for stdin)
   --rich-text <richText>  Rich-text JSON array (mutually exclusive with --content)
   -h, --help              display help for command
 ```
 
-## reply
+## delete-post
+
+```
+Usage: gobi global delete-post [options] <postId>
+
+Delete a post you authored in the global feed.
+
+Options:
+  -h, --help  display help for command
+```
+
+## create-reply
 
 ```
-Usage: gobi global reply [options] <threadId>
+Usage: gobi global create-reply [options] <postId>
 
-Reply to a thread in the global space.
+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
+```