@gobi-ai/cli 1.3.7 → 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

@@ -0,0 +1,74 @@
+---
+name: gobi-draft
+description: >-
+  Gobi draft commands for managing agent-authored drafts: list, get, add,
+  delete, prioritize, action, revise. Each draft carries 0–3 AI-suggested
+  actions; the user picks one with `draft action`. The top-priority pending
+  drafts feed into the agent's system prompt every turn. Use when the user
+  wants to review, organize, or respond to drafts — or when an agent (using
+  gobi-cli as its tool layer) wants to record a draft it just composed.
+allowed-tools: Bash(gobi:*)
+metadata:
+  author: gobi-ai
+  version: "1.4.0"
+---
+
+# gobi-draft
+
+Gobi draft commands for managing agent-authored drafts (v1.4.0).
+
+Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
+
+## What is a draft?
+
+A draft is a unit of standing guidance authored by an agent (in-process during chat, or via `gobi draft add` when the agent uses gobi-cli as its tool layer). Each draft has:
+
+- **title** — short headline (1–200 chars)
+- **content** — the draft text (markdown, 1–8000 chars)
+- **actions** — 0–3 AI-suggested action labels the user can pick from (e.g. "Accept", "Reject", "Schedule for later"). The agent generates these when authoring the draft.
+- **sessionId** — required; the chat session that produced the draft
+- **priority** — lower number = higher priority; default `100`
+- **status** — `pending` until the user picks an action, then `actioned`
+- **revision** — bumped each time the draft is revised
+- **history** — append-only log of `created`, `revised`, `prioritized`, and `actioned` events
+
+The top 5 pending drafts (lowest priority first) are injected into the agent's system prompt every turn — that's how drafts turn into standing instructions.
+
+When invoked from inside an agent run, the runtime exports `GOBI_SESSION_ID` so `gobi draft add` picks it up automatically; otherwise pass `--session <uuid>`.
+
+## Lifecycle
+
+A draft is **authored** by an agent (`gobi draft add` with up to three `--action` flags). The user can then:
+
+- **Take an action**: `gobi draft action <id> <index>` — flips status to `actioned`, the client posts the synthesized message ("Take action 'X' on draft Y") into the originating chat session.
+- **Ask to revise**: `gobi draft revise <id> <comment>` — bumps revision and records the comment. The agent's next turn should produce a fresh `gobi draft revise --title --content --action ...` (or a new `add`) addressing the comment.
+- **Re-prioritize / delete** as bookkeeping.
+
+Only pending drafts can be revised. Picking an action is terminal; the agent can author a fresh draft if the user later changes their mind.
+
+## Important: JSON Mode
+
+For programmatic/agent usage, always pass `--json` as a **global** option (before the subcommand):
+
+```bash
+gobi --json draft list --limit 20
+gobi --json draft add "Concise titles" "Prefer concise titles for vault posts." --action "Apply" --action "Skip" --priority 50
+gobi --json draft action <draftId> 0
+```
+
+JSON mode wraps the response as `{"success": true, "data": <draft>}` (or `{"success": false, "error": "..."}`).
+
+## Available Commands
+
+- `gobi draft` — Drafts authored by your agent during chat. Each carries up to 3 AI-suggested actions. Top-5 pending feed the system prompt; picking an action posts a synthesized message into the originating session.
+  - `gobi draft list` — List drafts (priority ASC, then newest first).
+  - `gobi draft get` — Show one draft with its history and suggested actions.
+  - `gobi draft add` — Add a draft. Pass `--action <label>` up to 3 times to attach AI-suggested actions.
+  - `gobi draft delete` — Delete a draft.
+  - `gobi draft prioritize` — Set priority (lower = higher). Top 5 feed the system prompt.
+  - `gobi draft action` — Take one of the draft's suggested actions by 0-based index. Posts the synthesized message into the originating session.
+  - `gobi draft revise` — Bump the draft to a new revision with a comment, optionally replacing title / content / actions.
+
+## Reference Documentation
+
+- [gobi draft](references/draft.md)

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

