@gobi-ai/cli 2.0.21 → 2.0.23

package/.claude-plugin/marketplace.json

@@ -4,12 +4,12 @@
     "name": "gobi-ai"
   },
   "description": "Claude Code plugin for the Gobi collaborative knowledge platform CLI",
-  "version": "2.0.21",
+  "version": "2.0.23",
   "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": "2.0.21",
+      "description": "Manage the Gobi collaborative knowledge platform from the command line. Publish vault profiles, create posts and replies, generate images and videos.",
+      "version": "2.0.23",
       "author": {
         "name": "gobi-ai"
       },
@@ -19,7 +19,6 @@
         "./skills/gobi-core",
         "./skills/gobi-space",
         "./skills/gobi-vault",
-        "./skills/gobi-saved",
         "./skills/gobi-draft",
         "./skills/gobi-media",
         "./skills/gobi-sense",

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "gobi",
   "description": "Manage the Gobi collaborative knowledge platform from the command line",
-  "version": "2.0.21",
+  "version": "2.0.23",
   "author": {
     "name": "gobi-ai"
   },
@@ -10,7 +10,6 @@
     "./skills/gobi-core",
     "./skills/gobi-space",
     "./skills/gobi-vault",
-    "./skills/gobi-saved",
     "./skills/gobi-draft",
     "./skills/gobi-media",
     "./skills/gobi-sense",

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Gobi AI
+Copyright (c) 2025-2026 Gobi AI
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -4,11 +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)
 
-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.
+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, drafts, media generation, activity reads) exposed as composable shell commands so AI agents and developer scripts can act on a user's behalf in Gobi.
 
 ## 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.
+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 work in a user's Gobi — capture notes, post to a community space, draft a suggestion, generate an image — this is the surface.
 
 ## Installation
 
@@ -63,7 +63,7 @@ Each setup step unlocks a different family of commands — run only the ones the
 | Step | Unlocks |
 |------|---------|
 | `gobi auth login` | All authenticated commands |
-| `gobi vault init` | Every `gobi vault …` command (`publish`, `unpublish`, `sync`) and lets `global create-post` default to that vault |
+| `gobi vault init` | Every `gobi vault …` command (`publish`, `unpublish`, `sync`); also lets `global create-post --auto-attachments` resolve that vault automatically |
 | `gobi space warp` | Every `gobi space …` command without needing `--space-slug` |
 
 ---
@@ -142,6 +142,10 @@ When the runtime exports `GOBI_SESSION_ID`, `gobi draft add` picks it up automat
 
 | Command | Description |
 |---------|-------------|
+| `gobi vault create <slug> --name <n>` | Create a new vault. Does not change the configured vault — run `gobi vault init` or `gobi vault set-primary` afterwards if you want to anchor to it. |
+| `gobi vault rename <newName> [--vault-slug <slug>]` | Rename a vault. Defaults to the configured vault. Local display name only — does not affect `PUBLISH.md` frontmatter. |
+| `gobi vault delete <slug>` | Delete a vault. Irreversible. The API rejects if the vault still owns content; clean up posts, members, and files first. |
+| `gobi vault set-primary <slug>` | Mark a vault as your primary. Unsets primary on the others. |
 | `gobi vault publish` | Upload `PUBLISH.md` to your vault. Triggers profile/metadata refresh. |
 | `gobi vault unpublish` | Remove `PUBLISH.md` from your vault. |
 | `gobi vault status [--vault-slug <slug>]` | Show the configured vault's publish state (`isPublished`), profile fields, file count, and public profile URL. Useful as a pre-flight check before posting with `--auto-attachments`. |
@@ -178,40 +182,48 @@ A *Space* is a community knowledge area. A *Space Post* lives in one space. The
 | `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> [--full]` | Get a post with its ancestors and replies. `--full` shows reply content without truncation. |
