@gobi-ai/cli 2.0.4 → 2.0.6

package/skills/gobi-space/SKILL.md

@@ -10,12 +10,12 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "2.0.0"
+  version: "2.0.6"
 ---
 
 # gobi-space
 
-Gobi space and global posts (v2.0.0).
+Gobi space and global posts (v2.0.6).
 
 Requires gobi-cli installed and authenticated. See the **gobi-core** skill for setup.
 
@@ -31,19 +31,37 @@ Anything you can do to a Space Post (reply, edit, delete, attribute to a vault)
 - When the user wants to explore or catch up on what's happening in their space, invoke `/gobi:space-explore`.
 - When the user wants to share or post learnings from the current session, invoke `/gobi:space-share`.
 
+## Authoring posts: title vs. content
+
+`create-post` (and `edit-post`) on both `gobi space` and `gobi global` take `--title` and `--content` as **separate** fields. The title is rendered as the post heading by the UI, so it must not also appear inside `--content`:
+
+- Do **not** repeat the title as a heading (`# My title`) or as the first line of `--content`. The reader will see it twice.
+- Start `--content` with the body itself.
+- If you only have a single blob of markdown, split it: take the first heading or sentence as `--title`, drop that line, and pass the rest as `--content`.
+- On `edit-post`, the same rule applies — if you change `--title`, scrub any duplicate of the old or new title from `--content` too.
+
+The same applies to replies: a reply has only `--content` (no title), so do not synthesize a title-like heading at the top of a reply either.
+
 ## Author vault attribution (`--vault-slug`)
 
 Both `gobi space create-post` / `edit-post` and `gobi global create-post` / `edit-post` accept `--vault-slug <slug>`. When set, the slug becomes the post's `authorVaultSlug` — the vault the user is posting on behalf of. The caller must hold `role: 'owner'` on that vault. Pass `--vault-slug ""` on edit to detach.
 
 `--auto-attachments` resolves a vault for upload and **also** uses it as `authorVaultSlug` automatically — one flag, two effects.
 
-## Space Slug Override
+## Prerequisites & space slug
 
-`gobi space` commands use the space from `.gobi/settings.yaml`. Override it with a parent-level flag:
+`gobi space` commands do **not** require a vault to be configured in `.gobi/settings.yaml`. They only need a space slug, which can come from either:
 
