@gobi-ai/cli 1.3.8 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -8,7 +8,7 @@
8
8
  "plugins": [
9
9
  {
10
10
  "name": "gobi",
11
- "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.",
11
+ "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.",
12
12
  "version": "1.3.8",
13
13
  "author": {
14
14
  "name": "gobi-ai"
@@ -18,9 +18,8 @@
18
18
  "skills": [
19
19
  "./skills/gobi-core",
20
20
  "./skills/gobi-space",
21
- "./skills/gobi-brain",
22
- "./skills/gobi-feed",
23
- "./skills/gobi-notes",
21
+ "./skills/gobi-vault",
22
+ "./skills/gobi-saved",
24
23
  "./skills/gobi-draft",
25
24
  "./skills/gobi-media",
26
25
  "./skills/gobi-sense",
@@ -9,9 +9,8 @@
9
9
  "skills": [
10
10
  "./skills/gobi-core",
11
11
  "./skills/gobi-space",
12
- "./skills/gobi-brain",
13
- "./skills/gobi-feed",
14
- "./skills/gobi-notes",
12
+ "./skills/gobi-vault",
13
+ "./skills/gobi-saved",
15
14
  "./skills/gobi-draft",
16
15
  "./skills/gobi-media",
17
16
  "./skills/gobi-sense",
package/README.md CHANGED
@@ -34,17 +34,21 @@ npm link
34
34
  ## Quick start
35
35
 
36
36
  ```sh
37
- # Initialize — logs in and sets up your vault
37
+ # Initialize — logs in and sets up your vault (creates PUBLISH.md)
38
38
  gobi init
39
39
 
40
40
  # Select a space
41
41
  gobi space warp
42
42
 
43
- # Search brains across your spaces
44
- gobi brain search --query "machine learning"
43
+ # Publish your vault profile (after editing PUBLISH.md frontmatter)
44
+ gobi vault publish
45
45
 
46
- # Ask a brain a question
47
- gobi brain ask --vault-slug my-vault --question "What is RAG?"
46
+ # Sync local files with the webdrive
47
+ gobi vault sync
48
+
49
+ # Browse the global feed and create a post
50
+ gobi global feed
51
+ gobi global create-post --title "Hello" --content "Trying gobi"
48
52
  ```
49
53
 
50
54
  ## Commands
@@ -61,22 +65,34 @@ gobi brain ask --vault-slug my-vault --question "What is RAG?"
61
65
 
62
66
  | Command | Description |
63
67
  |---------|-------------|
64
- | `gobi init` | Log in (if needed) and select or create a vault |
68
+ | `gobi init` | Log in (if needed) and select or create a vault. Creates `PUBLISH.md` if missing. |
65
69
  | `gobi space list` | List spaces you are a member of |
66
70
  | `gobi space warp [spaceSlug]` | Select the active space (interactive if slug omitted) |
67
71
 
68
- ### Brains
72
+ ### Vault
69
73
 
70
74
  | Command | Description |
71
75
  |---------|-------------|
72
- | `gobi brain search --query <q>` | Search public brains by text and semantic similarity |
73
- | `gobi brain ask --vault-slug <slug> --question <q>` | Ask a brain a question (creates a 1:1 session) |
74
- | `gobi brain publish` | Upload `BRAIN.md` to your vault |
75
- | `gobi brain unpublish` | Remove `BRAIN.md` from your vault |
76
+ | `gobi vault publish` | Upload `PUBLISH.md` to your vault. Triggers profile/metadata refresh. |
77
+ | `gobi vault unpublish` | Remove `PUBLISH.md` from your vault. |
78
+ | `gobi vault sync` | Sync local vault files with Gobi Webdrive. |
79
+
80
+ Public vaults are accessible at `https://gobispace.com/@{vaultSlug}`.
76
81
 
77
- Public brains are accessible at `https://gobispace.com/@{vaultSlug}`.
82
+ `vault sync` options:
78
83
 
79
- `brain ask` also accepts `--rich-text <json>` (mutually exclusive with `--question`) and `--mode <auto|manual>`.
84
+ | Option | Description |
85
+ |--------|-------------|
86
+ | `--upload-only` | Only upload local changes to server |
87
+ | `--download-only` | Only download server changes to local |
88
+ | `--conflict <strategy>` | Conflict resolution: `ask` (default), `server`, `client`, `skip` |
89
+ | `--dir <path>` | Local vault directory (default: current directory) |
90
+ | `--dry-run` | Preview changes without making them |
91
+ | `--full` | Full sync: ignore cursor and hash cache, re-check every file |
92
+ | `--path <path>` | Restrict sync to specific file/folder (repeatable) |
93
+ | `--plan-file <path>` | Write dry-run plan to file, or read plan to execute |
94
+ | `--execute` | Execute a previously written plan file (requires `--plan-file`) |
95
+ | `--conflict-choices <json>` | Per-file conflict resolutions as JSON (use with `--execute`) |
80
96
 
81
97
  ### Spaces
82
98
 
@@ -85,52 +101,33 @@ Public brains are accessible at `https://gobispace.com/@{vaultSlug}`.
85
101
  | Command | Description |
86
102
  |---------|-------------|
87
103
  | `gobi space get [spaceSlug]` | Show space details (uses current space if slug omitted) |
88
- | `gobi space messages` | Unified message feed (threads + replies, newest first) |
89
- | `gobi space ancestors <threadId>` | Walk a thread/reply's lineage from root immediate parent |
90
-
91
- ### Feed
92
-
93
- | Command | Description |
94
- |---------|-------------|
95
- | `gobi feed list` | List recent brain updates from the global public feed |
96
- | `gobi feed get <updateId>` | Get a feed brain update and its replies |
97
- | `gobi feed post-reply <updateId> --content <c>` | Post a reply to a brain update in the feed |
98
- | `gobi feed edit-reply <replyId> --content <c>` | Edit a reply you authored |
99
- | `gobi feed delete-reply <replyId>` | Delete a reply you authored |
100
-
101
- `feed list` and `feed get` accept `--limit`/`--cursor` for pagination.
102
-
103
- ### Threads
104
-
105
- > **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).
106
-
107
- | Command | Description |
108
- |---------|-------------|
109
- | `gobi space list-threads` | List threads in the current space |
110
- | `gobi space get-thread <id>` | Get a thread and its replies |
111
- | `gobi space create-thread --title <t> --content <c>` | Create a thread |
112
- | `gobi space edit-thread <id> [--title <t>] [--content <c>]` | Edit a thread (at least one required) |
113
- | `gobi space delete-thread <id>` | Delete a thread |
114
-
115
- ### Replies
116
-
117
- | Command | Description |
118
- |---------|-------------|
119
- | `gobi space create-reply <threadId> --content <c>` | Reply to a thread |
104
+ | `gobi space feed` | Unified feed (posts + replies, newest first) in the space |
105
+ | `gobi space list-topics` | List topics in the space, ordered by most recent linkage |
106
+ | `gobi space list-topic-posts <topicSlug>` | List posts tagged with a topic |
107
+ | `gobi space list-posts` | List posts in the space |
108
+ | `gobi space get-post <postId>` | Get a post with its ancestors and replies |
109
+ | `gobi space create-post --title <t> --content <c>` | Create a post |
110
+ | `gobi space edit-post <postId> [--title <t>] [--content <c>]` | Edit a post (at least one required) |
111
+ | `gobi space delete-post <postId>` | Delete a post |
112
+ | `gobi space create-reply <postId> --content <c>` | Reply to a post |
120
113
  | `gobi space edit-reply <replyId> --content <c>` | Edit a reply |
121
114
  | `gobi space delete-reply <replyId>` | Delete a reply |
122
115
 
123
- ### Global thread space
116
+ ### Global feed
124
117
 
125
- The global thread space is a slugless message feed visible across all spaces.
118
+ The global feed is the public, slugless feed of vault-authored posts visible across all spaces.
126
119
 
127
120
  | Command | Description |
128
121
  |---------|-------------|
129
- | `gobi global messages` | List the global unified message feed (newest first) |
130
- | `gobi global get-thread <id>` | Get a global thread and its direct replies |
131
- | `gobi global ancestors <id>` | Walk a global thread/reply's lineage |
132
- | `gobi global create-thread [--title <t>] (--content <c> \| --rich-text <json>)` | Create a thread in the global space |
133
- | `gobi global reply <threadId> (--content <c> \| --rich-text <json>)` | Reply to a global thread |
122
+ | `gobi global feed` | List the global public feed (posts + replies, newest first) |
123
+ | `gobi global list-posts [--mine] [--vault-slug <slug>]` | List posts in the global feed |
124
+ | `gobi global get-post <postId>` | Get a global post with its ancestors and replies |
125
+ | `gobi global create-post [--title <t>] (--content <c> \| --rich-text <json>)` | Create a post in the global feed |
126
+ | `gobi global edit-post <postId> [--title <t>] [--content <c>]` | Edit a post you authored |
127
+ | `gobi global delete-post <postId>` | Delete a post you authored |
128
+ | `gobi global create-reply <postId> (--content <c> \| --rich-text <json>)` | Reply to a global post |
129
+ | `gobi global edit-reply <replyId> --content <c>` | Edit a reply you authored |
130
+ | `gobi global delete-reply <replyId>` | Delete a reply you authored |
134
131
 
135
132
  ### Sessions
136
133
 
@@ -151,18 +148,30 @@ The global thread space is a slugless message feed visible across all spaces.
151
148
 
152
149
  Times are ISO 8601 UTC (e.g. `2026-03-20T00:00:00Z`).
153
150
 
154
- ### Notes
151
+ ### Saved
152
+
153
+ `gobi saved` is the user's personal saved-knowledge collection — notes you author and posts you bookmark.
154
+
155
+ #### Saved notes
155
156
 
156
157
  | Command | Description |
157
158
  |---------|-------------|
158
- | `gobi notes list [--date YYYY-MM-DD]` | List your notes (recent via cursor, or all for a day) |
159
- | `gobi notes get <id>` | Get a single note |
160
- | `gobi notes create --content <c>` | Create a note (use `-` to read content from stdin) |
161
- | `gobi notes edit <id> [--content <c>] [--agent-id <id>]` | Edit a note (at least one required; `--agent-id null` clears the link) |
162
- | `gobi notes delete <id>` | Delete a note you authored |
159
+ | `gobi saved note list [--date YYYY-MM-DD]` | List your notes (recent via cursor, or all for a day) |
160
+ | `gobi saved note get <id>` | Get a single note |
161
+ | `gobi saved note create --content <c>` | Create a note (use `-` to read content from stdin) |
162
+ | `gobi saved note edit <id> [--content <c>] [--agent-id <id>]` | Edit a note (at least one required; `--agent-id null` clears the link) |
163
+ | `gobi saved note delete <id>` | Delete a note you authored |
163
164
 
164
- `notes list` and `notes create` accept `--timezone <iana>` (default: system timezone) for day boundaries.
165
- `notes list` also accepts `--limit`/`--cursor` for pagination.
165
+ `saved note list` and `saved note create` accept `--timezone <iana>` (default: system timezone).
166
+
167
+ #### Saved posts
168
+
169
+ | Command | Description |
170
+ |---------|-------------|
171
+ | `gobi saved post list [--type all\|article\|space-post]` | List posts you've saved |
172
+ | `gobi saved post get <postId>` | Get a saved post snapshot |
173
+ | `gobi saved post create --source <id>` | Save a post or reply by id |
174
+ | `gobi saved post delete <postId>` | Remove a post from your saved collection |
166
175
 
167
176
  ### Drafts
168
177
 
@@ -178,32 +187,13 @@ Drafts are authored by your agent during chat (or by external agents using `gobi
178
187
  | `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. |
179
188
  | `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 |
180
189
 
181
- ### Sync
182
-
183
- | Command | Description |
184
- |---------|-------------|
185
- | `gobi sync` | Sync local vault files with Gobi Webdrive |
186
-
187
- | Option | Description |
188
- |--------|-------------|
189
- | `--upload-only` | Only upload local changes to server |
190
- | `--download-only` | Only download server changes to local |
191
- | `--conflict <strategy>` | Conflict resolution: `ask` (default), `server`, `client`, `skip` |
192
- | `--dir <path>` | Local vault directory (default: current directory) |
193
- | `--dry-run` | Preview changes without making them |
194
- | `--full` | Full sync: ignore cursor and hash cache, re-check every file |
195
- | `--path <path>` | Restrict sync to specific file/folder (repeatable) |
196
- | `--plan-file <path>` | Write dry-run plan to file, or read plan to execute |
197
- | `--execute` | Execute a previously written plan file (requires `--plan-file`) |
198
- | `--conflict-choices <json>` | Per-file conflict resolutions as JSON (use with `--execute`) |
199
-
200
190
  ### Global options
201
191
 
202
192
  | Option | Scope | Description |
203
193
  |--------|-------|-------------|
204
194
  | `--json` | All commands | Output results as JSON |
205
195
  | `--space-slug <slug>` | `space` commands | Override the default space (from `.gobi/settings.yaml`) |
206
- | `--vault-slug <slug>` | Per-command | Override the default vault; available on `space create-thread`, `space edit-thread`, `space edit-reply` |
196
+ | `--vault-slug <slug>` | Per-command | Override the default vault; available on post/reply commands that upload attachments and on `global create-post` |
207
197
 
208
198
  ## Configuration
209
199
 
@@ -220,6 +210,7 @@ Drafts are authored by your agent during chat (or by external agents using `gobi
220
210
  |------|-------------|
221
211
  | `~/.gobi/credentials.json` | Stored authentication tokens |
222
212
  | `.gobi/settings.yaml` | Per-project vault and space configuration |
213
+ | `PUBLISH.md` | Vault profile document with YAML frontmatter, published via `gobi vault publish` |
223
214
 
224
215
  ## Development
225
216
 
@@ -1,20 +1,20 @@
1
1
  ---
2
2
  name: space-explore
3
- description: Explore what's happening in the active Gobi space — threads and learnings shared by others.
3
+ description: Explore what's happening in the active Gobi space — posts and learnings shared by others.
4
4
  argument-hint: "[topic or keyword]"
5
5
  ---
6
6
 
7
7
  Always use the globally installed `gobi` binary (not via npx or ts-node).
8
8
 
9
- Explore the active Gobi space to surface discussions, topics, and learnings from others:
9
+ Explore the active Gobi space to surface posts, topics, and learnings from others:
10
10
 
11
11
  1. Run these three commands in parallel:
12
- - `gobi --json space list-threads` — recent discussions in the space
13
- - `gobi --json space list-topics` — available topics across the platform
14
- - `gobi --json feed list` — learnings and brain updates shared by members across the platform
15
- 2. Display results in a readable summary, grouped by type (Topics / Discussions / Learnings).
16
- 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.
12
+ - `gobi --json space list-posts` — recent posts in the space
13
+ - `gobi --json space list-topics` — available topics in the space
14
+ - `gobi --json global feed` — recent posts and replies shared by members across the platform
15
+ 2. Display results in a readable summary, grouped by type (Topics / Space posts / Global feed).
16
+ 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.
17
17
  4. Ask the user if they'd like to read anything in full:
18
- - For a topic: run `gobi space list-topic-threads <topicSlug>` and show the threads.
19
- - For a thread: run `gobi space get-thread <threadId>` and show it with replies.
20
- - For a feed brain update: run `gobi feed get <updateId>` to show the update with its replies.
18
+ - For a topic: run `gobi space list-topic-posts <topicSlug>` and show the posts.
19
+ - For a space post: run `gobi space get-post <postId>` and show it with ancestors and replies.
20
+ - For a global feed post: run `gobi global get-post <postId>` to show it with ancestors and replies.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: space-share
3
- description: Summarize recent learnings from this session and draft a brain update to share to the active Gobi space.
3
+ description: Summarize recent learnings from this session and draft a vault post to share to the global feed.
4
4
  argument-hint: "[context]"
5
5
  ---
6
6
 
@@ -8,15 +8,15 @@ Always use the globally installed `gobi` binary (not via npx or ts-node).
8
8
 
9
9
  ## Pre-flight check
10
10
 
11
- First, verify the user is warped into a space:
11
+ First, verify the user is set up:
12
12
 
13
13
  ```bash
14
14
  gobi --json auth status
15
15
  ```
16
16
 
17
- 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.
17
+ 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.
18
18
 
19
- ## Draft a brain update
19
+ ## Draft a vault post
20
20
 
21
21
  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").
22
22
 
@@ -34,12 +34,18 @@ Focus on:
34
34
 
35
35
  ## Present to the user
36
36
 
37
- Format the draft as a short brain update (2–5 bullet points max). Show it to the user and ask for confirmation before posting.
37
+ Format the draft as a short post (2–5 bullet points max). Show it to the user and ask for confirmation before posting.
38
38
 
39
- Once confirmed, post it:
39
+ Once confirmed, post it to the global feed:
40
40
 
41
41
  ```bash
42
- gobi brain post-update --title "<short title>" --content "<confirmed content>"
42
+ gobi global create-post --title "<short title>" --content "<confirmed content>"
43
+ ```
44
+
45
+ Or to the active space:
46
+
47
+ ```bash
48
+ gobi space create-post --title "<short title>" --content "<confirmed content>"
43
49
  ```
44
50
 
45
51
  Confirm success and show the user the result.