-| `gobi space create-post --title <t> --content <c> [--vault-slug <slug>] [--auto-attachments] [--draft-id <id>]` | 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`. `--draft-id` links the post back to a draft (records `postId`/`spaceSlug` on `draft.metadata` so the client can render an "Open post" button). |
+| `gobi space create-post [--title <t>] (--content <c> \| --rich-text <json> \| --draft-id <id>) [--vault-slug <slug>] [--auto-attachments] [--repost-post-id <id>] [--attach <file>]…` | Create a space post. Must provide content via one of `--content`, `--rich-text`, or `--draft-id`. `--vault-slug` attributes it to a vault you own; `--auto-attachments` uploads `[[wikilinks]]` to that vault and uses it as `authorVaultSlug`. `--draft-id` links the post back to a draft (records `postId`/`spaceSlug` on `draft.metadata` so the client can render an "Open post" button). `--repost-post-id` reposts an existing post (sets `repostPostId` on the new post). `--attach` uploads local media to render inline in-feed (repeatable; X-style mix rule — up to 4 photos OR 1 GIF OR 1 video). |
 | `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> \| --rich-text <json>) [--vault-slug <slug>] [--auto-attachments]` | Create a reply to a space post |
+| `gobi space create-reply <postId> (--content <c> \| --rich-text <json>) [--vault-slug <slug>] [--auto-attachments] [--attach <file>]…` | Create a reply to a space post. `--attach` works the same as on `create-post`. |
 | `gobi space edit-reply <replyId> [--content <c>] [--rich-text <json>] [--vault-slug <slug>] [--auto-attachments]` | Edit a reply you authored. `--vault-slug ""` detaches attribution. |
 | `gobi space delete-reply <replyId>` | Delete a reply you authored |
 
 ### Global feed (personal posts)
 
-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.
+A *Personal Post* surfaces in the public global feed. Pass `--vault-slug` to attribute it to a vault you own (it'll then surface on that vault's profile too); with no `--vault-slug` and no `--auto-attachments` the post has no `authorVaultSlug` and lives only on the global feed. Same `Post` model as a Space Post, scoped to the user instead of a space.
 
 | Command | Description |
 |---------|-------------|
 | `gobi global feed [--following]` | List the global public feed (posts + replies, newest first). `--following` limits to authors you follow. |
 | `gobi global list-posts [--mine] [--vault-slug <slug>]` | List personal posts; filter to your own or by author vault |
 | `gobi global get-post <postId> [--full]` | Get a personal post with its ancestors and replies. `--full` shows reply content without truncation. |
-| `gobi global create-post [--title <t>] (--content <c> \| --rich-text <json>) [--vault-slug <slug>] [--auto-attachments] [--draft-id <id>]` | Create a personal post. `--draft-id` links the post back to a draft (records `postId` on `draft.metadata`). |
+| `gobi global create-post [--title <t>] (--content <c> \| --rich-text <json>) [--vault-slug <slug>] [--auto-attachments] [--draft-id <id>] [--repost-post-id <id>] [--attach <file>]…` | Create a personal post. `--draft-id` links the post back to a draft (records `postId` on `draft.metadata`). `--repost-post-id` reposts an existing post. `--attach` uploads local media for inline rendering (see `gobi space create-post` above for the mix rule). |
 | `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>) [--vault-slug <slug>] [--auto-attachments]` | Create a reply to a personal post |
+| `gobi global create-reply <postId> (--content <c> \| --rich-text <json>) [--vault-slug <slug>] [--auto-attachments] [--attach <file>]…` | Create a reply to a personal post |
 | `gobi global edit-reply <replyId> [--content <c>] [--rich-text <json>] [--vault-slug <slug>] [--auto-attachments]` | Edit a reply you authored. `--vault-slug ""` detaches attribution. |
 | `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
+### Personal space (private posts)
+
+> Naming note: a **Personal Post** (under `gobi global`, above) is the public-feed kind — it lives on your vault profile and surfaces on the global feed. A **personal-space post** (this section, under `gobi personal`) is the private kind — same `Post` data model, but scoped via `personalSpaceUserId` so only you can see it.
+
+Private posts and replies visible only to you. Same `Post` data model and subcommand shape as `gobi global`, but scoped to a personal space — they never appear on the public global feed.
 
 | Command | Description |
 |---------|-------------|