-```bash
-gobi space --space-slug <slug> list-posts
-```
+1. `selectedSpaceSlug` in `.gobi/settings.yaml` (set via `gobi space warp`), or
+2. A parent-level `--space-slug <slug>` flag passed at call time, which overrides `.gobi`:
+
+   ```bash
+   gobi space --space-slug <slug> list-posts
+   ```
+
+If `.gobi/settings.yaml` has no `selectedSpaceSlug` and `--space-slug` isn't passed, the command will error.
+
+`gobi global` commands target the public global feed and have no space requirement and no `.gobi` requirement. `gobi global create-post` is symmetric with `gobi space create-post`: a vault is **optional** — pass `--vault-slug <slug>` (or rely on `.gobi`'s `vaultSlug` when using `--auto-attachments`) to attribute the post; with neither flag the post is created without an `authorVaultSlug`.
 
 ## Important: JSON Mode
 
@@ -87,11 +105,11 @@ gobi --json space list-posts
 - `gobi global feed` — List the public global feed (posts and replies, newest first).
 - `gobi global list-posts` — List personal posts. `--mine` for your own; `--vault-slug <slug>` to filter by author vault.
 - `gobi global get-post <postId>` — Get a personal post with its ancestors and replies.
-- `gobi global create-post` — Create a personal post. `--vault-slug` and `--auto-attachments` work the same as on `space create-post`.
-- `gobi global edit-post <postId>` — Edit a personal post you authored. `--vault-slug ""` detaches the vault.
+- `gobi global create-post` — Create a personal post. `--vault-slug` and `--auto-attachments` work the same as on `space create-post`. Both are optional: with neither, the post is created without an `authorVaultSlug` (vault-less personal post).
+- `gobi global edit-post <postId>` — Edit a personal post you authored. `--vault-slug ""` detaches the vault; `--auto-attachments` uploads wiki-links before saving.
 - `gobi global delete-post <postId>` — Delete a personal post you authored.
 - `gobi global create-reply <postId>` — Reply to a personal post.
-- `gobi global edit-reply <replyId>` — Edit a reply you authored.
+- `gobi global edit-reply <replyId>` — Edit a reply you authored. Accepts `--auto-attachments` and `--vault-slug` for attachment uploads (mirrors `space edit-reply`).
 - `gobi global delete-reply <replyId>` — Delete a reply you authored.
 
 ## Confirm before mutating

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

@@ -9,13 +9,13 @@ Options:
   -h, --help                       display help for command
 
 Commands:
-  feed [options]                   List the global public feed (posts and replies, newest first).
+  feed [options]                   List the unified feed (posts and replies, newest first) in the global public feed.
   list-posts [options]             List posts in the global feed (paginated). Pass --mine to limit to your own posts.
   get-post [options] <postId>      Get a global post with its ancestors and replies (paginated).
-  create-post [options]            Create a post in the global feed (publishes from your vault).
+  create-post [options]            Create a post in the global feed. --vault-slug attributes it to a vault you own; defaults to your primary vault.
   edit-post [options] <postId>     Edit a post you authored in the global feed.
   delete-post <postId>             Delete a post you authored in the global feed.
-  create-reply [options] <postId>  Reply to a post in the global feed.
+  create-reply [options] <postId>  Create a reply to a post in the global feed.
   edit-reply [options] <replyId>   Edit a reply you authored in the global feed.
   delete-reply <replyId>           Delete a reply you authored in the global feed.
   help [command]                   display help for command
@@ -26,7 +26,7 @@ Commands:
 ```
 Usage: gobi global feed [options]
 
-List the global public feed (posts and replies, newest first).
+List the unified feed (posts and replies, newest first) in the global public feed.
 
 Options:
   --limit <number>   Items per page (default: "20")
@@ -58,7 +58,7 @@ Usage: gobi global get-post [options] <postId>
 Get a global post with its ancestors and replies (paginated).
 
 Options:
-  --limit <number>   Replies per page (default: "20")
+  --limit <number>   Items per page (default: "20")
   --cursor <string>  Pagination cursor from previous response
   --full             Show full reply content without truncation
   -h, --help         display help for command
@@ -69,14 +69,14 @@ Options:
 ```
 Usage: gobi global create-post [options]
 
-Create a post in the global feed (publishes from your vault).
+Create a post in the global feed. --vault-slug attributes it to a vault you own; defaults to your primary vault.
 
 Options:
   --title <title>           Title of the post
   --content <content>       Post content (markdown supported, use "-" for stdin)
   --rich-text <richText>    Rich-text JSON array (mutually exclusive with --content)
-  --vault-slug <vaultSlug>  Author vault slug (overrides .gobi/settings.yaml)
-  --auto-attachments        Upload wiki-linked [[files]] to webdrive before posting
+  --vault-slug <vaultSlug>  Attribute the post to this vault (sets authorVaultSlug). Defaults to your primary vault.
+  --auto-attachments        Upload wiki-linked [[files]] to webdrive before posting (also sets authorVaultSlug to that vault)
   -h, --help                display help for command
 ```
 
@@ -91,7 +91,8 @@ Options:
   --title <title>           New title
   --content <content>       New content (markdown supported, use "-" for stdin)
   --rich-text <richText>    Rich-text JSON array (mutually exclusive with --content)
-  --vault-slug <vaultSlug>  Attribute the post to this vault (sets authorVaultId). Pass an empty string to detach.
+  --vault-slug <vaultSlug>  Attribute the post to this vault (sets authorVaultSlug).
+  --auto-attachments        Upload wiki-linked [[files]] to webdrive before editing (uses --vault-slug or .gobi vault)
   -h, --help                display help for command
 ```
 
@@ -111,12 +112,14 @@ Options:
 ```
 Usage: gobi global create-reply [options] <postId>
 
-Reply to a post in the global feed.
+Create a reply to a post in the global feed.
 
 Options:
-  --content <content>     Reply content (markdown supported, use "-" for stdin)
-  --rich-text <richText>  Rich-text JSON array (mutually exclusive with --content)
-  -h, --help              display help for command
+  --content <content>       Reply content (markdown supported, use "-" for stdin)
+  --rich-text <richText>    Rich-text JSON array (mutually exclusive with --content)
+  --vault-slug <vaultSlug>  Attribute the reply to this vault (sets authorVaultSlug). Also used as upload destination for --auto-attachments.
+  --auto-attachments        Upload wiki-linked [[files]] to webdrive before posting (also attributes the reply to that vault)
+  -h, --help                display help for command
 ```
 
 ## edit-reply
@@ -127,8 +130,11 @@ Usage: gobi global edit-reply [options] <replyId>
 Edit a reply you authored in the global feed.
 
 Options:
-  --content <content>  New reply content (markdown supported, use "-" for stdin)
-  -h, --help           display help for command
+  --content <content>       New reply content (markdown supported, use "-" for stdin)
+  --rich-text <richText>    Rich-text JSON array (mutually exclusive with --content)
+  --vault-slug <vaultSlug>  Attribute the reply to this vault (sets authorVaultSlug). Also used as upload destination for --auto-attachments.
+  --auto-attachments        Upload wiki-linked [[files]] to webdrive before editing (also attributes the reply to that vault)
+  -h, --help                display help for command
 ```
 
 ## delete-reply

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

@@ -6,12 +6,12 @@ Usage: gobi space [options] [command]
 Space commands (posts, replies). Space and member admin is web-UI only.
 
 Options:
-  --space-slug <slug>                     Space slug (overrides .gobi/settings.yaml)
+  --space-slug <spaceSlug>                Space slug (overrides .gobi/settings.yaml)
   -h, --help                              display help for command
 
 Commands:
   list                                    List spaces you are a member of.
-  get [spaceSlug]                         Get details for a space. Pass a slug or omit to use the current space (from .gobi/settings.yaml or --space-slug).
+  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).
@@ -19,11 +19,11 @@ Commands:
   get-post [options] <postId>             Get a post with its ancestors and replies (paginated).
   list-posts [options]                    List posts in a space (paginated).
   create-post [options]                   Create a post in a space.
-  edit-post [options] <postId>            Edit a post. You must be the author.
-  delete-post <postId>                    Delete a post. You must be the author.
+  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 must be the author.
-  delete-reply <replyId>                  Delete a reply. You must be the author.
+  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
 ```
 
@@ -35,7 +35,8 @@ Usage: gobi space 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).
 
 Options:
-  -h, --help  display help for command
+  --space-slug <spaceSlug>  Space slug (overrides .gobi/settings.yaml)
+  -h, --help                display help for command
 ```
 
 ## list-topics
@@ -46,8 +47,9 @@ Usage: gobi space list-topics [options]
 List topics in a space, ordered by most recent content linkage.
 
 Options:
-  --limit <number>  Max topics to return (0 = all) (default: "50")
-  -h, --help        display help for command
+  --limit <number>          Items per page (default: "20")
+  --space-slug <spaceSlug>  Space slug (overrides .gobi/settings.yaml)
+  -h, --help                display help for command
 ```
 
 ## list-topic-posts
@@ -58,9 +60,10 @@ Usage: gobi space list-topic-posts [options] <topicSlug>
 List posts tagged with a topic in a space (cursor-paginated).
 
 Options:
-  --limit <number>   Items per page (default: "20")
-  --cursor <string>  Pagination cursor from previous response
-  -h, --help         display help for command
+  --limit <number>          Items per page (default: "20")
+  --cursor <string>         Pagination cursor from previous response
+  --space-slug <spaceSlug>  Space slug (overrides .gobi/settings.yaml)
+  -h, --help                display help for command
 ```
 
 ## feed
@@ -71,9 +74,10 @@ Usage: gobi space feed [options]
 List the unified feed (posts and replies, newest first) in a space.
 
 Options:
-  --limit <number>   Items per page (default: "20")
-  --cursor <string>  Pagination cursor from previous response
-  -h, --help         display help for command
+  --limit <number>          Items per page (default: "20")
+  --cursor <string>         Pagination cursor from previous response
+  --space-slug <spaceSlug>  Space slug (overrides .gobi/settings.yaml)
+  -h, --help                display help for command
 ```
 
 ## get-post
@@ -84,9 +88,11 @@ Usage: gobi space get-post [options] <postId>
 Get a post with its ancestors and replies (paginated).
 
 Options:
-  --limit <number>   Replies per page (default: "20")
-  --cursor <string>  Pagination cursor from previous response
-  -h, --help         display help for command
+  --limit <number>          Items per page (default: "20")
+  --cursor <string>         Pagination cursor from previous response
+  --full                    Show full reply content without truncation
+  --space-slug <spaceSlug>  Space slug (overrides .gobi/settings.yaml)
+  -h, --help                display help for command
 ```
 
 ## list-posts
@@ -97,9 +103,10 @@ Usage: gobi space list-posts [options]
 List posts in a space (paginated).
 
 Options:
-  --limit <number>   Items per page (default: "20")
-  --cursor <string>  Pagination cursor from previous response
-  -h, --help         display help for command
+  --limit <number>          Items per page (default: "20")
+  --cursor <string>         Pagination cursor from previous response
+  --space-slug <spaceSlug>  Space slug (overrides .gobi/settings.yaml)
+  -h, --help                display help for command
 ```
 
 ## create-post
@@ -111,9 +118,11 @@ Create a post in a space.
 
 Options:
   --title <title>           Title of the post
-  --content <content>       Post content (markdown supported)
+  --content <content>       Post content (markdown supported, use "-" for stdin)
+  --rich-text <richText>    Rich-text JSON array (mutually exclusive with --content)
   --auto-attachments        Upload wiki-linked [[files]] to webdrive before posting (also attributes the post to that vault)
   --vault-slug <vaultSlug>  Attribute the post to this vault (sets authorVaultId). Also used as upload destination for --auto-attachments.
+  --space-slug <spaceSlug>  Space slug (overrides .gobi/settings.yaml)
   -h, --help                display help for command
 ```
 
@@ -122,13 +131,15 @@ Options:
 ```
 Usage: gobi space edit-post [options] <postId>
 
-Edit a post. You must be the author.
+Edit a post you authored in a space.
 
 Options:
   --title <title>           New title for the post
-  --content <content>       New content for the post (markdown supported)
+  --content <content>       New content for the post (markdown supported, use "-" for stdin)
+  --rich-text <richText>    Rich-text JSON array (mutually exclusive with --content)
   --auto-attachments        Upload wiki-linked [[files]] to webdrive before editing (also attributes the post to that vault)
-  --vault-slug <vaultSlug>  Attribute the post to this vault (sets authorVaultId). Also used as upload destination for --auto-attachments. Pass an empty string to detach.
+  --vault-slug <vaultSlug>  Attribute the post to this vault (sets authorVaultId). Also used as upload destination for --auto-attachments.
+  --space-slug <spaceSlug>  Space slug (overrides .gobi/settings.yaml)
   -h, --help                display help for command
 ```
 
@@ -137,10 +148,11 @@ Options:
 ```
 Usage: gobi space delete-post [options] <postId>
 
-Delete a post. You must be the author.
+Delete a post you authored in a space.
 
 Options:
-  -h, --help  display help for command
+  --space-slug <spaceSlug>  Space slug (overrides .gobi/settings.yaml)
+  -h, --help                display help for command
 ```
 
 ## create-reply
@@ -151,8 +163,12 @@ Usage: gobi space create-reply [options] <postId>
 Create a reply to a post in a space.
 
 Options:
-  --content <content>  Reply content (markdown supported)
-  -h, --help           display help for command
+  --content <content>       Reply content (markdown supported, use "-" for stdin)
+  --rich-text <richText>    Rich-text JSON array (mutually exclusive with --content)
+  --auto-attachments        Upload wiki-linked [[files]] to webdrive before posting (also attributes the reply to that vault)
+  --vault-slug <vaultSlug>  Attribute the reply to this vault (sets authorVaultSlug). Also used as upload destination for --auto-attachments.
+  --space-slug <spaceSlug>  Space slug (overrides .gobi/settings.yaml)
+  -h, --help                display help for command
 ```
 
 ## edit-reply
@@ -160,12 +176,14 @@ Options:
 ```
 Usage: gobi space edit-reply [options] <replyId>
 
-Edit a reply. You must be the author.
+Edit a reply you authored in a space.
 
 Options:
-  --content <content>       New content for the reply (markdown supported)
-  --auto-attachments        Upload wiki-linked [[files]] to webdrive before editing
-  --vault-slug <vaultSlug>  Vault slug for attachment uploads (overrides .gobi/settings.yaml)
+  --content <content>       New content for the reply (markdown supported, use "-" for stdin)
+  --rich-text <richText>    Rich-text JSON array (mutually exclusive with --content)
+  --auto-attachments        Upload wiki-linked [[files]] to webdrive before editing (also attributes the reply to that vault)
+  --vault-slug <vaultSlug>  Attribute the reply to this vault (sets authorVaultSlug). Also used as upload destination for --auto-attachments.
+  --space-slug <spaceSlug>  Space slug (overrides .gobi/settings.yaml)
   -h, --help                display help for command
 ```
 
