@gobi-ai/cli 1.3.8 → 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. Search and ask brains, publish brain documents, create threads, manage sessions, generate images and videos.",
-      "version": "1.3.8",
+      "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.1",
       "author": {
         "name": "gobi-ai"
       },
@@ -18,9 +18,8 @@
       "skills": [
         "./skills/gobi-core",
         "./skills/gobi-space",
-        "./skills/gobi-brain",
-        "./skills/gobi-feed",
-        "./skills/gobi-notes",
+        "./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": "1.3.8",
+  "version": "2.0.1",
   "author": {
     "name": "gobi-ai"
   },
@@ -9,9 +9,8 @@
   "skills": [
     "./skills/gobi-core",
     "./skills/gobi-space",
-    "./skills/gobi-brain",
-    "./skills/gobi-feed",
-    "./skills/gobi-notes",
+    "./skills/gobi-vault",
+    "./skills/gobi-saved",
     "./skills/gobi-draft",
     "./skills/gobi-media",
     "./skills/gobi-sense",

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,26 +38,83 @@ npm link
 ## Quick start
 
 ```sh
-# Initialize — logs in and sets up your vault
+# 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
 
-# Search brains across your spaces
-gobi brain search --query "machine learning"
+# Publish your vault profile (after editing PUBLISH.md frontmatter)
+gobi vault publish
+
+# Sync local files with the webdrive
+gobi vault sync
+
+# Browse the global feed and create a personal post
+gobi global feed
+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
 
-# Ask a brain a question
-gobi brain ask --vault-slug my-vault --question "What is RAG?"
+# 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 |
 
@@ -61,76 +122,73 @@ gobi brain ask --vault-slug my-vault --question "What is RAG?"
 
 | Command | Description |
 |---------|-------------|
-| `gobi init` | Log in (if needed) and select or create a vault |
+| `gobi init` | Log in (if needed) and select or create a vault. Creates `PUBLISH.md` if missing. |
 | `gobi space list` | List spaces you are a member of |
 | `gobi space warp [spaceSlug]` | Select the active space (interactive if slug omitted) |
 
-### Brains
+### Vault
 
 | Command | Description |
 |---------|-------------|
-| `gobi brain search --query <q>` | Search public brains by text and semantic similarity |
-| `gobi brain ask --vault-slug <slug> --question <q>` | Ask a brain a question (creates a 1:1 session) |
-| `gobi brain publish` | Upload `BRAIN.md` to your vault |
-| `gobi brain unpublish` | Remove `BRAIN.md` from your vault |
+| `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. |
 
-Public brains are accessible at `https://gobispace.com/@{vaultSlug}`.
+Public vaults are accessible at `https://gobispace.com/@{vaultSlug}`.
 
-`brain ask` also accepts `--rich-text <json>` (mutually exclusive with `--question`) and `--mode <auto|manual>`.
+`vault sync` options:
+
+| Option | Description |
+|--------|-------------|
+| `--upload-only` | Only upload local changes to server |
+| `--download-only` | Only download server changes to local |
+| `--conflict <strategy>` | Conflict resolution: `ask` (default), `server`, `client`, `skip` |
+| `--dir <path>` | Local vault directory (default: current directory) |
+| `--dry-run` | Preview changes without making them |
+| `--full` | Full sync: ignore cursor and hash cache, re-check every file |
+| `--path <path>` | Restrict sync to specific file/folder (repeatable) |
+| `--plan-file <path>` | Write dry-run plan to file, or read plan to execute |
+| `--execute` | Execute a previously written plan file (requires `--plan-file`) |
+| `--conflict-choices <json>` | Per-file conflict resolutions as JSON (use with `--execute`) |
 
 ### 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 |
 |---------|-------------|
 | `gobi space get [spaceSlug]` | Show space details (uses current space if slug omitted) |
-| `gobi space messages` | Unified message feed (threads + replies, newest first) |
-| `gobi space ancestors <threadId>` | Walk a thread/reply's lineage from root → immediate parent |
-
-### Feed
-
-| Command | Description |
-|---------|-------------|
-| `gobi feed list` | List recent brain updates from the global public feed |
-| `gobi feed get <updateId>` | Get a feed brain update and its replies |
-| `gobi feed post-reply <updateId> --content <c>` | Post a reply to a brain update in the feed |
-| `gobi feed edit-reply <replyId> --content <c>` | Edit a reply you authored |
-| `gobi feed delete-reply <replyId>` | Delete a reply you authored |
-
-`feed list` and `feed get` accept `--limit`/`--cursor` for pagination.
-
-### Threads
-
-> **Migration note:** Brain-update commands have been removed. To post user-level content, use `gobi global create-thread` (global space) or `gobi space create-thread` (a specific space).
-
-| Command | Description |
-|---------|-------------|
-| `gobi space list-threads` | List threads in the current space |
-| `gobi space get-thread <id>` | Get a thread and its replies |
-| `gobi space create-thread --title <t> --content <c>` | Create a thread |
-| `gobi space edit-thread <id> [--title <t>] [--content <c>]` | Edit a thread (at least one required) |
-| `gobi space delete-thread <id>` | Delete a thread |
-
-### Replies
-
-| Command | Description |
-|---------|-------------|
-| `gobi space create-reply <threadId> --content <c>` | Reply to a thread |
+| `gobi space feed` | Unified feed (posts + replies, newest first) in the space |
+| `gobi space list-topics` | List topics in the space, ordered by most recent linkage |
+| `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> [--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 thread space
+### Global feed (personal posts)
 
-The global thread space is a slugless message feed 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 messages` | List the global unified message feed (newest first) |
-| `gobi global get-thread <id>` | Get a global thread and its direct replies |
-| `gobi global ancestors <id>` | Walk a global thread/reply's lineage |
-| `gobi global create-thread [--title <t>] (--content <c> \| --rich-text <json>)` | Create a thread in the global space |
-| `gobi global reply <threadId> (--content <c> \| --rich-text <json>)` | Reply to a global thread |
+| `gobi global feed` | List the global public feed (posts + replies, newest first) |
+| `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
 
@@ -144,6 +202,8 @@ The global thread space is a slugless message feed visible across all spaces.
 
 ### 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 |
@@ -151,59 +211,68 @@ The global thread space is a slugless message feed visible across all spaces.
 
 Times are ISO 8601 UTC (e.g. `2026-03-20T00:00:00Z`).
 
-### Notes
+### Saved
+
+`gobi saved` is the user's personal saved-knowledge collection — notes you author and posts you bookmark.
+
+#### Saved notes
 
 | Command | Description |
 |---------|-------------|
-| `gobi notes list [--date YYYY-MM-DD]` | List your notes (recent via cursor, or all for a day) |
-| `gobi notes get <id>` | Get a single note |
-| `gobi notes create --content <c>` | Create a note (use `-` to read content from stdin) |
-| `gobi notes edit <id> [--content <c>] [--agent-id <id>]` | Edit a note (at least one required; `--agent-id null` clears the link) |
-| `gobi notes delete <id>` | Delete a note you authored |
+| `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 (`--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).
+
+#### Saved posts
 
-`notes list` and `notes create` accept `--timezone <iana>` (default: system timezone) for day boundaries.
-`notes list` also accepts `--limit`/`--cursor` for pagination.
+| Command | Description |
+|---------|-------------|
+| `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 (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 |
 
-### Sync
+### Media generation
+
+Image, video, and avatar generation. See the `gobi-media` skill for full workflows.
 
 | Command | Description |
 |---------|-------------|
-| `gobi sync` | Sync local vault files with Gobi Webdrive |
-
-| Option | Description |
-|--------|-------------|
-| `--upload-only` | Only upload local changes to server |
-| `--download-only` | Only download server changes to local |
-| `--conflict <strategy>` | Conflict resolution: `ask` (default), `server`, `client`, `skip` |
-| `--dir <path>` | Local vault directory (default: current directory) |
-| `--dry-run` | Preview changes without making them |
-| `--full` | Full sync: ignore cursor and hash cache, re-check every file |
-| `--path <path>` | Restrict sync to specific file/folder (repeatable) |
-| `--plan-file <path>` | Write dry-run plan to file, or read plan to execute |
-| `--execute` | Execute a previously written plan file (requires `--plan-file`) |
-| `--conflict-choices <json>` | Per-file conflict resolutions as JSON (use with `--execute`) |
+| `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 `space create-thread`, `space edit-thread`, `space edit-reply` |
+| `--vault-slug <slug>` | Per-command | Override the default vault — see each command's docs |
 
 ## Configuration
 
@@ -213,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
 
@@ -220,6 +290,26 @@ 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
 
@@ -237,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-explore.md

@@ -1,20 +1,20 @@
 ---
 name: space-explore
-description: Explore what's happening in the active Gobi space — threads and learnings shared by others.
+description: Explore what's happening in the active Gobi space — posts and learnings shared by others.
 argument-hint: "[topic or keyword]"
 ---
 
 Always use the globally installed `gobi` binary (not via npx or ts-node).
 
-Explore the active Gobi space to surface discussions, topics, and learnings from others:
+Explore the active Gobi space to surface posts, topics, and learnings from others:
 
 1. Run these three commands in parallel:
-   - `gobi --json space list-threads` — recent discussions in the space
-   - `gobi --json space list-topics` — available topics across the platform
-   - `gobi --json feed list` — learnings and brain updates shared by members across the platform
-2. Display results in a readable summary, grouped by type (Topics / Discussions / Learnings).
-3. If `$ARGUMENTS` is provided, filter or highlight entries relevant to that topic or keyword. If a matching topic is found, also run `gobi --json space list-topic-threads <topicSlug>` to show threads tagged with that topic.
+   - `gobi --json space list-posts` — recent posts in the space
+   - `gobi --json space list-topics` — available topics in the space
+   - `gobi --json global feed` — recent posts and replies shared by members across the platform
+2. Display results in a readable summary, grouped by type (Topics / Space posts / Global feed).
+3. If `$ARGUMENTS` is provided, filter or highlight entries relevant to that topic or keyword. If a matching topic is found, also run `gobi --json space list-topic-posts <topicSlug>` to show posts tagged with that topic.
 4. Ask the user if they'd like to read anything in full:
-   - For a topic: run `gobi space list-topic-threads <topicSlug>` and show the threads.
-   - For a thread: run `gobi space get-thread <threadId>` and show it with replies.
-   - For a feed brain update: run `gobi feed get <updateId>` to show the update with its replies.
+   - For a topic: run `gobi space list-topic-posts <topicSlug>` and show the posts.
+   - For a space post: run `gobi space get-post <postId>` and show it with ancestors and replies.
+   - For a global feed post: run `gobi global get-post <postId>` to show it with ancestors and replies.

package/commands/space-share.md

@@ -1,6 +1,6 @@
 ---
 name: space-share
-description: Summarize recent learnings from this session and draft a brain update to share to the active Gobi space.
+description: Summarize recent learnings from this session and draft a personal post to share to the global feed.
 argument-hint: "[context]"
 ---
 
@@ -8,15 +8,15 @@ Always use the globally installed `gobi` binary (not via npx or ts-node).
 
 ## Pre-flight check
 
-First, verify the user is warped into a space:
+First, verify the user is set up:
 
 ```bash
 gobi --json auth status
 ```
 
-Check that `.gobi/settings.yaml` exists and contains both `vaultSlug` and `selectedSpaceSlug`. If not warped, stop and ask the user to run `/gobi:warp` first.
+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 brain update
+## 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").
 
@@ -34,12 +34,18 @@ Focus on:
 
 ## Present to the user
 
-Format the draft as a short brain update (2–5 bullet points max). Show it to the user and ask for confirmation before posting.
+Format the draft as a short post (2–5 bullet points max). Show it to the user and ask for confirmation before posting.
 
-Once confirmed, post it:
+Once confirmed, post it to the global feed:
 
 ```bash
-gobi brain post-update --title "<short title>" --content "<confirmed content>"
+gobi global create-post --title "<short title>" --content "<confirmed content>"
+```
+
+Or to the active space:
+
+```bash
+gobi space create-post --title "<short title>" --content "<confirmed content>"
 ```
 
 Confirm success and show the user the result.

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) {