-| `gobi session list` | List your sessions |
-| `gobi session get <id>` | Get a session and its messages |
-| `gobi session create-reply <id> --content <c>` | Send a message in a session |
-
-`session create-reply` also accepts `--rich-text <json>` (mutually exclusive with `--content`).
+| `gobi personal feed` | Your personal-space feed (posts + replies, newest first) |
+| `gobi personal list-posts` | List personal-space posts |
+| `gobi personal get-post <postId> [--full]` | Get a personal-space post with its ancestors and replies |
+| `gobi personal create-post [--title <t>] (--content <c> \| --rich-text <json>) [--vault-slug <slug>] [--auto-attachments] [--draft-id <id>] [--repost-post-id <id>] [--attach <file>]…` | Create a private post in your personal space. `--vault-slug` attributes it to a vault you own. `--attach` works the same as on `gobi global create-post`. |
+| `gobi personal edit-post <postId> [--title <t>] [--content <c>] [--vault-slug <slug>] [--auto-attachments]` | Edit a personal-space post you authored |
+| `gobi personal delete-post <postId>` | Delete a personal-space post you authored |
+| `gobi personal create-reply <postId> (--content <c> \| --rich-text <json>) [--vault-slug <slug>] [--auto-attachments] [--attach <file>]…` | Reply to a personal-space post (inherits the parent's private scope) |
+| `gobi personal edit-reply <replyId> [--content <c>] [--rich-text <json>] [--vault-slug <slug>] [--auto-attachments]` | Edit a reply you authored |
+| `gobi personal delete-reply <replyId>` | Delete a reply you authored |
 
 ### Sense
 
@@ -224,31 +236,6 @@ Activity and transcription data captured by Gobi Sense (or the mobile app).
 
 Times are ISO 8601 UTC (e.g. `2026-03-20T00:00:00Z`).
 
-### Saved
-
-`gobi saved` is the user's personal saved-knowledge collection — notes you author and posts you bookmark.
-
-#### Saved notes
-
-| Command | Description |
-|---------|-------------|
-| `gobi saved list-notes [--date YYYY-MM-DD]` | List your notes (recent via cursor, or all for a day) |
-| `gobi saved get-note <id>` | Get a single note |
-| `gobi saved create-note --content <c>` | Create a note (use `-` to read content from stdin) |
-| `gobi saved edit-note <id> [--content <c>] [--agent-id <id>]` | Edit a note (`--agent-id null` clears the link) |
-| `gobi saved delete-note <id>` | Delete a note you authored |
-
-`saved list-notes` and `saved create-note` accept `--timezone <iana>` (default: system timezone).
-
-#### Saved posts (bookmarks)
-
-| Command | Description |
-|---------|-------------|
-| `gobi saved list-posts [--type all\|article\|space-post]` | List posts you've bookmarked |
-| `gobi saved get-post <postId>` | Get a saved post snapshot |
-| `gobi saved create-post --source <id>` | Bookmark a post or reply by id (records a snapshot) |
-| `gobi saved delete-post <postId>` | Remove a post from your saved collection |
-
 ### Drafts
 
 A *draft* is a unit of standing guidance authored by an agent. Each draft carries 0–3 AI-suggested actions 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.
@@ -261,11 +248,11 @@ Each action is `{ label, message? }`: `label` is the short button text (1–80 c
 |---------|-------------|
 | `gobi draft list [--limit N]` | List drafts (priority ASC, then newest first) |
 | `gobi draft get <id>` | Get one draft with its history and suggested actions |
-| `gobi draft add <title> <content> [--session <id>] [--priority N] [--action <label[::message]>]…` | Add a draft. Pass `--action` up to 3 times; each action is `Label` or `Label::Message`. `--session` falls back to `$GOBI_SESSION_ID`. Use `-` for content to read from stdin. |
+| `gobi draft add <title> <content> [--session <id>] [--vault-slug <slug>] [--priority N] [--action <label[::message]>]…` | Add a draft. Pass `--action` up to 3 times; each action is `Label` or `Label::Message`. `--session` falls back to `$GOBI_SESSION_ID`. `--vault-slug` anchors the draft to a specific vault (must be one you own). 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 action's `message` (or `label`, if no message) into the originating session. |
-| `gobi draft revise <id> <comment> [--title <t>] [--content <c>] [--action <label[::message]>]…` | Bump revision with a comment; optionally replace title / content / actions in the same call |
+| `gobi draft revise <id> <comment> [--title <t>] [--content <c>] [--vault-slug <slug>] [--action <label[::message]>]…` | Bump revision with a comment; optionally replace title / content / vault-slug / actions in the same call |
 
 ### Media generation
 
@@ -276,9 +263,12 @@ Image, video, and avatar generation. See the `gobi-media` skill for full workflo
 | `gobi media generate-image --prompt <p> [--aspect-ratio <r>] [-o <file>]` | Generate an image (use `-o` to wait + download) |
 | `gobi media edit-image --image <f> --prompt <p>` | Edit an image with a prompt |
 | `gobi media inpaint-image --image <f> --mask <m> --prompt <p>` | Inpaint a masked region |
+| `gobi media get-image-status <jobId>` / `download-image <jobId>` | Poll an image job or download the result |
 | `gobi media create-video --avatar-id <a> --voice-id <v> --script <s>` | Avatar video with voice narration |
 | `gobi media create-cinematic --prompt <p>` | Cinematic video from a text prompt |
-| `gobi media design-avatar / design-avatar-from-selfie` | Custom avatars from prompts or selfies |
+| `gobi media get-video-status <videoId>` / `download-video <videoId>` | Poll a video job or download the result |
+| `gobi media design-avatar / design-avatar-from-selfie / confirm-avatar` | Custom avatars from prompts or selfies; confirm a variant after design |
+| `gobi media get-avatar-job-status <jobId>` | Poll an avatar design job |
 | `gobi media list-avatars` / `gobi media list-voices` | List available avatars and voices |
 | `gobi media list-videos` / `gobi media get-video <id>` | List or get videos |
 | `gobi media upload <file>` | Upload a local file and get a media id |
@@ -287,7 +277,7 @@ Image, video, and avatar generation. See the `gobi-media` skill for full workflo
 
 | Option | Scope | Description |
 |--------|-------|-------------|
-| `--json` | All commands | Output structured JSON (`{success, data}` / `{success, error}`) |
+| `--json` | All non-interactive commands | Output structured JSON (`{success, data}` / `{success, error}`). Interactive commands (`gobi auth login`, `gobi vault init`, `gobi update`, `gobi space warp` without a slug) prompt, poll, or stream subprocess output and ignore `--json`. |
 | `--space-slug <slug>` | `space` commands | Override the default space (from `.gobi/settings.yaml`) |
 | `--vault-slug <slug>` | Per-command | Override the default vault — see each command's docs |
 
@@ -299,6 +289,7 @@ Image, video, and avatar generation. See the `gobi-media` skill for full workflo
 |----------|---------|-------------|
 | `GOBI_BASE_URL` | `https://api.joingobi.com` | API server URL |
 | `GOBI_WEBDRIVE_BASE_URL` | `https://webdrive.joingobi.com` | File storage URL |
+| `GOBI_WEB_BASE_URL` | `https://gobispace.com` | Public web URL (used when assembling shareable links) |
 | `GOBI_SESSION_ID` | — | Default `--session` for `gobi draft add` (set automatically inside agent runs) |
 
 ### Files
@@ -313,14 +304,13 @@ Image, video, and avatar generation. See the `gobi-media` skill for full workflo
 
 ## Claude Code skills
 
-The CLI ships a `.claude-plugin/` manifest with eight skills that wrap the command groups for Claude Code agents:
+The CLI ships a `.claude-plugin/` manifest with skills that wrap the command groups for Claude Code agents:
 
 | Skill | Covers |
 |-------|--------|
-| `gobi-core` | Auth, session, update, space list/warp |
+| `gobi-core` | Auth, update, space list/warp |
 | `gobi-vault` | `gobi vault init/list/publish/unpublish/sync` |
-| `gobi-space` | `gobi space …` and `gobi global …` |
-| `gobi-saved` | `gobi saved list-notes/create-note/list-posts/create-post/…` |
+| `gobi-space` | `gobi space …`, `gobi global …`, and `gobi personal …` |
 | `gobi-draft` | `gobi draft …` |
 | `gobi-media` | `gobi media …` |
 | `gobi-sense` | `gobi sense list-activities/list-transcriptions` |

package/dist/commands/global.js

@@ -188,11 +188,11 @@ export function registerGlobalCommand(program) {
     // ── Create post ──
     global
         .command("create-post")
-        .description("Create a post in the global feed. --vault-slug attributes it to a vault you own; defaults to your primary vault.")
+        .description("Create a post in the global feed. --vault-slug attributes it to a vault you own. With no --vault-slug and no --auto-attachments, the post is created without an authorVaultSlug (vault-less personal post).")
         .option("--title <title>", "Title of the post")
         .option("--content <content>", "Post 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 authorVaultSlug). Defaults to your primary vault.")
+        .option("--vault-slug <vaultSlug>", "Attribute the post to this vault (sets authorVaultSlug). Caller must own the vault.")
         .option("--auto-attachments", "Upload wiki-linked [[files]] to webdrive before posting (also sets authorVaultSlug to that vault)")
         .option("--draft-id <draftId>", "Use this draft as the source of title and content (mutually exclusive with --title/--content/--rich-text). On success, links the post back by recording postId on draft.metadata so the client can render an 'Open post' button. The draft's vaultSlug seeds --vault-slug when not given explicitly.")
         .option("--attach <file>", "Local media file to attach. Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size ceilings: 5MB photos / 15MB GIFs / 512MB video.", (value, prev = []) => [...prev, value], [])

package/dist/commands/media.js

@@ -216,7 +216,7 @@ export function registerMediaCommand(program) {
             `  ID:     ${downloadId}\n` +
             `  Status: ${status}`);
         if (status === "inference_complete") {
-            console.log(`  Download: gobi media video-download ${downloadId}`);
+            console.log(`  Download: gobi media download-video ${downloadId}`);
         }
     });
     media
@@ -418,7 +418,7 @@ export function registerMediaCommand(program) {
             `  ID:     ${downloadId}\n` +
             `  Status: ${status}`);
         if (status === "inference_complete") {
-            console.log(`  Download: gobi media video-download ${downloadId}`);
+            console.log(`  Download: gobi media download-video ${downloadId}`);
         }
     });
     // ════════════════════════════════════════════════════════════════════
