@gobi-ai/cli 2.0.4 → 2.0.6

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.4",
+  "version": "2.0.6",
   "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.4",
+      "version": "2.0.6",
       "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": "2.0.4",
+  "version": "2.0.6",
   "author": {
     "name": "gobi-ai"
   },

package/README.md

@@ -38,10 +38,13 @@ npm link
 ## Quick start
 
 ```sh
-# Initialize — log in and set up your vault (creates PUBLISH.md if missing)
-gobi init
+# Sign in (device-code flow — opens a URL, you authorize, the CLI polls)
+gobi auth login
 
-# Select a community space
+# Set up the vault for the current directory (creates PUBLISH.md if missing)
+gobi vault init
+
+# Select a community space for the current directory
 gobi space warp
 
 # Publish your vault profile (after editing PUBLISH.md frontmatter)
@@ -52,9 +55,17 @@ 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
+gobi global create-post --title "Hello" --content "Trying gobi"
 ```
 
+Each setup step unlocks a different family of commands — run only the ones the workflow needs:
+
+| 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 space warp` | Every `gobi space …` command without needing `--space-slug` |
+
 ---
 
 ## Using gobi from an agent
@@ -82,7 +93,7 @@ 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 |
+| `.gobi/settings.yaml` | Per-project `vaultSlug` and `selectedSpaceSlug` | `gobi vault init` and `gobi space warp` write |
 
 An agent should check these before calling commands that need a vault or space:
 
@@ -94,9 +105,9 @@ gobi --json auth status
 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.
+If `.gobi/settings.yaml` is missing, `gobi vault 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.
+`gobi space …` commands accept `--space-slug <slug>` (on the parent group or any subcommand) to override the default space. Per-command `--vault-slug` overrides are documented inline.
 
 ### Headless auth
 
@@ -122,7 +133,8 @@ When the runtime exports `GOBI_SESSION_ID`, `gobi draft add` picks it up automat
 
 | Command | Description |
 |---------|-------------|
-| `gobi init` | Log in (if needed) and select or create a vault. Creates `PUBLISH.md` if missing. |
+| `gobi vault init` | Select or create the vault for this directory. Writes `vaultSlug` to `.gobi/settings.yaml` and seeds `PUBLISH.md`. |
+| `gobi vault list` | List vaults you own |
 | `gobi space list` | List spaces you are a member of |
 | `gobi space warp [spaceSlug]` | Select the active space (interactive if slug omitted) |
 
@@ -164,13 +176,13 @@ A *Space* is a community knowledge area. A *Space Post* lives in one space. The
 | `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 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]` | 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 |
+| `gobi space create-reply <postId> (--content <c> \| --rich-text <json>) [--vault-slug <slug>] [--auto-attachments]` | Create a reply to a space 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)
 
@@ -178,14 +190,14 @@ A *Personal Post* lives on the author's profile (their primary vault) and surfac
 
 | Command | Description |
 |---------|-------------|
-| `gobi global feed` | List the global public feed (posts + replies, newest first) |
+| `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>` | Get a personal post with its ancestors and replies |
+| `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]` | 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 create-reply <postId> (--content <c> \| --rich-text <json>) [--vault-slug <slug>] [--auto-attachments]` | 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`.
@@ -196,9 +208,9 @@ A *Personal Post* lives on the author's profile (their primary vault) and surfac
 |---------|-------------|
 | `gobi session list` | List your sessions |
 | `gobi session get <id>` | Get a session and its messages |
-| `gobi session reply <id> --content <c>` | Send a message in a session |
+| `gobi session create-reply <id> --content <c>` | Send a message in a session |
 
-`session reply` also accepts `--rich-text <json>` (mutually exclusive with `--content`).
+`session create-reply` also accepts `--rich-text <json>` (mutually exclusive with `--content`).
 
 ### Sense
 
@@ -206,8 +218,8 @@ 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 |
-| `gobi sense transcriptions --start-time <iso> --end-time <iso>` | Fetch transcription records in a time range |
+| `gobi sense list-activities --start-time <iso> --end-time <iso>` | List activity records in a time range |
+| `gobi sense list-transcriptions --start-time <iso> --end-time <iso>` | List transcription records in a time range |
 
 Times are ISO 8601 UTC (e.g. `2026-03-20T00:00:00Z`).
 
@@ -219,22 +231,22 @@ Times are ISO 8601 UTC (e.g. `2026-03-20T00:00:00Z`).
 
 | Command | Description |
 |---------|-------------|