@@ -0,0 +1,109 @@
+# gobi draft
+
+```
+Usage: gobi draft [options] [command]
+
+Drafts authored by your agent during chat. Each carries up to 3 AI-suggested actions. Top-5 pending feed the system prompt; picking an action posts a synthesized message into the originating session.
+
+Options:
+  -h, --help                            display help for command
+
+Commands:
+  list [options]                        List drafts (priority ASC, then newest first).
+  get <draftId>                         Show one draft with its history and suggested actions.
+  add [options] <title> <content>       Add a draft. Pass '-' for content to read from stdin. Pass --action up to 3 times to attach AI-suggested actions. Requires a chat session — the agent runtime
+                                        exports GOBI_SESSION_ID automatically; outside that, pass --session.
+  delete <draftId>                      Delete a draft.
+  prioritize <draftId> <priority>       Set priority (lower = higher). Top 5 feed the system prompt.
+  action <draftId> <actionIndex>        Take one of the draft's suggested actions by 0-based index. Marks the draft 'actioned' and the client posts the synthesized message into the originating
+                                        session.
+  revise [options] <draftId> <comment>  Bump the draft to a new revision. Comment is required. Pass --title, --content, and/or --action to update the draft in the same call (--action repeatable, max
+                                        3, replaces all). Pass '-' for any of comment/title/content to read from stdin.
+  help [command]                        display help for command
+```
+
+## list
+
+```
+Usage: gobi draft list [options]
+
+List drafts (priority ASC, then newest first).
+
+Options:
+  --limit <number>  Max drafts to return (1-200) (default: "50")
+  -h, --help        display help for command
+```
+
+## get
+
+```
+Usage: gobi draft get [options] <draftId>
+
+Show one draft with its history and suggested actions.
+
+Options:
+  -h, --help  display help for command
+```
+
+## add
+
+```
+Usage: gobi draft add [options] <title> <content>
+
+Add a draft. Pass '-' for content to read from stdin. Pass --action up to 3 times to attach AI-suggested actions. Requires a chat session — the agent runtime exports GOBI_SESSION_ID automatically;
+outside that, pass --session.
+
+Options:
+  --session <sessionId>  Originating chat session UUID. Falls back to $GOBI_SESSION_ID when set.
+  --priority <number>    Priority (lower = higher), default 100
+  --action <label>       Suggested action label (repeatable, max 3). Each label is what the user sees on the button. (default: [])
+  -h, --help             display help for command
+```
+
+## delete
+
+```
+Usage: gobi draft delete [options] <draftId>
+
+Delete a draft.
+
+Options:
+  -h, --help  display help for command
+```
+
+## prioritize
+
+```
+Usage: gobi draft prioritize [options] <draftId> <priority>
+
+Set priority (lower = higher). Top 5 feed the system prompt.
+
+Options:
+  -h, --help  display help for command
+```
+
+## action
+
+```
+Usage: gobi draft action [options] <draftId> <actionIndex>
+
+Take one of the draft's suggested actions by 0-based index. Marks the draft 'actioned' and the client posts the synthesized message into the originating session.
+
+Options:
+  -h, --help  display help for command
+```
+
+## revise
+
+```
+Usage: gobi draft revise [options] <draftId> <comment>
+
+Bump the draft to a new revision. Comment is required. Pass --title, --content, and/or --action to update the draft in the same call (--action repeatable, max 3, replaces all). Pass '-' for any of
+comment/title/content to read from stdin.
+
+Options:
+  --title <title>      Replacement title
+  --content <content>  Replacement content; pass '-' to read from stdin
+  --action <label>     Replacement suggested action label (repeatable, max 3). When passed, replaces the entire actions array. (default: [])
+  -h, --help           display help for command
+```

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