@@ -632,7 +632,7 @@ export function registerMediaCommand(program) {
             console.log(`  Download URL: ${imgUrl}`);
         }
         else if (status === "queued" || status === "inference_started" || status === "inference_working") {
-            console.log(`  Check:  gobi media image-status ${jobId}`);
+            console.log(`  Check:  gobi media get-image-status ${jobId}`);
         }
     });
     media

package/dist/commands/personal.js

@@ -190,7 +190,7 @@ export function registerPersonalCommand(program) {
         .option("--title <title>", "Title of the post")
         .option("--content <content>", "Post 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 authorVaultSlug). Defaults to your primary vault.")
+        .option("--vault-slug <vaultSlug>", "Attribute the post to this vault (sets authorVaultSlug). Caller must own the vault.")
         .option("--auto-attachments", "Upload wiki-linked [[files]] to webdrive before posting (also sets authorVaultSlug to that vault)")
         .option("--draft-id <draftId>", "Use this draft as the source of title and content (mutually exclusive with --title/--content/--rich-text). On success, links the post back via draft.metadata. The draft's vaultSlug seeds --vault-slug when not given explicitly.")
         .option("--attach <file>", "Local media file to attach. Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size ceilings: 5MB photos / 15MB GIFs / 512MB video.", (value, prev = []) => [...prev, value], [])

package/dist/commands/space.js

@@ -317,7 +317,7 @@ export function registerSpaceCommand(program) {
         .option("--content <content>", "Post content (markdown supported, use \"-\" for stdin)")
         .option("--rich-text <richText>", "Rich-text JSON array (mutually exclusive with --content)")
         .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.")
+        .option("--vault-slug <vaultSlug>", "Attribute the post to this vault (sets authorVaultSlug). Also used as upload destination for --auto-attachments.")
         .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
         .option("--draft-id <draftId>", "Use this draft as the source of title and content (mutually exclusive with --title/--content/--rich-text). On success, links the post back by recording postId/spaceSlug on draft.metadata so the client can render an 'Open post' button. The draft's vaultSlug seeds --vault-slug when not given explicitly.")
         .option("--attach <file>", "Local media file to attach. Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size ceilings: 5MB photos / 15MB GIFs / 512MB video.", (value, prev = []) => [...prev, value], [])
@@ -414,7 +414,7 @@ export function registerSpaceCommand(program) {
         .option("--content <content>", "New content for the post (markdown supported, use \"-\" for stdin)")
         .option("--rich-text <richText>", "Rich-text JSON array (mutually exclusive with --content)")
         .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.")
+        .option("--vault-slug <vaultSlug>", "Attribute the post to this vault (sets authorVaultSlug). Also used as upload destination for --auto-attachments.")
         .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
         .action(async (postId, opts) => {
         const wantsVaultChange = !!(opts.vaultSlug || opts.autoAttachments);

package/dist/commands/sync.js

@@ -409,13 +409,26 @@ export async function runSync(opts) {
         basePrivatePatterns = [...currPrivatePatterns];
     }
     const privatefilesChanges = computeSyncfilesChanges(basePrivatePatterns, currPrivatePatterns);
-    // Walk local files (only whitelisted, non-ignored)
-    if (!jsonMode)
-        process.stdout.write("Scanning local files...");
-    const localFiles = walkLocalFiles(vaultDir, state.hashCache, isWhitelisted);
-    if (!jsonMode)
-        console.log(` ${localFiles.length} file(s) found.`);
-    const localPathSet = new Set(localFiles.map((f) => f.path));
+    // Walk local files (only whitelisted, non-ignored).
+    // Optimization: in download-only mode, skip the full walk + hash. The server
+    // will return its own file list via the cursor; we then hash only the files
+    // the server tells us about that also exist locally, avoiding work for files
+    // that are local-only and irrelevant to a download.
+    let localFiles = [];
+    let localPathSet = new Set();
+    const tWalk = Date.now();
+    if (opts.downloadOnly) {
+        process.stderr.write(`[gobi-sync] timing walkLocalFiles: skipped (download-only)\n`);
+    }
+    else {
+        if (!jsonMode)
+            process.stdout.write("Scanning local files...");
+        localFiles = walkLocalFiles(vaultDir, state.hashCache, isWhitelisted);
+        if (!jsonMode)
+            console.log(` ${localFiles.length} file(s) found.`);
+        localPathSet = new Set(localFiles.map((f) => f.path));
+        process.stderr.write(`[gobi-sync] timing walkLocalFiles: ${localFiles.length} files in ${Date.now() - tWalk}ms\n`);
+    }
     // Detect and send offline deletions
     let maxMutationCursor = null;
     for (const cachedPath of Object.keys(state.hashCache)) {
@@ -444,17 +457,22 @@ export async function runSync(opts) {
     }
     // In dry-run mode, include cached-but-locally-deleted files in clientFiles so the
     // server does not propagate the deletion (the whole point of dry-run is no changes).
-    const clientFilesForSync = opts.dryRun
-        ? [
-            ...localFiles,
-            ...Object.entries(state.hashCache)
-                .filter(([p]) => !localPathSet.has(p) && !existsSync(join(vaultDir, p)))
-                .map(([path, entry]) => ({ path, hash: entry.hash, mtime: entry.mtime })),
-        ]
-        : localFiles;
+    // In download-only mode, send no clientFiles — the lazy-hash filter below decides
+    // per-file whether we already have the server's version.
+    const clientFilesForSync = opts.downloadOnly
+        ? []
+        : opts.dryRun
+            ? [
+                ...localFiles,
+                ...Object.entries(state.hashCache)
+                    .filter(([p]) => !localPathSet.has(p) && !existsSync(join(vaultDir, p)))
+                    .map(([path, entry]) => ({ path, hash: entry.hash, mtime: entry.mtime })),
+            ]
+            : localFiles;
     // POST sync request
     if (!jsonMode)
         process.stdout.write("Syncing with server...");
+    const tSync = Date.now();
     let syncResp;
     try {
         syncResp = await performSync(baseUrl, vaultSlug, state, syncfilesChanges, privatefilesChanges, clientFilesForSync, opts, token);
@@ -480,6 +498,38 @@ export async function runSync(opts) {
     }
     if (!jsonMode)
         console.log(` ${syncResp.files.length} action(s).`);
+    process.stderr.write(`[gobi-sync] timing performSync: ${syncResp.files.length} actions in ${Date.now() - tSync}ms\n`);
+    // Lazy hash filter for download-only: the server returned its file list, but
+    // some of those files may already exist locally with the same hash (the common
+    // case for a re-activation of an already-synced vault). Drop those actions so
+    // we don't redownload identical bytes. hashFile short-circuits via mtime+size
+    // when state.hashCache has a matching entry, so warm caches stay cheap.
+    if (opts.downloadOnly) {
+        const tFilter = Date.now();
+        let hashed = 0;
+        let alreadyHave = 0;
+        syncResp.files = syncResp.files.filter((f) => {
+            if (f.action !== "download" || !f.hash)
+                return true;
+            const absPath = join(vaultDir, f.path);
+            if (!existsSync(absPath))
+                return true;
+            try {
+                const entry = hashFile(absPath, f.path, state.hashCache);
+                hashed++;
+                state.hashCache[f.path] = entry;
+                if (entry.hash === f.hash) {
+                    alreadyHave++;
+                    return false;
+                }
+                return true;
+            }
+            catch {
+                return true;
+            }
+        });
+        process.stderr.write(`[gobi-sync] timing downloadFilter: hashed ${hashed}, dropped ${alreadyHave} already-matching, ${syncResp.files.length} remain in ${Date.now() - tFilter}ms\n`);
+    }
     // Write plan file if requested (dry-run + --plan-file)
     if (opts.dryRun && opts.planFile) {
         const offlineDeletions = Object.keys(state.hashCache).filter((p) => !localPathSet.has(p) && !existsSync(join(vaultDir, p)));

package/dist/commands/vault.js

@@ -167,7 +167,7 @@ export function registerVaultCommand(program) {
     requireVault(statusCmd);
     const publishCmd = vault
         .command("publish")
-        .description(`Upload ${PUBLISH_FILENAME} to the vault root on webdrive. Triggers post-processing (vault sync, metadata update, Discord notification).`)
+        .description(`Upload ${PUBLISH_FILENAME} to the vault root on webdrive. Triggers post-processing (vault sync, metadata update).`)
         .action(async () => {
         const vaultId = getVaultSlug();
         const filePath = join(process.cwd(), PUBLISH_FILENAME);

package/dist/main.js

@@ -8,8 +8,6 @@ import { registerSpaceCommand } from "./commands/space.js";
 import { registerGlobalCommand } from "./commands/global.js";
 import { registerPersonalCommand } from "./commands/personal.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 { registerUpdateCommand } from "./commands/update.js";
 import { registerMediaCommand } from "./commands/media.js";
@@ -63,8 +61,6 @@ export async function cli() {
     registerGlobalCommand(program);
     registerPersonalCommand(program);
     registerVaultCommand(program);
-    registerSavedCommand(program);
-    registerSessionsCommand(program);
     registerSenseCommand(program);
     registerUpdateCommand(program);
     registerMediaCommand(program);

package/package.json

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

package/skills/gobi-core/SKILL.md

@@ -2,19 +2,18 @@
 name: gobi-core
 description: >-
   Core Gobi CLI: authentication (login/logout/status), space selection (gobi
-  space warp/list), CLI updates (gobi update), and session management
-  (list/get/reply to conversations). Use when the user needs to authenticate,
-  manage sessions, or update the CLI. Vault setup is in the gobi-vault skill;
-  file sync is also in gobi-vault.
+  space warp/list), and CLI updates (gobi update). Use when the user needs to
+  authenticate or update the CLI. Vault setup is in the gobi-vault skill; file
+  sync is also in gobi-vault.
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "2.0.9"
+  version: "2.0.23"
 ---
 
 # gobi-core
 
-Core CLI commands for the Gobi collaborative knowledge platform (v2.0.9).
+Core CLI commands for the Gobi collaborative knowledge platform (v2.0.23).
 
 ## Prerequisites
 
@@ -41,7 +40,7 @@ brew tap gobi-ai/tap && brew install gobi
 - **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.
+- **Space**: A shared community knowledge area. A user can be a member of one or more spaces; each space contains posts, replies, 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.
 
 ## Setup steps (run only what you need)
@@ -51,7 +50,7 @@ There is **no `gobi init`** command — each setup step is its own command, and
 | Step | Command | Unlocks |
 |------|---------|---------|
 | 1. Log in | `gobi auth login` | All authenticated commands |
-| 2. Configure a vault for this directory | `gobi vault init` | Every `gobi vault …` command + lets `global create-post` default to this vault |
+| 2. Configure a vault for this directory | `gobi vault init` | Every `gobi vault …` command; also lets `global create-post --auto-attachments` resolve that vault automatically |
 | 3. Pick an active space for this directory | `gobi space warp` | Every `gobi space …` post/reply/feed command without needing `--space-slug` |
 
 After step 2 + step 3, `.gobi/settings.yaml` looks like:
@@ -73,7 +72,7 @@ gobi auth status
 
 | Command family | Needs vault in `.gobi`? | Needs space in `.gobi`? | Per-call override |
 |----------------|------------------------|------------------------|-------------------|
-| `auth …`, `update`, `session …`, `saved …`, `draft …`, `media …`, `sense …` | no | no | – |
+| `auth …`, `update`, `draft …`, `media …`, `sense …` | no | no | – |
 | `vault publish` / `unpublish` / `sync` | **yes** | no | none — must run `gobi vault init` first |
 | `vault init` | no (it sets it up) | no | – |
 | `space list` / `warp [slug]` / `get [slug]` | no | no | – |
@@ -81,6 +80,9 @@ gobi auth status
 | `global feed` / `list-posts` / `get-post` / `delete-post` / `create-reply` / `edit-reply` / `delete-reply` | no | no | – |
 | `global create-post` | optional¹ | no | command-level `--vault-slug <slug>` |
 | `global edit-post` | optional² | no | command-level `--vault-slug <slug>` |
+| `personal feed` / `list-posts` / `get-post` / `delete-post` / `create-reply` / `edit-reply` / `delete-reply` | no | no | – |
+| `personal create-post` | optional¹ | no | command-level `--vault-slug <slug>` |
+| `personal edit-post` | optional² | no | command-level `--vault-slug <slug>` |
 
 ¹ `global create-post` accepts `--vault-slug` and `--auto-attachments`, both optional. With neither flag and no `vaultSlug` in `.gobi`, the post is created with no `authorVaultSlug` (vault-less personal post) — same as a Space post that isn't attributed to any vault. Set `--vault-slug` (or have `vaultSlug` in `.gobi` plus pass `--auto-attachments`) to attribute it.
 
@@ -93,7 +95,7 @@ When a command needs vault or space and neither `.gobi` nor an override flag pro
 For programmatic/agent usage, always pass `--json` as a **global** option (before the subcommand) to get structured JSON output:
 
 ```bash
-gobi --json session list
+gobi --json space list
 ```
 
 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.
@@ -106,26 +108,19 @@ JSON responses have the shape `{ "success": true, "data": ... }` on success or `
   - `gobi auth logout` — Log out of Gobi and remove stored credentials.
 - `gobi space list` — List spaces you are a member of.
 - `gobi space warp` — Select the active space. Pass a slug to warp directly, or omit for interactive selection.
-- `gobi session` — Session commands (get, list, reply).
-  - `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 create-reply` — Send a human reply to a session you are a member of.
 - `gobi update` — Update gobi-cli to the latest version.
 
 > Vault setup (`gobi vault init`) and file sync (`gobi vault sync`) live in the **gobi-vault** skill.
 
 ## Confirm before mutating
 
-`gobi session create-reply` posts a human-attributed message into a chat session — the message becomes part of the user's permanent chat history and triggers the agent to respond. Before running it, confirm with the user — show the exact session id and the message text. This applies even when running autonomously.
-
 `auth login` / `auth logout` are explicit user-driven commands; they prompt the user themselves and don't need an extra confirmation layer. `update` upgrades the CLI binary — fine to run without extra confirmation.
 
-Read-only commands (`auth status`, `session list`, `session get`, `space list`) run without confirmation.
+Read-only commands (`auth status`, `space list`) run without confirmation.
 
 ## Reference Documentation
 
 - [gobi auth](references/auth.md)
-- [gobi session](references/session.md)
 - [gobi update](references/update.md)
 - [gobi space (list/warp)](references/space.md)
 
@@ -143,4 +138,5 @@ Read-only commands (`auth status`, `session list`, `session get`, `space list`)
 |----------|---------|-------------|
 | `GOBI_BASE_URL` | `https://api.joingobi.com` | API server URL |
 | `GOBI_WEBDRIVE_BASE_URL` | `https://webdrive.joingobi.com` | File storage URL |
+| `GOBI_WEB_BASE_URL` | `https://gobispace.com` | Public web URL (used when assembling shareable links) |
 | `GOBI_SESSION_ID` | — | Default `--session` for `gobi draft add` (set automatically inside agent runs) |

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

@@ -11,19 +11,7 @@ Options:
 
 Commands:
   list                                    List spaces you are a member of.
-  get [options] [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 authored in a space.
-  delete-post [options] <postId>          Delete a post you authored in a space.
-  create-reply [options] <postId>         Create a reply to a post in a space.
-  edit-reply [options] <replyId>          Edit a reply you authored in a space.
-  delete-reply [options] <replyId>        Delete a reply you authored in a space.
   help [command]                          display help for command
 ```