@@ -174,8 +192,9 @@ Options:
 ```
 Usage: gobi space delete-reply [options] <replyId>
 
-Delete a reply. You must be the author.
+Delete a reply you authored in a space.
 
 Options:
-  -h, --help  display help for command
+  --space-slug <spaceSlug>  Space slug (overrides .gobi/settings.yaml)
+  -h, --help                display help for command
 ```

package/skills/gobi-vault/SKILL.md

@@ -1,21 +1,26 @@
 ---
 name: gobi-vault
 description: >-
-  Gobi vault commands for publishing your vault profile and syncing files:
-  publish/unpublish PUBLISH.md and run the local-to-webdrive sync. Use when
-  the user wants to publish their vault, unpublish it, or push/pull files.
+  Gobi vault commands: initialize the vault for the current directory, list
+  vaults you own, publish/unpublish PUBLISH.md, and run the local-to-webdrive
+  sync. Use when the user wants to set up a vault, publish/unpublish it, or
+  push/pull files.
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "2.0.0"
+  version: "2.0.6"
 ---
 
 # gobi-vault
 
-Gobi vault commands for publishing your vault profile and syncing files (v2.0.0).
+Gobi vault commands for publishing your vault profile and syncing files (v2.0.6).
 
 Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
 
+## Prerequisites
+
+Every `gobi vault …` command **except `vault init`** requires a vault to be configured in the current directory's `.gobi/settings.yaml` (specifically a `vaultSlug` entry). There is no per-call `--vault-slug` override on these commands — the vault is always resolved from `.gobi`. If `.gobi/settings.yaml` is missing or has no `vaultSlug`, run `gobi vault init` first.
+
 ## Gobi Vault
 
 A "vault" is your file-backed knowledge home. Public vaults are accessible at `https://gobispace.com/@{vaultSlug}`. Each vault has a profile written to `PUBLISH.md` at its root; publishing pushes that file to webdrive, which then updates vault metadata and the public profile.
@@ -30,6 +35,8 @@ gobi --json vault publish
 
 ## Available Commands
 
+- `gobi vault init` — Interactive: select an existing vault or create a new one. Writes `vaultSlug` to `.gobi/settings.yaml` in the current directory and seeds `PUBLISH.md`. Requires the user to be logged in (`gobi auth login`).
+- `gobi vault list` — List vaults you own. The primary vault is marked.
 - `gobi vault publish` — Upload `PUBLISH.md` to the vault root on webdrive. Triggers post-processing (vault profile sync, metadata update, Discord notification).
 - `gobi vault unpublish` — Delete `PUBLISH.md` from the vault on webdrive.
 - `gobi vault sync` — Sync local vault files with Gobi Webdrive. Supports `--upload-only`, `--download-only`, `--conflict <ask|server|client|skip>`, `--dry-run`, `--full`, `--path <p>`, `--plan-file`, `--execute`.

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

@@ -3,18 +3,42 @@
 ```
 Usage: gobi vault [options] [command]
 
-Vault commands (publish/unpublish profile, sync files).
+Vault commands (init, list, publish/unpublish profile, sync files).
 
 Options:
   -h, --help      display help for command
 
 Commands:
+  init            Select or create the vault for the current directory. Writes .gobi/settings.yaml and seeds PUBLISH.md.
+  list            List vaults you own.
   publish         Upload PUBLISH.md to the vault root on webdrive. Triggers post-processing (vault sync, metadata update, Discord notification).
   unpublish       Delete PUBLISH.md from the vault on webdrive.
   sync [options]  Sync local vault files with Gobi Webdrive.
   help [command]  display help for command
 ```
 
+## init
+
+```
+Usage: gobi vault init [options]
+
+Select or create the vault for the current directory. Writes .gobi/settings.yaml and seeds PUBLISH.md.
+
+Options:
+  -h, --help  display help for command
+```
+
+## list
+
+```
+Usage: gobi vault list [options]
+
+List vaults you own.
+
+Options:
+  -h, --help  display help for command
+```
+
 ## publish
 
 ```

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

@@ -1,10 +0,0 @@
-# gobi init
-
-```
-Usage: gobi init [options]
-
-Log in (if needed) and select or create the vault for the current directory.
-
-Options:
-  -h, --help  display help for command
-```