@gobi-ai/cli 2.0.21 → 2.0.23
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.
- package/.claude-plugin/marketplace.json +3 -4
- package/.claude-plugin/plugin.json +1 -2
- package/LICENSE +1 -1
- package/README.md +37 -47
- package/dist/commands/global.js +2 -2
- package/dist/commands/media.js +3 -3
- package/dist/commands/personal.js +1 -1
- package/dist/commands/space.js +2 -2
- package/dist/commands/sync.js +65 -15
- package/dist/commands/vault.js +1 -1
- package/dist/main.js +0 -4
- package/package.json +1 -1
- package/skills/gobi-core/SKILL.md +14 -18
- package/skills/gobi-core/references/space.md +0 -12
- package/skills/gobi-draft/SKILL.md +5 -6
- package/skills/gobi-homepage/SKILL.md +5 -1
- package/skills/gobi-media/SKILL.md +3 -3
- package/skills/gobi-sense/SKILL.md +2 -2
- package/skills/gobi-space/SKILL.md +35 -16
- package/skills/gobi-space/references/global.md +5 -3
- package/skills/gobi-space/references/personal.md +154 -0
- package/skills/gobi-space/references/space.md +2 -4
- package/skills/gobi-vault/SKILL.md +12 -7
- package/skills/gobi-vault/references/vault.md +2 -2
- package/dist/commands/saved.js +0 -261
- package/dist/commands/sessions.js +0 -124
- package/skills/gobi-core/references/session.md +0 -55
- package/skills/gobi-saved/SKILL.md +0 -70
- package/skills/gobi-saved/references/saved.md +0 -136
|
@@ -10,12 +10,12 @@ description: >-
|
|
|
10
10
|
allowed-tools: Bash(gobi:*)
|
|
11
11
|
metadata:
|
|
12
12
|
author: gobi-ai
|
|
13
|
-
version: "2.0.
|
|
13
|
+
version: "2.0.23"
|
|
14
14
|
---
|
|
15
15
|
|
|
16
16
|
# gobi-draft
|
|
17
17
|
|
|
18
|
-
Gobi draft commands for managing agent-authored drafts (v2.0.
|
|
18
|
+
Gobi draft commands for managing agent-authored drafts (v2.0.23).
|
|
19
19
|
|
|
20
20
|
Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
|
|
21
21
|
|
|
@@ -77,16 +77,15 @@ When the user picks an action via `gobi draft action <id> <index>`, the response
|
|
|
77
77
|
|
|
78
78
|
## Linking a created post back to its draft
|
|
79
79
|
|
|
80
|
-
When the user picks an action like "Post to Global Feed" / "Post to <space>" / "Save
|
|
80
|
+
When the user picks an action like "Post to Global Feed" / "Post to <space>" / "Save to Personal Space" and your next turn creates the post, pass `--draft-id <draftId>` to the relevant create command. `--draft-id` is the **sole** source of `title` and `content` — the CLI fetches the draft and uses its title and content directly, so `--title` / `--content` / `--rich-text` are not allowed alongside it on `create-post`. If you want to change the wording, `gobi draft revise` first, then create.
|
|
81
81
|
|
|
82
|
-
- `gobi space create-post --draft-id` / `gobi global create-post --draft-id` — uses draft's title and content as the post's `title` and `content`. The draft's `vaultSlug` (when set) seeds `--vault-slug` if not given explicitly. `--auto-attachments`, `--space-slug`, and an explicit `--vault-slug` override remain allowed. Records `{ postId, spaceSlug? }` on `draft.metadata` for an "Open post" button.
|
|
83
|
-
- `gobi saved create-note --draft-id` — fetches the draft and folds it into the note as `# <title>\n\n<content>` (or just content when title is empty). Records `{ noteId }` on `draft.metadata` for an "Open note" button.
|
|
82
|
+
- `gobi space create-post --draft-id` / `gobi global create-post --draft-id` / `gobi personal create-post --draft-id` — uses draft's title and content as the post's `title` and `content`. The draft's `vaultSlug` (when set) seeds `--vault-slug` if not given explicitly. `--auto-attachments`, `--space-slug`, and an explicit `--vault-slug` override remain allowed. Records `{ postId, spaceSlug? }` on `draft.metadata` for an "Open post" button.
|
|
84
83
|
|
|
85
84
|
```bash
|
|
86
85
|
gobi --json global create-post --draft-id <draftId>
|
|
87
86
|
gobi --json space create-post --space-slug <slug> --draft-id <draftId>
|
|
87
|
+
gobi --json personal create-post --draft-id <draftId>
|
|
88
88
|
gobi --json global create-post --draft-id <draftId> --auto-attachments
|
|
89
|
-
gobi --json saved create-note --draft-id <draftId>
|
|
90
89
|
```
|
|
91
90
|
|
|
92
91
|
## Available Commands
|
|
@@ -4,6 +4,10 @@ description: >-
|
|
|
4
4
|
Developer reference for building Gobi Homepages — custom HTML pages hosted on
|
|
5
5
|
webdrive and served as a vault's public homepage at gobispace.com/@{vaultSlug}.
|
|
6
6
|
Use when a developer wants to build or modify a vault homepage.
|
|
7
|
+
allowed-tools: Bash(gobi:*)
|
|
8
|
+
metadata:
|
|
9
|
+
author: gobi-ai
|
|
10
|
+
version: "2.0.23"
|
|
7
11
|
---
|
|
8
12
|
|
|
9
13
|
# Gobi Homepage Developer Guide
|
|
@@ -307,7 +311,7 @@ Link back to the vault's public page with `?og=1` so the link preview uses the v
|
|
|
307
311
|
|
|
308
312
|
```html
|
|
309
313
|
<footer>
|
|
310
|
-
<a href="https://
|
|
314
|
+
<a href="https://gobispace.com/@${gobi.vault.vaultId}?og=1" target="_blank" rel="noopener">
|
|
311
315
|
POWERED BY GOBI
|
|
312
316
|
</a>
|
|
313
317
|
</footer>
|
|
@@ -10,12 +10,12 @@ description: >-
|
|
|
10
10
|
allowed-tools: Bash(gobi:*)
|
|
11
11
|
metadata:
|
|
12
12
|
author: gobi-ai
|
|
13
|
-
version: "2.0.
|
|
13
|
+
version: "2.0.23"
|
|
14
14
|
---
|
|
15
15
|
|
|
16
16
|
# gobi-media
|
|
17
17
|
|
|
18
|
-
Gobi media generation commands (v2.0.
|
|
18
|
+
Gobi media generation commands (v2.0.23).
|
|
19
19
|
|
|
20
20
|
Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
|
|
21
21
|
|
|
@@ -57,7 +57,7 @@ The `-o` flag implies `--wait` and downloads the image when done.
|
|
|
57
57
|
### Key rules
|
|
58
58
|
- Replace `<NAME>` with a descriptive slug — NEVER use example names like `sunset.png` literally.
|
|
59
59
|
- `--name` is **optional** — auto-derived from prompt if omitted.
|
|
60
|
-
- Do NOT use the `downloadUrl` from the response — it is
|
|
60
|
+
- Do NOT use the `downloadUrl` from the response — it is an internal backend path, not a public link. Always download with `-o` then either wiki-link (chat/vault), `--attach` (CLI-authored post/reply), or nothing (post-mention auto-post — the runtime attaches).
|
|
61
61
|
- `download-image` takes a **positional** jobId (NOT `--job-id`): `gobi media download-image <jobId>`
|
|
62
62
|
- The `jobId` (or `id`) field is what you pass to `download-image` / `get-image-status` — NOT `mediaId`.
|
|
63
63
|
|
|
@@ -7,12 +7,12 @@ description: >-
|
|
|
7
7
|
allowed-tools: Bash(gobi:*)
|
|
8
8
|
metadata:
|
|
9
9
|
author: gobi-ai
|
|
10
|
-
version: "2.0.
|
|
10
|
+
version: "2.0.23"
|
|
11
11
|
---
|
|
12
12
|
|
|
13
13
|
# gobi-sense
|
|
14
14
|
|
|
15
|
-
Gobi sense commands for activity and transcription data (v2.0.
|
|
15
|
+
Gobi sense commands for activity and transcription data (v2.0.23).
|
|
16
16
|
|
|
17
17
|
Requires gobi-cli installed and authenticated. See the **gobi-core** skill for setup.
|
|
18
18
|
|
|
@@ -1,32 +1,34 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: gobi-space
|
|
3
3
|
description: >-
|
|
4
|
-
Gobi space and
|
|
5
|
-
unified feed and topic feeds — in a community space
|
|
6
|
-
public global feed of personal posts (`gobi global`)
|
|
7
|
-
|
|
8
|
-
|
|
4
|
+
Gobi space, global, and personal-space commands: read and write posts and
|
|
5
|
+
replies, browse the unified feed and topic feeds — in a community space
|
|
6
|
+
(`gobi space`), in the public global feed of personal posts (`gobi global`),
|
|
7
|
+
or in your private personal-space feed visible only to you (`gobi personal`).
|
|
8
|
+
All three share the same `Post` data model; only the scope differs. Use when
|
|
9
|
+
the user wants to read or write posts and replies. Space and member admin is
|
|
9
10
|
web-UI only.
|
|
10
11
|
allowed-tools: Bash(gobi:*)
|
|
11
12
|
metadata:
|
|
12
13
|
author: gobi-ai
|
|
13
|
-
version: "2.0.
|
|
14
|
+
version: "2.0.23"
|
|
14
15
|
---
|
|
15
16
|
|
|
16
17
|
# gobi-space
|
|
17
18
|
|
|
18
|
-
Gobi space and
|
|
19
|
+
Gobi space, global, and personal-space posts (v2.0.23).
|
|
19
20
|
|
|
20
21
|
Requires gobi-cli installed and authenticated. See the **gobi-core** skill for setup.
|
|
21
22
|
|
|
22
|
-
##
|
|
23
|
+
## Three scopes, one data model
|
|
23
24
|
|
|
24
|
-
The same `Post` data type drives
|
|
25
|
+
The same `Post` data type drives all three surfaces — the difference is **scope**:
|
|
25
26
|
|
|
26
27
|
- **Space Post** — `gobi space …` — lives in a community space's feed.
|
|
27
|
-
- **Personal Post** — `gobi global …` —
|
|
28
|
+
- **Personal Post** — `gobi global …` — surfaces in the public global feed. When attributed via `--vault-slug` it also surfaces on that vault's profile; with no vault attribution it lives only on the global feed.
|
|
29
|
+
- **Personal-space Post** — `gobi personal …` — private posts and replies visible only to the author. Same shape as `gobi global`, scoped via `personalSpaceUserId` so they never surface on the public feed.
|
|
28
30
|
|
|
29
|
-
Anything you can do to a Space Post (reply, edit, delete, attribute to a vault) you can do to a Personal Post.
|
|
31
|
+
Anything you can do to a Space Post (reply, edit, delete, attribute to a vault) you can do to a Personal Post or a Personal-space Post.
|
|
30
32
|
|
|
31
33
|
- When the user wants to explore or catch up on what's happening in their space, invoke `/gobi:space-explore`.
|
|
32
34
|
- When the user wants to share or post learnings from the current session, invoke `/gobi:space-share`.
|
|
@@ -34,7 +36,7 @@ Anything you can do to a Space Post (reply, edit, delete, attribute to a vault)
|
|
|
34
36
|
|
|
35
37
|
## Authoring posts: title vs. content
|
|
36
38
|
|
|
37
|
-
`create-post` (and `edit-post`) on
|
|
39
|
+
`create-post` (and `edit-post`) on `gobi space`, `gobi global`, and `gobi personal` all 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`:
|
|
38
40
|
|
|
39
41
|
- Do **not** repeat the title as a heading (`# My title`) or as the first line of `--content`. The reader will see it twice.
|
|
40
42
|
- Start `--content` with the body itself.
|
|
@@ -45,15 +47,15 @@ The same applies to replies: a reply has only `--content` (no title), so do not
|
|
|
45
47
|
|
|
46
48
|
## Author vault attribution (`--vault-slug`)
|
|
47
49
|
|
|
48
|
-
|
|
50
|
+
`create-post` / `edit-post` across all three scopes (`gobi space`, `gobi global`, `gobi personal`) 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.
|
|
49
51
|
|
|
50
52
|
`--auto-attachments` resolves a vault for upload and **also** uses it as `authorVaultSlug` automatically — one flag, two effects.
|
|
51
53
|
|
|
52
|
-
> **Before using `--auto-attachments`, check that the target vault is published.** Run `gobi --json vault status` (or `gobi vault status --vault-slug <slug>`) and verify `isPublished: true`. Files uploaded to a non-public vault are stored on webdrive but are not reachable at `gobispace.com/@{vaultSlug}` — readers will see broken `[[wikilinks]]`. If the status reports unpublished, ask the user to run `gobi vault publish` first (
|
|
54
|
+
> **Before using `--auto-attachments`, check that the target vault is published.** Run `gobi --json vault status` (or `gobi vault status --vault-slug <slug>`) and verify `isPublished: true`. Files uploaded to a non-public vault are stored on webdrive but are not reachable at `gobispace.com/@{vaultSlug}` — readers will see broken `[[wikilinks]]`. If the status reports unpublished, ask the user to run `gobi vault publish` first (the server rejects the publish if `title` and `description` are missing from `PUBLISH.md` frontmatter). See the **gobi-vault** skill.
|
|
53
55
|
|
|
54
56
|
## Post media attachments (`--attach`)
|
|
55
57
|
|
|
56
|
-
Separate from `--auto-attachments`, `
|
|
58
|
+
Separate from `--auto-attachments`, `create-post` and `create-reply` across all three scopes (`gobi space`, `gobi global`, `gobi personal`) accept `--attach <file>` (repeatable) for inline post media — the photos/GIF/video that render in-feed alongside the post body. The CLI uploads each file to S3 via `POST /posts/upload-url` and passes the resulting `{ mediaUrl, mediaKey }` array as the post's `attachments`.
|
|
57
59
|
|
|
58
60
|
X-style mix rule (enforced client-side before upload): up to **4 photos** OR **1 GIF** OR **1 video** — they don't combine. Server-side ceilings: 5MB photos, 15MB GIFs, 512MB video.
|
|
59
61
|
|
|
@@ -135,9 +137,25 @@ gobi --json space list-posts
|
|
|
135
137
|
- `gobi global edit-reply <replyId>` — Edit a reply you authored. Accepts `--auto-attachments` and `--vault-slug` for attachment uploads (mirrors `space edit-reply`).
|
|
136
138
|
- `gobi global delete-reply <replyId>` — Delete a reply you authored.
|
|
137
139
|
|
|
140
|
+
### Personal-space posts (private)
|
|
141
|
+
|
|
142
|
+
`gobi personal` mirrors `gobi global`'s subcommand and write-flag shape, but every row is scoped to a private personal space (`personalSpaceUserId`). Nothing here surfaces on the public global feed — these posts are visible only to you. Use for private notes-as-posts, scratch drafts, or any post you want to author against your vault without making it public.
|
|
143
|
+
|
|
144
|
+
A couple of read-side flags don't mirror — `personal feed` has no `--following` (there's no follow graph in a private space), and `personal list-posts` has no `--mine` / `--vault-slug` (everything in the personal space is already yours).
|
|
145
|
+
|
|
146
|
+
- `gobi personal feed` — Your personal-space feed (posts and replies, newest first).
|
|
147
|
+
- `gobi personal list-posts` — List your personal-space posts.
|
|
148
|
+
- `gobi personal get-post <postId>` — Get a personal-space post with its ancestors and replies.
|
|
149
|
+
- `gobi personal create-post` — Create a private personal-space post. Same flags as `gobi global create-post` (`--vault-slug`, `--auto-attachments`, `--draft-id`, `--repost-post-id`, `--attach`).
|
|
150
|
+
- `gobi personal edit-post <postId>` — Edit a personal-space post you authored.
|
|
151
|
+
- `gobi personal delete-post <postId>` — Delete a personal-space post you authored.
|
|
152
|
+
- `gobi personal create-reply <postId>` — Reply to a personal-space post (inherits the parent's private scope).
|
|
153
|
+
- `gobi personal edit-reply <replyId>` — Edit a reply you authored.
|
|
154
|
+
- `gobi personal delete-reply <replyId>` — Delete a reply you authored.
|
|
155
|
+
|
|
138
156
|
## Confirm before mutating
|
|
139
157
|
|
|
140
|
-
|
|
158
|
+
Most posts and replies are publicly visible — in a community space (`gobi space …`) or in the global feed (`gobi global …`). `gobi personal …` is the exception: those rows are private to the author. Either way, before running any write, confirm with the user — show the exact command and the resolved title, content (or a short preview), and `authorVaultSlug` if `--vault-slug` / `--auto-attachments` is set. This applies even when running autonomously.
|
|
141
159
|
|
|
142
160
|
- `create-post` / `create-reply` — content goes live on submission.
|
|
143
161
|
|
|
@@ -153,3 +171,4 @@ Read-only commands (`list-posts`, `get-post`, `feed`, `list-topics`, `list-topic
|
|
|
153
171
|
|
|
154
172
|
- [gobi space](references/space.md)
|
|
155
173
|
- [gobi global](references/global.md)
|
|
174
|
+
- [gobi personal](references/personal.md)
|
|
@@ -12,7 +12,8 @@ Commands:
|
|
|
12
12
|
feed [options] List the unified feed (posts and replies, newest first) in the global public feed.
|
|
13
13
|
list-posts [options] List posts in the global feed (paginated). Pass --mine to limit to your own posts.
|
|
14
14
|
get-post [options] <postId> Get a global post with its ancestors and replies (paginated).
|
|
15
|
-
create-post [options] Create a post in the global feed. --vault-slug attributes it to a vault you own
|
|
15
|
+
create-post [options] Create a post in the global feed. --vault-slug attributes it to a vault you own. With no --vault-slug and no --auto-attachments, the post is created without an
|
|
16
|
+
authorVaultSlug (vault-less personal post).
|
|
16
17
|
edit-post [options] <postId> Edit a post you authored in the global feed.
|
|
17
18
|
delete-post <postId> Delete a post you authored in the global feed.
|
|
18
19
|
create-reply [options] <postId> Create a reply to a post in the global feed.
|
|
@@ -69,13 +70,14 @@ Options:
|
|
|
69
70
|
```
|
|
70
71
|
Usage: gobi global create-post [options]
|
|
71
72
|
|
|
72
|
-
Create a post in the global feed. --vault-slug attributes it to a vault you own
|
|
73
|
+
Create a post in the global feed. --vault-slug attributes it to a vault you own. With no --vault-slug and no --auto-attachments, the post is created without an authorVaultSlug (vault-less personal
|
|
74
|
+
post).
|
|
73
75
|
|
|
74
76
|
Options:
|
|
75
77
|
--title <title> Title of the post
|
|
76
78
|
--content <content> Post content (markdown supported, use "-" for stdin)
|
|
77
79
|
--rich-text <richText> Rich-text JSON array (mutually exclusive with --content)
|
|
78
|
-
--vault-slug <vaultSlug> Attribute the post to this vault (sets authorVaultSlug).
|
|
80
|
+
--vault-slug <vaultSlug> Attribute the post to this vault (sets authorVaultSlug). Caller must own the vault.
|
|
79
81
|
--auto-attachments Upload wiki-linked [[files]] to webdrive before posting (also sets authorVaultSlug to that vault)
|
|
80
82
|
--draft-id <draftId> Use this draft as the source of title and content (mutually exclusive with --title/--content/--rich-text). On success, links the post back by recording postId on
|
|
81
83
|
draft.metadata so the client can render an 'Open post' button. The draft's vaultSlug seeds --vault-slug when not given explicitly.
|
|
@@ -0,0 +1,154 @@
|
|
|
1
|
+
# gobi personal
|
|
2
|
+
|
|
3
|
+
```
|
|
4
|
+
Usage: gobi personal [options] [command]
|
|
5
|
+
|
|
6
|
+
Personal-space commands (private posts and replies visible only to you). Mirrors the `global` subcommand shape — posts/replies live in the same data model, scoped via personalSpaceUserId so they
|
|
7
|
+
never surface on the public feed.
|
|
8
|
+
|
|
9
|
+
Options:
|
|
10
|
+
-h, --help display help for command
|
|
11
|
+
|
|
12
|
+
Commands:
|
|
13
|
+
feed [options] List your personal-space feed (posts and replies, newest first). Only you can see these rows.
|
|
14
|
+
list-posts [options] List root posts (no replies) in your personal space. Filters the personal feed client-side; pagination cursor advances through the underlying feed page.
|
|
15
|
+
get-post [options] <postId> Get a personal-space post with its ancestors and replies (paginated). Same endpoint as `gobi global get-post`; only the owner can resolve a private id.
|
|
16
|
+
create-post [options] Create a private post in your personal space. --vault-slug attributes it to a vault you own. Visible only to you.
|
|
17
|
+
edit-post [options] <postId> Edit a post you authored in your personal space.
|
|
18
|
+
delete-post <postId> Delete a post you authored in your personal space.
|
|
19
|
+
create-reply [options] <postId> Reply to a personal-space post. The reply inherits the parent's private scope automatically.
|
|
20
|
+
edit-reply [options] <replyId> Edit a reply you authored in your personal space.
|
|
21
|
+
delete-reply <replyId> Delete a reply you authored in your personal space.
|
|
22
|
+
help [command] display help for command
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## feed
|
|
26
|
+
|
|
27
|
+
```
|
|
28
|
+
Usage: gobi personal feed [options]
|
|
29
|
+
|
|
30
|
+
List your personal-space feed (posts and replies, newest first). Only you can see these rows.
|
|
31
|
+
|
|
32
|
+
Options:
|
|
33
|
+
--limit <number> Items per page (default: "20")
|
|
34
|
+
--cursor <string> Pagination cursor from previous response
|
|
35
|
+
-h, --help display help for command
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
## list-posts
|
|
39
|
+
|
|
40
|
+
```
|
|
41
|
+
Usage: gobi personal list-posts [options]
|
|
42
|
+
|
|
43
|
+
List root posts (no replies) in your personal space. Filters the personal feed client-side; pagination cursor advances through the underlying feed page.
|
|
44
|
+
|
|
45
|
+
Options:
|
|
46
|
+
--limit <number> Items per page (applied to the underlying feed page) (default: "20")
|
|
47
|
+
--cursor <string> Pagination cursor from previous response
|
|
48
|
+
-h, --help display help for command
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
## get-post
|
|
52
|
+
|
|
53
|
+
```
|
|
54
|
+
Usage: gobi personal get-post [options] <postId>
|
|
55
|
+
|
|
56
|
+
Get a personal-space post with its ancestors and replies (paginated). Same endpoint as `gobi global get-post`; only the owner can resolve a private id.
|
|
57
|
+
|
|
58
|
+
Options:
|
|
59
|
+
--limit <number> Items per page (default: "20")
|
|
60
|
+
--cursor <string> Pagination cursor from previous response
|
|
61
|
+
--full Show full reply content without truncation
|
|
62
|
+
-h, --help display help for command
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
## create-post
|
|
66
|
+
|
|
67
|
+
```
|
|
68
|
+
Usage: gobi personal create-post [options]
|
|
69
|
+
|
|
70
|
+
Create a private post in your personal space. --vault-slug attributes it to a vault you own. Visible only to you.
|
|
71
|
+
|
|
72
|
+
Options:
|
|
73
|
+
--title <title> Title of the post
|
|
74
|
+
--content <content> Post content (markdown supported, use "-" for stdin)
|
|
75
|
+
--rich-text <richText> Rich-text JSON array (mutually exclusive with --content)
|
|
76
|
+
--vault-slug <vaultSlug> Attribute the post to this vault (sets authorVaultSlug). Caller must own the vault.
|
|
77
|
+
--auto-attachments Upload wiki-linked [[files]] to webdrive before posting (also sets authorVaultSlug to that vault)
|
|
78
|
+
--draft-id <draftId> Use this draft as the source of title and content (mutually exclusive with --title/--content/--rich-text). On success, links the post back via draft.metadata. The draft's
|
|
79
|
+
vaultSlug seeds --vault-slug when not given explicitly.
|
|
80
|
+
--attach <file> Local media file to attach. Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size ceilings: 5MB photos / 15MB GIFs / 512MB video. (default: [])
|
|
81
|
+
--repost-post-id <postId> Wrap an existing top-level post as the embedded card on this new private post. The referenced post must be visible to you (your own personal-space post, a global-feed
|
|
82
|
+
post, or a post in a space you're a member of). Reposting someone else's personal-space post returns 404.
|
|
83
|
+
-h, --help display help for command
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
## edit-post
|
|
87
|
+
|
|
88
|
+
```
|
|
89
|
+
Usage: gobi personal edit-post [options] <postId>
|
|
90
|
+
|
|
91
|
+
Edit a post you authored in your personal space.
|
|
92
|
+
|
|
93
|
+
Options:
|
|
94
|
+
--title <title> New title
|
|
95
|
+
--content <content> New content (markdown supported, use "-" for stdin)
|
|
96
|
+
--rich-text <richText> Rich-text JSON array (mutually exclusive with --content)
|
|
97
|
+
--vault-slug <vaultSlug> Attribute the post to this vault (sets authorVaultSlug).
|
|
98
|
+
--auto-attachments Upload wiki-linked [[files]] to webdrive before editing (uses --vault-slug or .gobi vault)
|
|
99
|
+
-h, --help display help for command
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
## delete-post
|
|
103
|
+
|
|
104
|
+
```
|
|
105
|
+
Usage: gobi personal delete-post [options] <postId>
|
|
106
|
+
|
|
107
|
+
Delete a post you authored in your personal space.
|
|
108
|
+
|
|
109
|
+
Options:
|
|
110
|
+
-h, --help display help for command
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
## create-reply
|
|
114
|
+
|
|
115
|
+
```
|
|
116
|
+
Usage: gobi personal create-reply [options] <postId>
|
|
117
|
+
|
|
118
|
+
Reply to a personal-space post. The reply inherits the parent's private scope automatically.
|
|
119
|
+
|
|
120
|
+
Options:
|
|
121
|
+
--content <content> Reply content (markdown supported, use "-" for stdin)
|
|
122
|
+
--rich-text <richText> Rich-text JSON array (mutually exclusive with --content)
|
|
123
|
+
--vault-slug <vaultSlug> Attribute the reply to this vault (sets authorVaultSlug). Also used as upload destination for --auto-attachments.
|
|
124
|
+
--auto-attachments Upload wiki-linked [[files]] to webdrive before posting (also attributes the reply to that vault)
|
|
125
|
+
--attach <file> Local media file to attach to this reply. Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size ceilings: 5MB photos / 15MB GIFs / 512MB video. (default:
|
|
126
|
+
[])
|
|
127
|
+
-h, --help display help for command
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
## edit-reply
|
|
131
|
+
|
|
132
|
+
```
|
|
133
|
+
Usage: gobi personal edit-reply [options] <replyId>
|
|
134
|
+
|
|
135
|
+
Edit a reply you authored in your personal space.
|
|
136
|
+
|
|
137
|
+
Options:
|
|
138
|
+
--content <content> New reply content (markdown supported, use "-" for stdin)
|
|
139
|
+
--rich-text <richText> Rich-text JSON array (mutually exclusive with --content)
|
|
140
|
+
--vault-slug <vaultSlug> Attribute the reply to this vault (sets authorVaultSlug). Also used as upload destination for --auto-attachments.
|
|
141
|
+
--auto-attachments Upload wiki-linked [[files]] to webdrive before editing (also attributes the reply to that vault)
|
|
142
|
+
-h, --help display help for command
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
## delete-reply
|
|
146
|
+
|
|
147
|
+
```
|
|
148
|
+
Usage: gobi personal delete-reply [options] <replyId>
|
|
149
|
+
|
|
150
|
+
Delete a reply you authored in your personal space.
|
|
151
|
+
|
|
152
|
+
Options:
|
|
153
|
+
-h, --help display help for command
|
|
154
|
+
```
|
|
@@ -10,9 +10,7 @@ Options:
|
|
|
10
10
|
-h, --help display help for command
|
|
11
11
|
|
|
12
12
|
Commands:
|
|
13
|
-
list List spaces you are a member of.
|
|
14
13
|
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).
|
|
15
|
-
warp [spaceSlug] Select the active space. Pass a slug to warp directly, or omit for interactive selection.
|
|
16
14
|
list-topics [options] List topics in a space, ordered by most recent content linkage.
|
|
17
15
|
list-topic-posts [options] <topicSlug> List posts tagged with a topic in a space (cursor-paginated).
|
|
18
16
|
feed [options] List the unified feed (posts and replies, newest first) in a space.
|
|
@@ -121,7 +119,7 @@ Options:
|
|
|
121
119
|
--content <content> Post content (markdown supported, use "-" for stdin)
|
|
122
120
|
--rich-text <richText> Rich-text JSON array (mutually exclusive with --content)
|
|
123
121
|
--auto-attachments Upload wiki-linked [[files]] to webdrive before posting (also attributes the post to that vault)
|
|
124
|
-
--vault-slug <vaultSlug> Attribute the post to this vault (sets
|
|
122
|
+
--vault-slug <vaultSlug> Attribute the post to this vault (sets authorVaultSlug). Also used as upload destination for --auto-attachments.
|
|
125
123
|
--space-slug <spaceSlug> Space slug (overrides .gobi/settings.yaml)
|
|
126
124
|
--draft-id <draftId> Use this draft as the source of title and content (mutually exclusive with --title/--content/--rich-text). On success, links the post back by recording postId/spaceSlug
|
|
127
125
|
on draft.metadata so the client can render an 'Open post' button. The draft's vaultSlug seeds --vault-slug when not given explicitly.
|
|
@@ -143,7 +141,7 @@ Options:
|
|
|
143
141
|
--content <content> New content for the post (markdown supported, use "-" for stdin)
|
|
144
142
|
--rich-text <richText> Rich-text JSON array (mutually exclusive with --content)
|
|
145
143
|
--auto-attachments Upload wiki-linked [[files]] to webdrive before editing (also attributes the post to that vault)
|
|
146
|
-
--vault-slug <vaultSlug> Attribute the post to this vault (sets
|
|
144
|
+
--vault-slug <vaultSlug> Attribute the post to this vault (sets authorVaultSlug). Also used as upload destination for --auto-attachments.
|
|
147
145
|
--space-slug <spaceSlug> Space slug (overrides .gobi/settings.yaml)
|
|
148
146
|
-h, --help display help for command
|
|
149
147
|
```
|
|
@@ -8,18 +8,23 @@ description: >-
|
|
|
8
8
|
allowed-tools: Bash(gobi:*)
|
|
9
9
|
metadata:
|
|
10
10
|
author: gobi-ai
|
|
11
|
-
version: "2.0.
|
|
11
|
+
version: "2.0.23"
|
|
12
12
|
---
|
|
13
13
|
|
|
14
14
|
# gobi-vault
|
|
15
15
|
|
|
16
|
-
Gobi vault commands for publishing your vault profile and syncing files (v2.0.
|
|
16
|
+
Gobi vault commands for publishing your vault profile and syncing files (v2.0.23).
|
|
17
17
|
|
|
18
18
|
Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
|
|
19
19
|
|
|
20
20
|
## Prerequisites
|
|
21
21
|
|
|
22
|
-
|
|
22
|
+
Most `gobi vault …` commands resolve the target vault from the current directory's `.gobi/settings.yaml` (specifically the `vaultSlug` entry); run `gobi vault init` first if it's missing.
|
|
23
|
+
|
|
24
|
+
Exceptions:
|
|
25
|
+
- `vault init`, `vault list`, `vault create <slug>` — no `.gobi` required.
|
|
26
|
+
- `vault delete <slug>`, `vault set-primary <slug>` — slug is a positional, no `.gobi` fallback.
|
|
27
|
+
- `vault rename <newName>`, `vault status` — accept an optional `--vault-slug <slug>` to target a vault other than the one in `.gobi`.
|
|
23
28
|
|
|
24
29
|
## Gobi Vault
|
|
25
30
|
|
|
@@ -42,7 +47,7 @@ gobi --json vault publish
|
|
|
42
47
|
- `gobi vault rename <newName>` — Rename the configured vault's display name. Pass `--vault-slug <slug>` to target another vault. Local handle only — the public profile title comes from `PUBLISH.md` frontmatter and is unaffected.
|
|
43
48
|
- `gobi vault set-primary <slug>` — Mark a vault as your primary. Unsets primary on the others. Required arg, no `.gobi` fallback (avoids accidental promotion).
|
|
44
49
|
- `gobi vault delete <slug>` — Delete a vault. Irreversible. Required arg, no `.gobi` fallback. The API will reject if the vault still owns content; clean up posts, members, and files first.
|
|
45
|
-
- `gobi vault publish` — Upload `PUBLISH.md` to the vault root on webdrive. Triggers post-processing (vault profile sync, metadata update
|
|
50
|
+
- `gobi vault publish` — Upload `PUBLISH.md` to the vault root on webdrive. Triggers post-processing (vault profile sync, metadata update).
|
|
46
51
|
- `gobi vault unpublish` — Delete `PUBLISH.md` from the vault on webdrive.
|
|
47
52
|
- `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`.
|
|
48
53
|
|
|
@@ -59,9 +64,9 @@ When linking back to your own posts or files, assemble the URL from concrete fie
|
|
|
59
64
|
|
|
60
65
|
## Confirm before mutating
|
|
61
66
|
|
|
62
|
-
Every command in this skill writes external state — webdrive files
|
|
67
|
+
Every command in this skill writes external state — webdrive files and the public vault profile. Before running any of them, confirm with the user — show the exact command and the key changes (which `PUBLISH.md` fields, which paths will sync, which conflict policy). This applies even when running autonomously.
|
|
63
68
|
|
|
64
|
-
- `vault publish` — public profile change
|
|
69
|
+
- `vault publish` — public profile change. Always confirm.
|
|
65
70
|
- `vault unpublish` — removes the live profile. Always confirm.
|
|
66
71
|
- `vault sync` — can overwrite remote or local files. Run `--dry-run` first and show the user the plan before re-running without `--dry-run`. With `--conflict server` or `--conflict client`, name which side is going to be overwritten.
|
|
67
72
|
- `vault delete <slug>` — irreversible; cannot undo. Confirm the slug and that the user actually means to delete *that* vault before running.
|
|
@@ -120,7 +125,7 @@ After editing `PUBLISH.md` frontmatter, follow these steps to make your changes
|
|
|
120
125
|
```bash
|
|
121
126
|
gobi vault publish
|
|
122
127
|
```
|
|
123
|
-
This uploads `PUBLISH.md` to webdrive, triggers post-processing that extracts metadata (title, description, tags, thumbnail, homepage path), updates the vault's public profile
|
|
128
|
+
This uploads `PUBLISH.md` to webdrive, triggers post-processing that extracts metadata (title, description, tags, thumbnail, homepage path), and updates the vault's public profile.
|
|
124
129
|
4. The vault is now live at `https://gobispace.com/@{vaultSlug}`.
|
|
125
130
|
|
|
126
131
|
> **Important:** Any time you change `PUBLISH.md` frontmatter (e.g. adding or updating `homepage`), you must re-run `gobi vault publish` for the changes to take effect.
|
|
@@ -19,7 +19,7 @@ Commands:
|
|
|
19
19
|
set-primary <slug> Mark a vault as your primary. Unsets primary on the other vaults you own. Slug must be passed explicitly.
|
|
20
20
|
list List vaults you own.
|
|
21
21
|
status [options] Show the configured vault's publish state and metadata (use before posting with --auto-attachments to confirm the vault is public).
|
|
22
|
-
publish Upload PUBLISH.md to the vault root on webdrive. Triggers post-processing (vault sync, metadata update
|
|
22
|
+
publish Upload PUBLISH.md to the vault root on webdrive. Triggers post-processing (vault sync, metadata update).
|
|
23
23
|
unpublish Delete PUBLISH.md from the vault on webdrive.
|
|
24
24
|
sync [options] Sync local vault files with Gobi Webdrive.
|
|
25
25
|
help [command] display help for command
|
|
@@ -112,7 +112,7 @@ Options:
|
|
|
112
112
|
```
|
|
113
113
|
Usage: gobi vault publish [options]
|
|
114
114
|
|
|
115
|
-
Upload PUBLISH.md to the vault root on webdrive. Triggers post-processing (vault sync, metadata update
|
|
115
|
+
Upload PUBLISH.md to the vault root on webdrive. Triggers post-processing (vault sync, metadata update).
|
|
116
116
|
|
|
117
117
|
Options:
|
|
118
118
|
-h, --help display help for command
|