-| `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 |
+| `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 note list` and `saved note create` accept `--timezone <iana>` (default: system timezone).
+`saved list-notes` and `saved create-note` accept `--timezone <iana>` (default: system timezone).
 
-#### Saved posts
+#### Saved posts (bookmarks)
 
 | 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 |
+| `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
 
@@ -247,7 +259,7 @@ Each action is `{ label, message? }`: `label` is the short button text (1–80 c
 | 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 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 delete <id>` | Delete a draft |
 | `gobi draft prioritize <id> <priority>` | Set priority (lower = higher) |
@@ -260,12 +272,14 @@ Image, video, and avatar generation. See the `gobi-media` skill for full workflo
 
 | 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 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 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 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 |
 
 ### Global options
@@ -302,13 +316,13 @@ The CLI ships a `.claude-plugin/` manifest with eight skills that wrap the comma
 
 | Skill | Covers |
 |-------|--------|
-| `gobi-core` | Auth, init, session, update, space list/warp |
-| `gobi-vault` | `gobi vault publish/unpublish/sync` |
+| `gobi-core` | Auth, session, update, space list/warp |
+| `gobi-vault` | `gobi vault init/list/publish/unpublish/sync` |
 | `gobi-space` | `gobi space …` and `gobi global …` |
-| `gobi-saved` | `gobi saved note …` and `gobi saved post …` |
+| `gobi-saved` | `gobi saved list-notes/create-note/list-posts/create-post/…` |
 | `gobi-draft` | `gobi draft …` |
 | `gobi-media` | `gobi media …` |
-| `gobi-sense` | `gobi sense activities/transcriptions` |
+| `gobi-sense` | `gobi sense list-activities/list-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`.

package/commands/space-share.md

@@ -14,7 +14,7 @@ First, verify the user is set up:
 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.
+Check that `.gobi/settings.yaml` exists. If you plan to publish to a Space (`gobi space create-post`), it must contain `selectedSpaceSlug` — otherwise stop and ask the user to run `gobi space warp` first. `vaultSlug` is optional for `gobi global create-post`; if missing the post is created without an `authorVaultSlug` (vault-less). Run `gobi vault init` if the user wants the post attributed to a vault they own.
 
 ## Draft a personal post
 

package/dist/commands/auth.js

@@ -1,7 +1,8 @@
 import { BASE_URL, POLL_MAX_DURATION_MS } from "../constants.js";
 import { DeviceCodeError } from "../errors.js";
 import { storeTokens, logout, isAuthenticated, getCurrentUser, } from "../auth/manager.js";
-import { printContext } from "./init.js";
+import { readSettings } from "./init.js";
+import { isJsonMode, jsonOut } from "./utils.js";
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -69,22 +70,50 @@ export function registerAuthCommand(program) {
         .command("status")
         .description("Check whether you are currently authenticated with Gobi.")
         .action(() => {
-        if (isAuthenticated()) {
-            const user = getCurrentUser();
-            const name = user?.name || "Unknown";
-            const email = user?.email || "Unknown";
-            console.log(`Authenticated as ${name} (${email})`);
-            printContext();
-        }
-        else {
+        const settings = readSettings();
+        const vaultSlug = settings?.vaultSlug ?? null;
+        const spaceSlug = settings?.selectedSpaceSlug ?? null;
+        if (!isAuthenticated()) {
+            if (isJsonMode(auth)) {
+                jsonOut({
+                    authenticated: false,
+                    user: null,
+                    vaultSlug,
+                    spaceSlug,
+                });
+                return;
+            }
             console.log("You are not authenticated. Use 'gobi auth login' to log in.");
+            return;
+        }
+        const user = getCurrentUser();
+        if (isJsonMode(auth)) {
+            jsonOut({
+                authenticated: true,
+                user: {
+                    name: user?.name ?? null,
+                    email: user?.email ?? null,
+                },
+                vaultSlug,
+                spaceSlug,
+            });
+            return;
         }
+        const name = user?.name || "Unknown";
+        const email = user?.email || "Unknown";
+        console.log(`Authenticated as ${name} (${email})`);
+        console.log(`  Vault: ${vaultSlug ?? "(not set)"}`);
+        console.log(`  Space: ${spaceSlug ?? "(not set)"}`);
     });
     auth
         .command("logout")
         .description("Log out of Gobi and remove stored credentials.")
         .action(async () => {
         await logout();
+        if (isJsonMode(auth)) {
+            jsonOut({ loggedOut: true });
+            return;
+        }
         console.log("Logged out. Credentials removed.");
     });
 }

package/dist/commands/draft.js

@@ -43,7 +43,7 @@ export function registerDraftCommand(program) {
     draft
         .command("list")
         .description("List drafts (priority ASC, then newest first).")
-        .option("--limit <number>", "Max drafts to return (1-200)", "50")
+        .option("--limit <number>", "Items per page", "20")
         .action(async (opts) => {
         const params = { limit: parseInt(opts.limit, 10) };
         const resp = (await apiGet("/app/drafts", params));
@@ -63,7 +63,7 @@ export function registerDraftCommand(program) {
     // ── Get ──
     draft
         .command("get <draftId>")
-        .description("Show one draft with its history and suggested actions.")
+        .description("Get one draft with its history and suggested actions.")
         .action(async (draftId) => {
         const resp = (await apiGet(`/app/drafts/${draftId}`));
         const d = unwrapResp(resp);
@@ -121,21 +121,18 @@ export function registerDraftCommand(program) {
     // ── Add ──
     draft
         .command("add <title> <content>")
-        .description("Add a draft. Pass '-' for content to read from stdin. Pass --action up to 3 times to attach AI-suggested actions. Requires a chat session — the agent runtime exports GOBI_SESSION_ID automatically; outside that, pass --session.")
-        .option("--session <sessionId>", "Originating chat session UUID. Falls back to $GOBI_SESSION_ID when set.")
+        .description("Add a draft. Pass '-' for content to read from stdin. Pass --action up to 3 times to attach AI-suggested actions. Session id is optional: the Gobi agent runtime exports GOBI_SESSION_ID automatically and `--session` takes precedence; if neither is set, the server mints a new chat session anchored to your primary vault and seeds it with the draft so clicking an action later has somewhere to land.")
+        .option("--session <sessionId>", "Originating chat session UUID. Falls back to $GOBI_SESSION_ID; if unset, the server creates a new session.")
         .option("--priority <number>", "Priority (lower = higher), default 100")
         .option("--action <label[::message]>", "Suggested action (repeatable, max 3). `label` is the button text; an optional `::message` suffix is what the user is taken to be saying to the agent on click. Without the suffix, the message falls back to the label.", (value, prev = []) => [...prev, value], [])
         .action(async (title, content, opts) => {
-        const sessionId = opts.session || process.env.GOBI_SESSION_ID || "";
-        if (!sessionId) {
-            console.error("Error: missing session id. Pass --session <uuid> or set GOBI_SESSION_ID in the environment.");
-            process.exit(1);
-        }
+        const sessionId = opts.session || process.env.GOBI_SESSION_ID;
         const body = {
             title,
             content: readContent(content),
-            sessionId,
         };
+        if (sessionId)
+            body.sessionId = sessionId;
         if (opts.priority)
             body.priority = parseInt(opts.priority, 10);
         const actions = parseActionFlags(opts.action);
@@ -156,7 +153,7 @@ export function registerDraftCommand(program) {
         .action(async (draftId) => {
         await apiDelete(`/app/drafts/${draftId}`);
         if (isJsonMode(draft)) {
-            jsonOut({ deleted: draftId });
+            jsonOut({ id: draftId });
             return;
         }
         console.log(`Deleted ${draftId}.`);
@@ -183,8 +180,7 @@ export function registerDraftCommand(program) {
         .action(async (draftId, actionIndex) => {
         const idx = parseInt(actionIndex, 10);
         if (Number.isNaN(idx) || idx < 0 || idx > 2) {
-            console.error("Error: actionIndex must be 0, 1, or 2.");
-            process.exit(1);
+            throw new Error("actionIndex must be 0, 1, or 2.");
         }
         const resp = (await apiPost(`/app/drafts/${draftId}/action`, {
             actionIndex: idx,

package/dist/commands/global.js

@@ -32,7 +32,7 @@ export function registerGlobalCommand(program) {
     // ── Feed (unified) ──
     global
         .command("feed")
-        .description("List the global public feed (posts and replies, newest first).")
+        .description("List the unified feed (posts and replies, newest first) in the global public feed.")
         .option("--limit <number>", "Items per page", "20")
         .option("--cursor <string>", "Pagination cursor from previous response")
         .option("--following", "Only include posts from authors you follow")
@@ -110,7 +110,7 @@ export function registerGlobalCommand(program) {
     global
         .command("get-post <postId>")
         .description("Get a global post with its ancestors and replies (paginated).")
-        .option("--limit <number>", "Replies per page", "20")
+        .option("--limit <number>", "Items per page", "20")
         .option("--cursor <string>", "Pagination cursor from previous response")
         .option("--full", "Show full reply content without truncation")
         .action(async (postId, opts) => {
@@ -177,12 +177,12 @@ export function registerGlobalCommand(program) {
     // ── Create post ──
     global
         .command("create-post")
-        .description("Create a post in the global feed (publishes from your vault).")
+        .description("Create a post in the global feed. --vault-slug attributes it to a vault you own; defaults to your primary vault.")
         .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>", "Author vault slug (overrides .gobi/settings.yaml)")
-        .option("--auto-attachments", "Upload wiki-linked [[files]] to webdrive before posting")
+        .option("--vault-slug <vaultSlug>", "Attribute the post to this vault (sets authorVaultSlug). Defaults to your primary vault.")
+        .option("--auto-attachments", "Upload wiki-linked [[files]] to webdrive before posting (also sets authorVaultSlug to that vault)")
         .action(async (opts) => {
         if (!opts.content && !opts.richText) {
             throw new Error("Provide either --content or --rich-text.");
@@ -190,16 +190,19 @@ export function registerGlobalCommand(program) {
         if (opts.content && opts.richText) {
             throw new Error("--content and --rich-text are mutually exclusive.");
         }
-        const vaultSlug = resolveVaultSlug(opts);
+        let authorVaultSlug;
+        if (opts.vaultSlug || 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) {
+            if (opts.autoAttachments && authorVaultSlug) {
                 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;
         }
@@ -213,7 +216,9 @@ export function registerGlobalCommand(program) {
             }
             body.richText = parsed;
         }
-        const resp = (await apiPost(`/posts/vault/${vaultSlug}`, body));
+        if (authorVaultSlug)
+            body.authorVaultSlug = authorVaultSlug;
+        const resp = (await apiPost(`/posts`, body));
         const post = unwrapResp(resp);
         if (isJsonMode(global)) {
             jsonOut(post);
@@ -231,22 +236,35 @@ 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.")
+        .option("--vault-slug <vaultSlug>", "Attribute the post to this vault (sets authorVaultSlug).")
+        .option("--auto-attachments", "Upload wiki-linked [[files]] to webdrive before editing (uses --vault-slug or .gobi vault)")
         .action(async (postId, opts) => {
+        const wantsVaultChange = !!(opts.vaultSlug || opts.autoAttachments);
         if (opts.title == null &&
             opts.content == null &&
             opts.richText == null &&
-            opts.vaultSlug === undefined) {
+            !wantsVaultChange) {
             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.");
         }
+        let authorVaultSlug;
+        if (opts.vaultSlug || opts.autoAttachments) {
+            authorVaultSlug = resolveVaultSlug(opts);
+        }
         const body = {};
         if (opts.title != null)
             body.title = opts.title;
-        if (opts.content != null)
-            body.content = readContent(opts.content);
+        if (opts.content != null) {
+            const content = readContent(opts.content);
+            if (opts.autoAttachments && authorVaultSlug) {
+                const token = await getValidToken();
+                const links = extractWikiLinks(content);
+                await uploadAttachments(authorVaultSlug, links, token, { addToSyncfiles: true });
+            }
+            body.content = content;
+        }
         if (opts.richText != null) {
             let parsed;
             try {
@@ -257,8 +275,8 @@ export function registerGlobalCommand(program) {
             }
             body.richText = parsed;
         }
-        if (opts.vaultSlug !== undefined)
-            body.authorVaultSlug = opts.vaultSlug;
+        if (authorVaultSlug !== undefined)
+            body.authorVaultSlug = authorVaultSlug;
         const resp = (await apiPatch(`/posts/${postId}`, body));
         const post = unwrapResp(resp);
         if (isJsonMode(global)) {
@@ -282,9 +300,11 @@ export function registerGlobalCommand(program) {
     // ── Reply ──
     global
         .command("create-reply <postId>")
-        .description("Reply to a post in the global feed.")
+        .description("Create a reply to a post in the global feed.")
         .option("--content <content>", "Reply content (markdown supported, use \"-\" for stdin)")
         .option("--rich-text <richText>", "Rich-text JSON array (mutually exclusive with --content)")
+        .option("--vault-slug <vaultSlug>", "Attribute the reply to this vault (sets authorVaultSlug). Also used as upload destination for --auto-attachments.")
+        .option("--auto-attachments", "Upload wiki-linked [[files]] to webdrive before posting (also attributes the reply to that vault)")
         .action(async (postId, opts) => {
         if (!opts.content && !opts.richText) {
             throw new Error("Provide either --content or --rich-text.");
@@ -292,9 +312,20 @@ export function registerGlobalCommand(program) {
         if (opts.content && opts.richText) {
             throw new Error("--content and --rich-text are mutually exclusive.");
         }
+        let authorVaultSlug;
+        if (opts.vaultSlug || opts.autoAttachments) {
+            authorVaultSlug = resolveVaultSlug(opts);
+        }
         const body = {};
-        if (opts.content != null)
-            body.content = readContent(opts.content);
+        if (opts.content != null) {
+            const content = readContent(opts.content);
+            if (opts.autoAttachments && authorVaultSlug) {
+                const token = await getValidToken();
+                const links = extractWikiLinks(content);
+                await uploadAttachments(authorVaultSlug, links, token, { addToSyncfiles: true });
+            }
+            body.content = content;
+        }
         if (opts.richText != null) {
             let parsed;
             try {
@@ -305,6 +336,8 @@ export function registerGlobalCommand(program) {
             }
             body.richText = parsed;
         }
+        if (authorVaultSlug)
+            body.authorVaultSlug = authorVaultSlug;
         const resp = (await apiPost(`/posts/${postId}/replies`, body));
         const reply = unwrapResp(resp);
         if (isJsonMode(global)) {
@@ -316,12 +349,45 @@ export function registerGlobalCommand(program) {
     global
         .command("edit-reply <replyId>")
         .description("Edit a reply you authored in the global feed.")
-        .requiredOption("--content <content>", "New reply content (markdown supported, use \"-\" for stdin)")
+        .option("--content <content>", "New reply content (markdown supported, use \"-\" for stdin)")
+        .option("--rich-text <richText>", "Rich-text JSON array (mutually exclusive with --content)")
+        .option("--vault-slug <vaultSlug>", "Attribute the reply to this vault (sets authorVaultSlug). Also used as upload destination for --auto-attachments.")
+        .option("--auto-attachments", "Upload wiki-linked [[files]] to webdrive before editing (also attributes the reply to that vault)")
         .action(async (replyId, opts) => {
-        const content = readContent(opts.content);
-        const resp = (await apiPatch(`/posts/replies/${replyId}`, {
-            content,
-        }));
+        const wantsVaultChange = !!(opts.vaultSlug || opts.autoAttachments);
+        if (opts.content == null && opts.richText == null && !wantsVaultChange) {
+            throw new Error("Provide at least --content, --rich-text, or --vault-slug to update.");
+        }
+        if (opts.content && opts.richText) {
+            throw new Error("--content and --rich-text are mutually exclusive.");
+        }
+        let authorVaultSlug;
+        if (opts.vaultSlug || opts.autoAttachments) {
+            authorVaultSlug = resolveVaultSlug(opts);
+        }
+        const body = {};
+        if (opts.content != null) {
+            const content = readContent(opts.content);
+            if (opts.autoAttachments && authorVaultSlug) {
+                const token = await getValidToken();
+                const links = extractWikiLinks(content);
+                await uploadAttachments(authorVaultSlug, links, token, { addToSyncfiles: true });
+            }
+            body.content = content;
+        }
+        if (opts.richText != null) {
+            let parsed;
+            try {
+                parsed = JSON.parse(opts.richText);
+            }
+            catch {
+                throw new Error("Invalid --rich-text JSON.");
+            }
+            body.richText = parsed;
+        }
+        if (authorVaultSlug !== undefined)
+            body.authorVaultSlug = authorVaultSlug;
+        const resp = (await apiPatch(`/posts/replies/${replyId}`, body));
         const reply = unwrapResp(resp);
         if (isJsonMode(global)) {
             jsonOut(reply);
@@ -335,7 +401,7 @@ export function registerGlobalCommand(program) {
         .action(async (replyId) => {
         await apiDelete(`/posts/replies/${replyId}`);
         if (isJsonMode(global)) {
-            jsonOut({ replyId });
+            jsonOut({ id: replyId });
             return;
         }
         console.log(`Reply ${replyId} deleted.`);