@gobi-ai/cli 2.0.0 → 2.0.1

package/.claude-plugin/marketplace.json

@@ -4,12 +4,12 @@
     "name": "gobi-ai"
   },
   "description": "Claude Code plugin for the Gobi collaborative knowledge platform CLI",
-  "version": "1.3.8",
+  "version": "2.0.1",
   "plugins": [
     {
       "name": "gobi",
       "description": "Manage the Gobi collaborative knowledge platform from the command line. Publish vault profiles, create posts and replies, manage saved notes and posts, manage sessions, generate images and videos.",
-      "version": "1.3.8",
+      "version": "2.0.1",
       "author": {
         "name": "gobi-ai"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "gobi",
   "description": "Manage the Gobi collaborative knowledge platform from the command line",
-  "version": "1.3.8",
+  "version": "2.0.1",
   "author": {
     "name": "gobi-ai"
   },

package/README.md

@@ -4,7 +4,11 @@
 [![npm](https://img.shields.io/npm/v/@gobi-ai/cli)](https://www.npmjs.com/package/@gobi-ai/cli)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 
-Command-line interface for the [Gobi](https://gobispace.com) collaborative knowledge platform.
+The programmatic interface to [Gobi](https://gobispace.com) — the agent-facing surface of the ecosystem. The same capabilities the desktop and web clients use (auth, vault sync and publishing, personal posts and replies, saved knowledge, drafts, media generation, activity reads) exposed as composable shell commands so AI agents and developer scripts can participate in a user's Brain.
+
+## Why a CLI?
+
+Most Gobi capabilities are interactive surfaces (Desktop, Web, Mobile). The CLI flips that: every command is scriptable, returns structured JSON when asked, and uses headless device-code auth so an agent can run it on any host. If you're building an agent that needs to read from or write to a user's Brain — capture notes, post to a community space, save a snippet, draft a suggestion, generate an image — this is the surface.
 
 ## Installation
 
@@ -34,10 +38,10 @@ npm link
 ## Quick start
 
 ```sh
-# Initialize — logs in and sets up your vault (creates PUBLISH.md)
+# Initialize — log in and set up your vault (creates PUBLISH.md if missing)
 gobi init
 
-# Select a space
+# Select a community space
 gobi space warp
 
 # Publish your vault profile (after editing PUBLISH.md frontmatter)
@@ -46,18 +50,71 @@ gobi vault publish
 # Sync local files with the webdrive
 gobi vault sync
 
-# Browse the global feed and create a post
+# Browse the global feed and create a personal post
 gobi global feed
-gobi global create-post --title "Hello" --content "Trying gobi"
+gobi global create-post --title "Hello" --content "Trying gobi" --vault-slug my-vault
+```
+
+---
+
+## Using gobi from an agent
+
+Everything below applies whether you're building a Claude Code skill, an autonomous agent, or a shell script. The CLI was designed to be agent-driven first.
+
+### JSON envelope
+
+Pass `--json` as a **global flag** (before the subcommand) and every command returns a structured envelope:
+
+```sh
+gobi --json space list-posts
+# {"success": true, "data": [...]}
+
+gobi --json space get-post 99999
+# {"success": false, "error": "Post not found"}
 ```
 
+`success: true` always carries `data`; `success: false` always carries `error`. Pagination metadata (`pagination: { hasMore, nextCursor }`) ships alongside `data` on list endpoints. Skill docs and the `--help` output describe each command's `data` shape.
+
+### Context discovery
+
+The CLI looks up two pieces of state:
+
+| Path | What | Who manages |
+|------|------|-------------|
+| `~/.gobi/credentials.json` | Auth tokens (`accessToken`, `refreshToken`) | `gobi auth login` writes; `gobi auth logout` clears |
+| `.gobi/settings.yaml` | Per-project `vaultSlug` and `selectedSpaceSlug` | `gobi init` and `gobi space warp` write |
+
+An agent should check these before calling commands that need a vault or space:
+
+```sh
+# Are we authenticated?
+gobi --json auth status
+
+# Discover the project's defaults
+cat .gobi/settings.yaml 2>/dev/null
+```
+
+If `.gobi/settings.yaml` is missing, `gobi init` and `gobi space warp` are the interactive entry points — they require user input, so an agent should hand off to the user rather than trying to drive them silently.
+
+Every command that depends on a vault or space accepts an explicit override (`--vault-slug`, `--space-slug`) so an agent can act without ambient state.
+
+### Headless auth
+
+`gobi auth login` is a device-code flow: it prints a URL and a user code to stdout, then polls. An agent can run it as a background task, surface the URL to the user as a clickable link, and wait for the process to exit. See [`commands/login.md`](commands/login.md) for the canonical agent recipe.
+
+### Per-session context for drafts
+
+When the runtime exports `GOBI_SESSION_ID`, `gobi draft add` picks it up automatically — no need to pass `--session` from inside an agent run. See the **Drafts** section below.
+
+---
+
 ## Commands
 
 ### Authentication
 
 | Command | Description |
 |---------|-------------|
-| `gobi auth login` | Sign in via device code flow |
+| `gobi auth login` | Sign in via device-code flow |
 | `gobi auth status` | Show current auth status |
 | `gobi auth logout` | Sign out and clear credentials |
 
@@ -75,7 +132,7 @@ gobi global create-post --title "Hello" --content "Trying gobi"
 |---------|-------------|
 | `gobi vault publish` | Upload `PUBLISH.md` to your vault. Triggers profile/metadata refresh. |
 | `gobi vault unpublish` | Remove `PUBLISH.md` from your vault. |
-| `gobi vault sync` | Sync local vault files with Gobi Webdrive. |
+| `gobi vault sync` | Sync local vault files with Gobi WebDrive. |
 
 Public vaults are accessible at `https://gobispace.com/@{vaultSlug}`.
 
@@ -96,6 +153,8 @@ Public vaults are accessible at `https://gobispace.com/@{vaultSlug}`.
 
 ### Spaces
 
+A *Space* is a community knowledge area. A *Space Post* lives in one space. The same `Post` data type, in a different scope, is a *Personal Post* (see Global feed below) — so anything you can do to a Space Post you can do to a Personal Post.
+
 > Space and member administration (creating spaces, inviting/approving members, joining/leaving) is web-UI only and not available in the CLI.
 
 | Command | Description |
@@ -106,29 +165,31 @@ Public vaults are accessible at `https://gobispace.com/@{vaultSlug}`.
 | `gobi space list-topic-posts <topicSlug>` | List posts tagged with a topic |
 | `gobi space list-posts` | List posts in the space |
 | `gobi space get-post <postId>` | Get a post with its ancestors and replies |
-| `gobi space create-post --title <t> --content <c>` | Create a post |
-| `gobi space edit-post <postId> [--title <t>] [--content <c>]` | Edit a post (at least one required) |
-| `gobi space delete-post <postId>` | Delete a post |
-| `gobi space create-reply <postId> --content <c>` | Reply to a post |
+| `gobi space create-post --title <t> --content <c> [--vault-slug <slug>] [--auto-attachments]` | 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> [--title <t>] [--content <c>] [--vault-slug <slug>] [--auto-attachments]` | Edit a space post. `--vault-slug ""` detaches the vault. |
+| `gobi space delete-post <postId>` | Delete a space post |
+| `gobi space create-reply <postId> --content <c>` | Reply to a space post |
 | `gobi space edit-reply <replyId> --content <c>` | Edit a reply |
 | `gobi space delete-reply <replyId>` | Delete a reply |
 
-### Global feed
+### Global feed (personal posts)
 
-The global feed is the public, slugless feed of vault-authored posts visible across all spaces.
+A *Personal Post* lives on the author's profile (their primary vault) and surfaces in the public global feed. Same `Post` model as a Space Post, scoped to the user instead of a space.
 
 | Command | Description |
 |---------|-------------|
 | `gobi global feed` | List the global public feed (posts + replies, newest first) |
-| `gobi global list-posts [--mine] [--vault-slug <slug>]` | List posts in the global feed |
-| `gobi global get-post <postId>` | Get a global post with its ancestors and replies |
-| `gobi global create-post [--title <t>] (--content <c> \| --rich-text <json>)` | Create a post in the global feed |
-| `gobi global edit-post <postId> [--title <t>] [--content <c>]` | Edit a post you authored |
-| `gobi global delete-post <postId>` | Delete a post you authored |
-| `gobi global create-reply <postId> (--content <c> \| --rich-text <json>)` | Reply to a global post |
+| `gobi global list-posts [--mine] [--vault-slug <slug>]` | List personal posts; filter to your own or by author vault |
+| `gobi global get-post <postId>` | Get a personal post with its ancestors and replies |
+| `gobi global create-post [--title <t>] (--content <c> \| --rich-text <json>) [--vault-slug <slug>] [--auto-attachments]` | Create a personal post |
+| `gobi global edit-post <postId> [--title <t>] [--content <c>] [--vault-slug <slug>]` | 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> (--content <c> \| --rich-text <json>)` | Reply to a personal post |
 | `gobi global edit-reply <replyId> --content <c>` | Edit a reply you authored |
 | `gobi global delete-reply <replyId>` | Delete a reply you authored |
 
+`--vault-slug` requires that the caller hold `role: 'owner'` on the target vault. When set, it becomes the post's `authorVaultSlug`. When `--auto-attachments` is set, the same vault is used both as the upload destination for `[[wikilinks]]` and as `authorVaultSlug`.
+
 ### Sessions
 
 | Command | Description |
@@ -141,6 +202,8 @@ The global feed is the public, slugless feed of vault-authored posts visible acr
 
 ### Sense
 
+Activity and transcription data captured by Gobi Sense (or the mobile app).
+
 | Command | Description |
 |---------|-------------|
 | `gobi sense activities --start-time <iso> --end-time <iso>` | Fetch activity records in a time range |
@@ -159,7 +222,7 @@ Times are ISO 8601 UTC (e.g. `2026-03-20T00:00:00Z`).
 | `gobi saved note list [--date YYYY-MM-DD]` | List your notes (recent via cursor, or all for a day) |
 | `gobi saved note get <id>` | Get a single note |
 | `gobi saved note create --content <c>` | Create a note (use `-` to read content from stdin) |
-| `gobi saved note edit <id> [--content <c>] [--agent-id <id>]` | Edit a note (at least one required; `--agent-id null` clears the link) |
+| `gobi saved note edit <id> [--content <c>] [--agent-id <id>]` | Edit a note (`--agent-id null` clears the link) |
 | `gobi saved note delete <id>` | Delete a note you authored |
 
 `saved note list` and `saved note create` accept `--timezone <iana>` (default: system timezone).
@@ -170,30 +233,46 @@ Times are ISO 8601 UTC (e.g. `2026-03-20T00:00:00Z`).
 |---------|-------------|
 | `gobi saved post list [--type all\|article\|space-post]` | List posts you've saved |
 | `gobi saved post get <postId>` | Get a saved post snapshot |
-| `gobi saved post create --source <id>` | Save a post or reply by id |
+| `gobi saved post create --source <id>` | Save a post or reply by id (records a snapshot) |
 | `gobi saved post delete <postId>` | Remove a post from your saved collection |
 
 ### Drafts
 
-Drafts are authored by your agent during chat (or by external agents using `gobi draft add` as their tool layer). Each draft carries 0–3 AI-suggested actions the user can pick from. The top 5 pending drafts (lowest priority first) feed the agent's system prompt every turn. Every draft is anchored to the chat session that produced it.
+A *draft* is a unit of standing guidance authored by an agent. Each draft carries 0–3 AI-suggested action labels the user picks from. The top 5 pending drafts (lowest priority first) are injected into the agent's system prompt every turn — drafts turn agent suggestions into running context.
+
+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>`.
 
 | Command | Description |
 |---------|-------------|
 | `gobi draft list [--limit N]` | List drafts (priority ASC, then newest first) |
 | `gobi draft get <id>` | Show one draft with its history and suggested actions |
-| `gobi draft add <title> <content> [--session <id>] [--priority N] [--action <label>]…` | Add a draft. Pass `--action` up to 3 times to attach AI-suggested actions. `--session` falls back to `$GOBI_SESSION_ID`. Use `-` for content to read from stdin. |
+| `gobi draft add <title> <content> [--session <id>] [--priority N] [--action <label>]…` | Add a draft. Pass `--action` up to 3 times. `--session` falls back to `$GOBI_SESSION_ID`. Use `-` for content to read from stdin. |
 | `gobi draft delete <id>` | Delete a draft |
 | `gobi draft prioritize <id> <priority>` | Set priority (lower = higher) |
 | `gobi draft action <id> <index>` | Take one of the draft's suggested actions by 0-based index. Marks `actioned` and posts the synthesized message into the originating session. |
 | `gobi draft revise <id> <comment> [--title <t>] [--content <c>] [--action <label>]…` | Bump revision with a comment; optionally replace title / content / actions in the same call |
 
+### Media generation
+
+Image, video, and avatar generation. See the `gobi-media` skill for full workflows.
+
+| Command | Description |
+|---------|-------------|
+| `gobi media image-generate --prompt <p> [--aspect-ratio <r>] [-o <file>]` | Generate an image (use `-o` to wait + download) |
+| `gobi media image-edit --image <f> --prompt <p>` | Edit/inpaint an image |
+| `gobi media video-create --avatar-id <a> --voice-id <v> --script <s>` | Avatar video with voice narration |
+| `gobi media cinematic-create --prompt <p>` | Cinematic video from a text prompt |
+| `gobi media avatar-design / avatar-from-selfie` | Custom avatars from prompts or selfies |
+| `gobi media avatars` / `gobi media voices` | List available avatars and voices |
+| `gobi media upload <file>` | Upload a local file and get a media id |
+
 ### Global options
 
 | Option | Scope | Description |
 |--------|-------|-------------|
-| `--json` | All commands | Output results as JSON |
+| `--json` | All commands | Output structured JSON (`{success, data}` / `{success, error}`) |
 | `--space-slug <slug>` | `space` commands | Override the default space (from `.gobi/settings.yaml`) |
-| `--vault-slug <slug>` | Per-command | Override the default vault; available on post/reply commands that upload attachments and on `global create-post` |
+| `--vault-slug <slug>` | Per-command | Override the default vault — see each command's docs |
 
 ## Configuration
 
@@ -203,6 +282,7 @@ Drafts are authored by your agent during chat (or by external agents using `gobi
 |----------|---------|-------------|
 | `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) |
 
 ### Files
 
@@ -210,8 +290,27 @@ Drafts are authored by your agent during chat (or by external agents using `gobi
 |------|-------------|
 | `~/.gobi/credentials.json` | Stored authentication tokens |
 | `.gobi/settings.yaml` | Per-project vault and space configuration |
+| `.gobi/syncfiles` | Whitelist patterns for `gobi vault sync` (one per line) |
+| `.gobi/sync.db` | Local sync state (cursor, hash cache) — managed by the CLI |
 | `PUBLISH.md` | Vault profile document with YAML frontmatter, published via `gobi vault publish` |
 
+## Claude Code skills
+
+The CLI ships a `.claude-plugin/` manifest with eight skills that wrap the command groups for Claude Code agents:
+
+| Skill | Covers |
+|-------|--------|
+| `gobi-core` | Auth, init, session, update, space list/warp |
+| `gobi-vault` | `gobi vault publish/unpublish/sync` |
+| `gobi-space` | `gobi space …` and `gobi global …` |
+| `gobi-saved` | `gobi saved note …` and `gobi saved post …` |
+| `gobi-draft` | `gobi draft …` |
+| `gobi-media` | `gobi media …` |
+| `gobi-sense` | `gobi sense activities/transcriptions` |
+| `gobi-homepage` | Building custom HTML homepages with `window.gobi` |
+
+Each skill's `SKILL.md` is hand-written orientation; `references/` is regenerated from `--help` output by `npm run generate-skill-docs`.
+
 ## Development
 
 ```sh
@@ -228,6 +327,8 @@ Run from source without compiling:
 npm run dev -- auth status
 ```
 
+Tests run against `dist/*.test.js` (built JS), so `npm run build` is a prerequisite for `npm test`.
+
 ## License
 
 [MIT](LICENSE)

package/commands/space-share.md

@@ -1,6 +1,6 @@
 ---
 name: space-share
-description: Summarize recent learnings from this session and draft a vault post to share to the global feed.
+description: Summarize recent learnings from this session and draft a personal post to share to the global feed.
 argument-hint: "[context]"
 ---
 
@@ -16,7 +16,7 @@ gobi --json auth status
 
 Check that `.gobi/settings.yaml` exists and contains both `vaultSlug` and `selectedSpaceSlug`. If not, stop and ask the user to run `gobi init` and `gobi space warp` first.
 
-## Draft a vault post
+## Draft a personal post
 
 If `$ARGUMENTS` is provided, treat it as additional context or emphasis to guide the draft (e.g. "Emphasize the auth fix" or "Focus on the API design decision").
 

package/dist/attachments.js

@@ -1,4 +1,5 @@
 import { existsSync, readFileSync, appendFileSync } from "fs";
+import { EOL } from "os";
 import { join, extname } from "path";
 import ignore from "ignore";
 import { WEBDRIVE_BASE_URL } from "./constants.js";
@@ -33,7 +34,7 @@ function addToLocalSyncfiles(gobiDir, filePath) {
     if (isPathCovered(filePath, patterns))
         return;
     const syncfilesPath = join(gobiDir, "syncfiles");
-    appendFileSync(syncfilesPath, `\n${filePath}`);
+    appendFileSync(syncfilesPath, `${EOL}${filePath}`);
     console.log(`Added to syncfiles: ${filePath}`);
 }
 export async function uploadAttachments(vaultSlug, links, token, options) {

package/dist/commands/draft.js

@@ -1,9 +1,8 @@
-import { readFileSync } from "fs";
 import { apiDelete, apiGet, apiPatch, apiPost } from "../client.js";
-import { isJsonMode, jsonOut, unwrapResp } from "./utils.js";
+import { isJsonMode, jsonOut, readStdin, unwrapResp } from "./utils.js";
 function readContent(value) {
     if (value === "-")
-        return readFileSync("/dev/stdin", "utf8");
+        return readStdin();
     return value;
 }
 function snippet(content, max = 80) {

package/dist/commands/global.js

@@ -1,11 +1,10 @@
-import { readFileSync } from "fs";
 import { apiGet, apiPost, apiPatch, apiDelete } from "../client.js";
-import { isJsonMode, jsonOut, resolveVaultSlug, unwrapResp } from "./utils.js";
+import { isJsonMode, jsonOut, readStdin, resolveVaultSlug, unwrapResp, } from "./utils.js";
 import { extractWikiLinks, uploadAttachments } from "../attachments.js";
 import { getValidToken } from "../auth/manager.js";
 function readContent(value) {
     if (value === "-")
-        return readFileSync("/dev/stdin", "utf8");
+        return readStdin();
     return value;
 }
 function formatFeedLine(m) {
@@ -232,9 +231,13 @@ export function registerGlobalCommand(program) {
         .option("--title <title>", "New title")
         .option("--content <content>", "New content (markdown supported, use \"-\" for stdin)")
         .option("--rich-text <richText>", "Rich-text JSON array (mutually exclusive with --content)")
+        .option("--vault-slug <vaultSlug>", "Attribute the post to this vault (sets authorVaultId). Pass an empty string to detach.")
         .action(async (postId, opts) => {
-        if (opts.title == null && opts.content == null && opts.richText == null) {
-            throw new Error("Provide at least --title, --content, or --rich-text to update.");
+        if (opts.title == null &&
+            opts.content == null &&
+            opts.richText == null &&
+            opts.vaultSlug === undefined) {
+            throw new Error("Provide at least --title, --content, --rich-text, or --vault-slug to update.");
         }
         if (opts.content && opts.richText) {
             throw new Error("--content and --rich-text are mutually exclusive.");
@@ -254,6 +257,8 @@ export function registerGlobalCommand(program) {
             }
             body.richText = parsed;
         }
+        if (opts.vaultSlug !== undefined)
+            body.authorVaultSlug = opts.vaultSlug;
         const resp = (await apiPatch(`/posts/${postId}`, body));
         const post = unwrapResp(resp);
         if (isJsonMode(global)) {

package/dist/commands/saved.js

@@ -1,6 +1,5 @@
-import { readFileSync } from "fs";
 import { apiGet, apiPost, apiPatch, apiDelete } from "../client.js";
-import { isJsonMode, jsonOut, unwrapResp } from "./utils.js";
+import { isJsonMode, jsonOut, readStdin, unwrapResp } from "./utils.js";
 function defaultTimezone() {
     return Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC";
 }
@@ -101,7 +100,7 @@ function registerNoteCommands(saved) {
         if (!opts.content) {
             throw new Error("--content is required (use '-' to read from stdin)");
         }
-        const content = opts.content === "-" ? readFileSync("/dev/stdin", "utf8") : opts.content;
+        const content = opts.content === "-" ? readStdin() : opts.content;
         const body = {
             content,
             timezone: opts.timezone || defaultTimezone(),
@@ -128,7 +127,7 @@ function registerNoteCommands(saved) {
         const body = {};
         if (opts.content != null) {
             body.content =
-                opts.content === "-" ? readFileSync("/dev/stdin", "utf8") : opts.content;
+                opts.content === "-" ? readStdin() : opts.content;
         }
         if (opts.agentId != null) {
             body.agentId = opts.agentId === "null" ? null : parseInt(opts.agentId, 10);

package/dist/commands/space.js

@@ -1,12 +1,11 @@
-import { readFileSync } from "fs";
 import { apiGet, apiPost, apiPatch, apiDelete } from "../client.js";
 import { selectSpace, writeSpaceSetting } from "./init.js";
-import { isJsonMode, jsonOut, resolveSpaceSlug, resolveVaultSlug, unwrapResp } from "./utils.js";
+import { isJsonMode, jsonOut, readStdin, resolveSpaceSlug, resolveVaultSlug, unwrapResp, } from "./utils.js";
 import { extractWikiLinks, uploadAttachments } from "../attachments.js";
 import { getValidToken } from "../auth/manager.js";
 function readContent(value) {
     if (value === "-")
-        return readFileSync("/dev/stdin", "utf8");
+        return readStdin();
     return value;
 }
 function formatFeedLine(m) {
@@ -295,21 +294,27 @@ export function registerSpaceCommand(program) {
         .description("Create a post in a space.")
         .requiredOption("--title <title>", "Title of the post")
         .requiredOption("--content <content>", "Post content (markdown supported)")
-        .option("--auto-attachments", "Upload wiki-linked [[files]] to webdrive before posting")
-        .option("--vault-slug <vaultSlug>", "Vault slug for attachment uploads (overrides .gobi/settings.yaml)")
+        .option("--auto-attachments", "Upload wiki-linked [[files]] to webdrive before posting (also attributes the post to that vault)")
+        .option("--vault-slug <vaultSlug>", "Attribute the post to this vault (sets authorVaultId). Also used as upload destination for --auto-attachments.")
         .action(async (opts) => {
         const content = readContent(opts.content);
+        let authorVaultSlug;
+        if (opts.vaultSlug || opts.autoAttachments) {
+            authorVaultSlug = resolveVaultSlug(opts);
+        }
         if (opts.autoAttachments) {
-            const vaultSlug = resolveVaultSlug(opts);
             const token = await getValidToken();
             const links = extractWikiLinks(content);
-            await uploadAttachments(vaultSlug, links, token, { addToSyncfiles: true });
+            await uploadAttachments(authorVaultSlug, links, token, { addToSyncfiles: true });
         }
         const spaceSlug = resolveSpaceSlug(space);
-        const resp = (await apiPost(`/spaces/${spaceSlug}/posts`, {
+        const body = {
             title: opts.title,
             content,
-        }));
+        };
+        if (authorVaultSlug)
+            body.authorVaultSlug = authorVaultSlug;
+        const resp = (await apiPost(`/spaces/${spaceSlug}/posts`, body));
         const post = unwrapResp(resp);
         if (isJsonMode(space)) {
             jsonOut(post);
@@ -325,26 +330,36 @@ export function registerSpaceCommand(program) {
         .description("Edit a post. You must be the author.")
         .option("--title <title>", "New title for the post")
         .option("--content <content>", "New content for the post (markdown supported)")
-        .option("--auto-attachments", "Upload wiki-linked [[files]] to webdrive before editing")
-        .option("--vault-slug <vaultSlug>", "Vault slug for attachment uploads (overrides .gobi/settings.yaml)")
+        .option("--auto-attachments", "Upload wiki-linked [[files]] to webdrive before editing (also attributes the post to that vault)")
+        .option("--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.")
         .action(async (postId, opts) => {
-        if (!opts.title && !opts.content) {
-            throw new Error("Provide at least --title or --content to update.");
+        const wantsVaultChange = opts.vaultSlug !== undefined || opts.autoAttachments;
+        if (!opts.title && !opts.content && !wantsVaultChange) {
+            throw new Error("Provide at least --title, --content, or --vault-slug to update.");
         }
         const spaceSlug = resolveSpaceSlug(space);
+        let authorVaultSlug;
+        if (opts.vaultSlug !== undefined) {
+            // Empty string detaches; non-empty resolves through settings fallback.
+            authorVaultSlug = opts.vaultSlug === "" ? "" : resolveVaultSlug(opts);
+        }
+        else if (opts.autoAttachments) {
+            authorVaultSlug = resolveVaultSlug(opts);
+        }
         const body = {};
         if (opts.title != null)
             body.title = opts.title;
         if (opts.content != null) {
             const content = readContent(opts.content);
             if (opts.autoAttachments) {
-                const vaultSlug = resolveVaultSlug(opts);
                 const token = await getValidToken();
                 const links = extractWikiLinks(content);
-                await uploadAttachments(vaultSlug, links, token, { addToSyncfiles: true });
+                await uploadAttachments(authorVaultSlug, links, token, { addToSyncfiles: true });
             }
             body.content = content;
         }
+        if (authorVaultSlug !== undefined)
+            body.authorVaultSlug = authorVaultSlug;
         const resp = (await apiPatch(`/spaces/${spaceSlug}/posts/${postId}`, body));
         const post = unwrapResp(resp);
         if (isJsonMode(space)) {

package/dist/commands/update.js

@@ -10,20 +10,26 @@ async function fetchLatestVersion() {
     const data = (await res.json());
     return data.version;
 }
-function detectInstallMethod() {
+// `which` is Unix-only; Windows uses `where`. `where` may print multiple
+// matches on separate lines — take the first one.
+function locateGobi() {
+    const cmd = process.platform === "win32" ? "where gobi" : "which gobi";
     try {
-        const gobiBin = execSync("which gobi", { encoding: "utf-8" }).trim();
-        if (gobiBin.includes("/Cellar/") || gobiBin.includes("/homebrew/")) {
-            return "brew";
-        }
+        const out = execSync(cmd, { encoding: "utf-8" }).trim();
+        return out.split(/\r?\n/)[0] || null;
     }
     catch {
-        // ignore
+        return null;
+    }
+}
+function detectInstallMethod() {
+    const gobiBin = locateGobi();
+    if (gobiBin && (gobiBin.includes("/Cellar/") || gobiBin.includes("/homebrew/"))) {
+        return "brew";
     }
     try {
         const npmGlobalDir = execSync("npm root -g", { encoding: "utf-8" }).trim();
-        const gobiBin = execSync("which gobi", { encoding: "utf-8" }).trim();
-        if (gobiBin.includes(npmGlobalDir.replace("/lib/node_modules", ""))) {
+        if (gobiBin && gobiBin.includes(npmGlobalDir.replace("/lib/node_modules", ""))) {
             return "npm";
         }
     }

package/dist/commands/utils.js

@@ -1,4 +1,10 @@
+import { readFileSync } from "fs";
 import { getSpaceSlug, getVaultSlug } from "./init.js";
+// Reads all of stdin synchronously. Uses fd 0 (cross-platform) instead of
+// "/dev/stdin", which doesn't exist on Windows.
+export function readStdin() {
+    return readFileSync(0, "utf8");
+}
 export function isJsonMode(cmd) {
     return !!cmd.parent?.opts().json;
 }

package/package.json

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

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,8 +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 posts, replies, sessions, 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`). Configure a vault's public profile with a `PUBLISH.md` document and `gobi vault publish`.
+- **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
 
@@ -85,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
 
@@ -95,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
 
@@ -110,15 +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 vault 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 update](references/update.md)
+- [gobi space (list/warp)](references/space.md)
 
 ## Configuration Files
 
@@ -134,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-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 vault posts." --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, vault posts, 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.*`.
 
@@ -67,10 +67,12 @@ function getFileUrl(path) {
 }
 ```
 
-### Vault posts
+### 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.listVaultPosts({ 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.listVaultPosts({ limit: 10, cursor: pagination.nextCursor });
+    await gobi.listPersonalPosts({ limit: 10, cursor: pagination.nextCursor });
 }
 ```
 
@@ -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
 
-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).
+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.
 
-### Vault post card — preview/full toggle
+### Personal post card — preview/full toggle
 
 Show a truncated card that expands in place on click:
 
@@ -389,11 +391,11 @@ Single breakpoint at `768px` is enough for most homepages:
         `https://gobispace.com/login?redirect_uri=${encodeURIComponent(window.location.href)}`;
     }
 
-    // ── Vault posts ──────────────────────────────────
+    // ── Personal posts ───────────────────────────────
 
     async function loadUpdates() {
       try {
-        const { data: updates } = await gobi.listVaultPosts({ 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 vault posts:', 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

@@ -9,12 +9,12 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "1.3.9"
+  version: "2.0.0"
 ---
 
 # gobi-saved
 
-Gobi saved-knowledge commands (v1.3.9).
+Gobi saved-knowledge commands (v2.0.0).
 
 Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
 

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.

package/skills/gobi-space/SKILL.md

@@ -1,29 +1,42 @@
 ---
 name: gobi-space
 description: >-
-  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.
+  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 and global 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 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.
+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:
@@ -55,28 +68,29 @@ gobi --json space list-posts
 ### Feed
 - `gobi space feed` — List the unified feed (posts and replies, newest first).
 
-### Posts
+### 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 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.
+- `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.
 
-### Replies
-- `gobi space create-reply <postId>` — Create a reply to a post in a space.
+### 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.
 
-### 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.
+### 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 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 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.
 

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

@@ -88,10 +88,11 @@ Usage: gobi global edit-post [options] <postId>
 Edit a post you authored in the global feed.
 
 Options:
-  --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
+  --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
 ```
 
 ## delete-post

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

@@ -112,8 +112,8 @@ Create a post in a space.
 Options:
   --title <title>           Title of the post
   --content <content>       Post 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)
+  --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
 ```
 
@@ -127,8 +127,8 @@ Edit a post. You must be the author.
 Options:
   --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
-  --vault-slug <vaultSlug>  Vault slug for attachment uploads (overrides .gobi/settings.yaml)
+  --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
 ```
 

package/skills/gobi-vault/SKILL.md

@@ -7,12 +7,12 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "0.9.13"
+  version: "2.0.0"
 ---
 
 # gobi-vault
 
-Gobi vault commands for publishing your vault profile and syncing files (v0.9.13).
+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.