@gobi-ai/cli 1.3.8 → 2.0.1

package/dist/main.js

@@ -6,12 +6,10 @@ import { registerAuthCommand } from "./commands/auth.js";
 import { registerInitCommand, printContext } from "./commands/init.js";
 import { registerSpaceCommand } from "./commands/space.js";
 import { registerGlobalCommand } from "./commands/global.js";
-import { registerBrainCommand } from "./commands/brain.js";
-import { registerFeedCommand } from "./commands/feed.js";
-import { registerNotesCommand } from "./commands/notes.js";
+import { registerVaultCommand } from "./commands/vault.js";
+import { registerSavedCommand } from "./commands/saved.js";
 import { registerSessionsCommand } from "./commands/sessions.js";
 import { registerSenseCommand } from "./commands/sense.js";
-import { registerSyncCommand } from "./commands/sync.js";
 import { registerUpdateCommand } from "./commands/update.js";
 import { registerMediaCommand } from "./commands/media.js";
 import { registerDraftCommand } from "./commands/draft.js";
@@ -37,12 +35,10 @@ export async function cli() {
     registerInitCommand(program);
     registerSpaceCommand(program);
     registerGlobalCommand(program);
-    registerBrainCommand(program);
-    registerFeedCommand(program);
-    registerNotesCommand(program);
+    registerVaultCommand(program);
+    registerSavedCommand(program);
     registerSessionsCommand(program);
     registerSenseCommand(program);
-    registerSyncCommand(program);
     registerUpdateCommand(program);
     registerMediaCommand(program);
     registerDraftCommand(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gobi-ai/cli",
-  "version": "1.3.8",
+  "version": "2.0.1",
   "description": "CLI client for the Gobi collaborative knowledge platform",
   "license": "MIT",
   "type": "module",
@@ -15,7 +15,7 @@
   "keywords": [
     "gobi",
     "cli",
-    "second-brain",
+    "vault",
     "knowledge"
   ],
   "publishConfig": {

package/skills/gobi-core/SKILL.md

@@ -2,19 +2,19 @@
 name: gobi-core
 description: >-
   Core Gobi CLI: authentication (login/logout/status), vault initialization
-  (gobi init), space selection (gobi space warp/list), file sync (gobi sync),
-  CLI updates (gobi update), and session management (list/get/reply to
-  conversations). Use when the user needs to set up Gobi, authenticate,
-  sync files, manage sessions, or update the CLI.
+  (gobi init), space selection (gobi space warp/list), CLI updates (gobi
+  update), and session management (list/get/reply to conversations). Use when
+  the user needs to set up Gobi, authenticate, manage sessions, or update the
+  CLI. File sync is in the gobi-vault skill.
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "0.8.0"
+  version: "2.0.0"
 ---
 
 # gobi-core
 
-Core CLI commands for the Gobi collaborative knowledge platform (v0.8.0).
+Core CLI commands for the Gobi collaborative knowledge platform (v2.0.0).
 
 ## Prerequisites
 
@@ -38,9 +38,11 @@ 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.
+- **Vault**: A filetree-backed knowledge home. A local directory becomes a vault when it contains `.gobi/settings.yaml` with a `vaultSlug`. Each vault has a slug (e.g. `brave-path-zr962w`); public profile is configured by a `PUBLISH.md` document at the vault root and pushed via `gobi vault publish`.
+- **Personal Post**: A post on the author's profile that surfaces in the public global feed. Same `Post` data model as a Space Post — only the scope differs.
+- **Space Post**: A post inside a community space.
+- **Space**: A shared community knowledge area. A user can be a member of one or more spaces; each space contains posts, replies, sessions, and connected vaults.
+- **Draft**: A unit of standing guidance authored by an agent during chat. Each draft carries 0–3 AI-suggested actions the user picks from. The top 5 pending drafts feed the agent's system prompt every turn.
 
 ## First-Time Setup
 
@@ -56,7 +58,7 @@ This is an **interactive** command that:
 1. Logs in automatically if not already authenticated (opens a browser URL for Google OAuth)
 2. Prompts the user to select an existing vault or create a new one
 3. Writes `.gobi/settings.yaml` in the current directory with the chosen vault slug
-4. Creates a `BRAIN.md` file if one doesn't exist
+4. Creates a `PUBLISH.md` file if one doesn't exist
 
 ### Step 2: Select a Space
 
@@ -86,7 +88,7 @@ Check auth status anytime:
 gobi auth status
 ```
 
-**Important for agents**: Before running any `space` command, check if `.gobi/settings.yaml` exists in the current directory with both `vaultSlug` and `selectedSpaceSlug`. If the vault is missing, guide the user through `gobi init`. If only the space is missing, guide the user through `gobi space warp`. These commands require user input (interactive prompts), so the agent cannot run them silently.
+**Important for agents**: Before running any `space` command, check whether `.gobi/settings.yaml` exists in the current directory with both `vaultSlug` and `selectedSpaceSlug`. If the vault is missing, guide the user through `gobi init`. If only the space is missing, guide the user through `gobi space warp`. These commands require user input (interactive prompts), so the agent cannot run them silently. For one-off calls, every command also accepts an explicit `--vault-slug` / `--space-slug` override.
 
 ## Important: JSON Mode
 
@@ -96,7 +98,7 @@ For programmatic/agent usage, always pass `--json` as a **global** option (befor
 gobi --json session list
 ```
 
-JSON responses have the shape `{ "success": true, "data": ... }` on success or `{ "success": false, "error": "..." }` on failure.
+JSON responses have the shape `{ "success": true, "data": ... }` on success or `{ "success": false, "error": "..." }` on failure. Pagination metadata (`pagination: { hasMore, nextCursor }`) ships alongside `data` on list endpoints.
 
 ## Available Commands
 
@@ -111,16 +113,17 @@ JSON responses have the shape `{ "success": true, "data": ... }` on success or `
   - `gobi session get` — Get a session and its messages (paginated).
   - `gobi session list` — List all sessions you are part of, sorted by most recent activity.
   - `gobi session reply` — Send a human reply to a session you are a member of.
-- `gobi sync` — Sync local vault files with Gobi Webdrive.
 - `gobi update` — Update gobi-cli to the latest version.
 
+> File sync (`gobi vault sync`) lives in the **gobi-vault** skill.
+
 ## Reference Documentation
 
 - [gobi auth](references/auth.md)
 - [gobi init](references/init.md)
 - [gobi session](references/session.md)
-- [gobi sync](references/sync.md)
 - [gobi update](references/update.md)
+- [gobi space (list/warp)](references/space.md)
 
 ## Configuration Files
 
@@ -128,7 +131,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` |
+| `PUBLISH.md` | Vault profile document with YAML frontmatter, published via `gobi vault publish` |
 
 ## Environment Variables
 
@@ -136,3 +139,4 @@ JSON responses have the shape `{ "success": true, "data": ... }` on success or `
 |----------|---------|-------------|
 | `GOBI_BASE_URL` | `https://api.joingobi.com` | API server URL |
 | `GOBI_WEBDRIVE_BASE_URL` | `https://webdrive.joingobi.com` | File storage URL |
+| `GOBI_SESSION_ID` | — | Default `--session` for `gobi draft add` (set automatically inside agent runs) |

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

@@ -10,12 +10,12 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "1.4.0"
+  version: "2.0.0"
 ---
 
 # gobi-draft
 
-Gobi draft commands for managing agent-authored drafts (v1.4.0).
+Gobi draft commands for managing agent-authored drafts (v2.0.0).
 
 Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
 
@@ -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 personal 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, personal 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,12 @@ function getFileUrl(path) {
 }
 ```
 
-### Brain Updates
+### Personal posts
+
+> `listVaultPosts` is still accepted as a deprecated alias for back-compat with older homepages — existing applets won't break, but new code should use `listPersonalPosts`.
 
 ```js
-const { data: updates, pagination } = await gobi.listBrainUpdates({ limit: 10, cursor: null });
+const { data: updates, pagination } = await gobi.listPersonalPosts({ limit: 10, cursor: null });
 // updates[i] → {
 //   id: 42,
 //   title: 'New insights',
@@ -88,7 +90,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.listPersonalPosts({ limit: 10, cursor: pagination.nextCursor });
 }
 ```
 
@@ -119,7 +121,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 +131,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 +146,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>`:
 
@@ -175,7 +177,7 @@ renderer.link = (href, title, text) =>
 marked.setOptions({ renderer });
 ```
 
-**Plain-text previews.** For BU list cards, render a truncated preview with `escapeHtml(content.substring(0, 200))` — don't run markdown on a random substring, it produces broken HTML. Use `marked.parse(resolveWikiImages(content))` only for the full expanded view. Same for chat: `marked.parse(content)` for assistant messages, `escapeHtml(content)` for human messages.
+**Plain-text previews.** For post list cards, render a truncated preview with `escapeHtml(content.substring(0, 200))` — don't run markdown on a random substring, it produces broken HTML. Use `marked.parse(resolveWikiImages(content))` only for the full expanded view. Same for chat: `marked.parse(content)` for assistant messages, `escapeHtml(content)` for human messages.
 
 ---
 
@@ -202,9 +204,9 @@ Centralize colors and spacing in CSS custom properties so restyling is a one-lin
 
 Pair with Google Fonts (e.g. Space Grotesk for headings, IBM Plex Mono for meta, Inter for body) via CDN `<link>`.
 
-### Knowledge Graph from BU topics
+### Knowledge Graph from post 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).
+Personal 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.
@@ -246,7 +248,7 @@ function drawGraph(containerId, w, h, data, opts = {}) {
 ```
 
 Tips:
-- **Enrich the data.** One page of 8 BUs makes a sparse graph. Paginate 3–4 times (cap at ~32 BUs) before building.
+- **Enrich the data.** One page of 8 posts makes a sparse graph. Paginate 3–4 times (cap at ~32 posts) before building.
 - **Cache the built data** in a module-level variable so the full-screen overlay can reuse it without refetching.
 - **Mini vs full presets.** Pass different `opts` — e.g. mini `{nodeRange:[4,16], fontSize:'9px', distance:60, charge:-80}`, full `{nodeRange:[8,32], fontSize:'12px', distance:120, charge:-200}`.
 - Run a **separate simulation** for the full-scale instance — copy the nodes/links rather than sharing references, otherwise both graphs fight over the same positions.
@@ -272,7 +274,7 @@ function openOverlay(renderInto) {
 
 Always restore `body.overflow` on close, and always remove the `keydown` listener.
 
-### Brain update card — preview/full toggle
+### Personal post card — preview/full toggle
 
 Show a truncated card that expands in place on click:
 
@@ -292,7 +294,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 +363,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 +391,11 @@ Single breakpoint at `768px` is enough for most homepages:
         `https://gobispace.com/login?redirect_uri=${encodeURIComponent(window.location.href)}`;
     }
 
-    // ── Brain updates ────────────────────────────────
+    // ── Personal posts ───────────────────────────────
 
     async function loadUpdates() {
       try {
-        const { data: updates } = await gobi.listBrainUpdates({ limit: 5 });
+        const { data: updates } = await gobi.listPersonalPosts({ limit: 5 });
         const el = document.getElementById('updates');
         for (const u of updates) {
           const div = document.createElement('div');
@@ -402,7 +404,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 personal posts:', err);
       }
     }
 

package/skills/gobi-media/SKILL.md

@@ -10,12 +10,12 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "0.8.0"
+  version: "2.0.0"
 ---
 
 # gobi-media
 
-Gobi media generation commands (v0.8.0).
+Gobi media generation commands (v2.0.0).
 
 Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
 

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: "2.0.0"
+---
+
+# gobi-saved
+
+Gobi saved-knowledge commands (v2.0.0).
+
+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-sense/SKILL.md

@@ -7,23 +7,27 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "0.8.0"
+  version: "2.0.0"
 ---
 
 # gobi-sense
 
-Gobi sense commands for activity and transcription data (v0.8.0).
+Gobi sense commands for activity and transcription data (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.
+
+Activities and transcriptions are captured by Gobi Sense (the wearable) and the mobile app, then ingested via the cloud pipeline. The CLI surface is read-only — fetch records in a time range and feed them to whatever analysis you want to run.
 
 ## Important: JSON Mode
 
 For programmatic/agent usage, always pass `--json` as a **global** option (before the subcommand):
 
 ```bash
-gobi --json sense activities --from 2024-01-01 --to 2024-01-31
+gobi --json sense activities --start-time 2026-04-01T00:00:00Z --end-time 2026-04-08T00:00:00Z
 ```
 
+Times are ISO 8601 UTC.
+
 ## Available Commands
 
 - `gobi sense activities` — Fetch activity records within a time range.