@gobi-ai/cli 2.0.24 → 2.0.25
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 -3
- package/.claude-plugin/plugin.json +2 -2
- package/README.md +30 -35
- package/dist/commands/artifact.js +472 -0
- package/dist/commands/global.js +24 -79
- package/dist/commands/personal.js +23 -76
- package/dist/commands/space.js +25 -80
- package/dist/commands/utils.js +0 -15
- package/dist/commands/vault.js +1 -1
- package/dist/main.js +2 -2
- package/package.json +1 -1
- package/skills/gobi-artifact/SKILL.md +133 -0
- package/skills/gobi-artifact/references/artifact.md +142 -0
- package/skills/gobi-core/SKILL.md +6 -7
- package/skills/gobi-homepage/SKILL.md +1 -1
- package/skills/gobi-media/SKILL.md +2 -2
- package/skills/gobi-sense/SKILL.md +2 -2
- package/skills/gobi-space/SKILL.md +12 -18
- package/skills/gobi-space/references/global.md +5 -12
- package/skills/gobi-space/references/personal.md +2 -8
- package/skills/gobi-space/references/space.md +4 -10
- package/skills/gobi-vault/SKILL.md +3 -3
- package/skills/gobi-vault/references/vault.md +2 -2
- package/dist/commands/draft.js +0 -230
- package/skills/gobi-draft/SKILL.md +0 -113
- package/skills/gobi-draft/references/draft.md +0 -114
|
@@ -0,0 +1,142 @@
|
|
|
1
|
+
# gobi artifact
|
|
2
|
+
|
|
3
|
+
```
|
|
4
|
+
Usage: gobi artifact [options] [command]
|
|
5
|
+
|
|
6
|
+
Versioned creations attached to posts. Kinds: image | video | gif | markdown | meeting_summary. Always human-owned; revisions form a draft/published tree (at most one published per artifact).
|
|
7
|
+
|
|
8
|
+
Options:
|
|
9
|
+
-h, --help display help for command
|
|
10
|
+
|
|
11
|
+
Commands:
|
|
12
|
+
create [options] Create an artifact. markdown/meeting_summary kinds take a body via --file, --content, or stdin ("-"). image/gif/video kinds upload --file. Pass --post-id to attach
|
|
13
|
+
the new artifact to a post.
|
|
14
|
+
revise [options] <artifactId> Add a draft revision to an artifact. New body via --file, --content, or stdin (markdown), or --file (media). Use --from to branch off a specific revision.
|
|
15
|
+
publish [options] <artifactId> Publish a revision (becomes the artifact's single published revision).
|
|
16
|
+
revert [options] <artifactId> Revert the artifact's published pointer to an earlier revision.
|
|
17
|
+
history <artifactId> List the artifact's full revision tree (owner only).
|
|
18
|
+
download [options] <artifactId> Download an artifact's content. markdown → write the body; media → fetch the bytes. Defaults to the published/latest revision; pass --revision to pick one. Writes
|
|
19
|
+
to --out or stdout (markdown).
|
|
20
|
+
delete <artifactId> Delete an artifact (and its revision tree).
|
|
21
|
+
get <artifactId> Get one artifact with its current revision.
|
|
22
|
+
list [options] List your artifacts (newest first).
|
|
23
|
+
help [command] display help for command
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
## create
|
|
27
|
+
|
|
28
|
+
```
|
|
29
|
+
Usage: gobi artifact create [options]
|
|
30
|
+
|
|
31
|
+
Create an artifact. markdown/meeting_summary kinds take a body via --file, --content, or stdin ("-"). image/gif/video kinds upload --file. Pass --post-id to attach the new artifact to a post.
|
|
32
|
+
|
|
33
|
+
Options:
|
|
34
|
+
--kind <kind> Artifact kind: image | video | gif | markdown | meeting_summary
|
|
35
|
+
--file <path> Local file: markdown body (markdown kinds) or media file (media kinds)
|
|
36
|
+
--content <md> Markdown body inline (markdown kinds; pass "-" for stdin)
|
|
37
|
+
--title <t> Display title
|
|
38
|
+
--vault-slug <slug> Anchor vault for [[wikilink]] resolution (markdown kinds). Stored in metadata.vaultSlug.
|
|
39
|
+
--post-id <id> Attach the created artifact to this post afterward
|
|
40
|
+
--auto-attachments Upload wiki-linked [[files]] to webdrive before creating (markdown kinds; uses --vault-slug)
|
|
41
|
+
--change-note <note> Note describing this revision
|
|
42
|
+
-h, --help display help for command
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
## revise
|
|
46
|
+
|
|
47
|
+
```
|
|
48
|
+
Usage: gobi artifact revise [options] <artifactId>
|
|
49
|
+
|
|
50
|
+
Add a draft revision to an artifact. New body via --file, --content, or stdin (markdown), or --file (media). Use --from to branch off a specific revision.
|
|
51
|
+
|
|
52
|
+
Options:
|
|
53
|
+
--file <path> Local file: markdown body (markdown kinds) or media file (media kinds)
|
|
54
|
+
--content <md> Markdown body inline (markdown kinds; pass "-" for stdin)
|
|
55
|
+
--change-note <note> Note describing this revision
|
|
56
|
+
--from <revisionId> Branch the new draft off this revision (defaults to the latest)
|
|
57
|
+
--auto-attachments Upload wiki-linked [[files]] to webdrive before revising (markdown kinds; uses the artifact's stored metadata.vaultSlug)
|
|
58
|
+
-h, --help display help for command
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
## publish
|
|
62
|
+
|
|
63
|
+
```
|
|
64
|
+
Usage: gobi artifact publish [options] <artifactId>
|
|
65
|
+
|
|
66
|
+
Publish a revision (becomes the artifact's single published revision).
|
|
67
|
+
|
|
68
|
+
Options:
|
|
69
|
+
--revision <revisionId> Revision to publish
|
|
70
|
+
-h, --help display help for command
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
## revert
|
|
74
|
+
|
|
75
|
+
```
|
|
76
|
+
Usage: gobi artifact revert [options] <artifactId>
|
|
77
|
+
|
|
78
|
+
Revert the artifact's published pointer to an earlier revision.
|
|
79
|
+
|
|
80
|
+
Options:
|
|
81
|
+
--to <revisionId> Revision to revert to
|
|
82
|
+
-h, --help display help for command
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
## history
|
|
86
|
+
|
|
87
|
+
```
|
|
88
|
+
Usage: gobi artifact history [options] <artifactId>
|
|
89
|
+
|
|
90
|
+
List the artifact's full revision tree (owner only).
|
|
91
|
+
|
|
92
|
+
Options:
|
|
93
|
+
-h, --help display help for command
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
## download
|
|
97
|
+
|
|
98
|
+
```
|
|
99
|
+
Usage: gobi artifact download [options] <artifactId>
|
|
100
|
+
|
|
101
|
+
Download an artifact's content. markdown → write the body; media → fetch the bytes. Defaults to the published/latest revision; pass --revision to pick one. Writes to --out or stdout (markdown).
|
|
102
|
+
|
|
103
|
+
Options:
|
|
104
|
+
--revision <revisionId> Specific revision (defaults to the artifact's current revision)
|
|
105
|
+
--out <path> Write to this file (markdown defaults to stdout)
|
|
106
|
+
-h, --help display help for command
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
## delete
|
|
110
|
+
|
|
111
|
+
```
|
|
112
|
+
Usage: gobi artifact delete [options] <artifactId>
|
|
113
|
+
|
|
114
|
+
Delete an artifact (and its revision tree).
|
|
115
|
+
|
|
116
|
+
Options:
|
|
117
|
+
-h, --help display help for command
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
## get
|
|
121
|
+
|
|
122
|
+
```
|
|
123
|
+
Usage: gobi artifact get [options] <artifactId>
|
|
124
|
+
|
|
125
|
+
Get one artifact with its current revision.
|
|
126
|
+
|
|
127
|
+
Options:
|
|
128
|
+
-h, --help display help for command
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
## list
|
|
132
|
+
|
|
133
|
+
```
|
|
134
|
+
Usage: gobi artifact list [options]
|
|
135
|
+
|
|
136
|
+
List your artifacts (newest first).
|
|
137
|
+
|
|
138
|
+
Options:
|
|
139
|
+
--kind <kind> Filter by kind: image | video | gif | markdown | meeting_summary
|
|
140
|
+
--limit <n> Max items to return
|
|
141
|
+
-h, --help display help for command
|
|
142
|
+
```
|
|
@@ -8,12 +8,12 @@ description: >-
|
|
|
8
8
|
allowed-tools: Bash(gobi:*)
|
|
9
9
|
metadata:
|
|
10
10
|
author: gobi-ai
|
|
11
|
-
version: "2.0.
|
|
11
|
+
version: "2.0.25"
|
|
12
12
|
---
|
|
13
13
|
|
|
14
14
|
# gobi-core
|
|
15
15
|
|
|
16
|
-
Core CLI commands for the Gobi collaborative knowledge platform (v2.0.
|
|
16
|
+
Core CLI commands for the Gobi collaborative knowledge platform (v2.0.25).
|
|
17
17
|
|
|
18
18
|
## Prerequisites
|
|
19
19
|
|
|
@@ -41,7 +41,7 @@ brew tap gobi-ai/tap && brew install gobi
|
|
|
41
41
|
- **Personal Post**: A post on the author's profile that surfaces in the public global feed. Same `Post` data model as a Space Post — only the scope differs.
|
|
42
42
|
- **Space Post**: A post inside a community space.
|
|
43
43
|
- **Space**: A shared community knowledge area. A user can be a member of one or more spaces; each space contains posts, replies, and connected vaults.
|
|
44
|
-
- **
|
|
44
|
+
- **Artifact**: A versioned, human-owned creation (image, video, gif, markdown, or meeting_summary) attached to posts. Its revisions form a draft/published tree (at most one published). See the **gobi-artifact** skill.
|
|
45
45
|
|
|
46
46
|
## Setup steps (run only what you need)
|
|
47
47
|
|
|
@@ -50,7 +50,7 @@ There is **no `gobi init`** command — each setup step is its own command, and
|
|
|
50
50
|
| Step | Command | Unlocks |
|
|
51
51
|
|------|---------|---------|
|
|
52
52
|
| 1. Log in | `gobi auth login` | All authenticated commands |
|
|
53
|
-
| 2. Configure a vault for this directory | `gobi vault init` | Every `gobi vault …` command; also lets `
|
|
53
|
+
| 2. Configure a vault for this directory | `gobi vault init` | Every `gobi vault …` command; also lets `artifact create --auto-attachments` resolve that vault automatically |
|
|
54
54
|
| 3. Pick an active space for this directory | `gobi space warp` | Every `gobi space …` post/reply/feed command without needing `--space-slug` |
|
|
55
55
|
|
|
56
56
|
After step 2 + step 3, `.gobi/settings.yaml` looks like:
|
|
@@ -72,7 +72,7 @@ gobi auth status
|
|
|
72
72
|
|
|
73
73
|
| Command family | Needs vault in `.gobi`? | Needs space in `.gobi`? | Per-call override |
|
|
74
74
|
|----------------|------------------------|------------------------|-------------------|
|
|
75
|
-
| `auth …`, `update`, `
|
|
75
|
+
| `auth …`, `update`, `artifact …`, `media …`, `sense …` | no | no | – |
|
|
76
76
|
| `vault publish` / `unpublish` / `sync` | **yes** | no | none — must run `gobi vault init` first |
|
|
77
77
|
| `vault init` | no (it sets it up) | no | – |
|
|
78
78
|
| `space list` / `warp [slug]` / `get [slug]` | no | no | – |
|
|
@@ -84,7 +84,7 @@ gobi auth status
|
|
|
84
84
|
| `personal create-post` | optional¹ | no | command-level `--vault-slug <slug>` |
|
|
85
85
|
| `personal edit-post` | optional² | no | command-level `--vault-slug <slug>` |
|
|
86
86
|
|
|
87
|
-
¹ `global create-post` accepts `--vault-slug
|
|
87
|
+
¹ `global create-post` accepts `--vault-slug`, optional. With no flag and no `vaultSlug` in `.gobi`, the post is created with no `authorVaultSlug` (vault-less personal post) — same as a Space post that isn't attributed to any vault. Set `--vault-slug` to attribute it.
|
|
88
88
|
|
|
89
89
|
² `global edit-post` only consults `--vault-slug` when you pass it explicitly. Use `--vault-slug ""` to detach an existing attribution; non-empty re-attaches.
|
|
90
90
|
|
|
@@ -139,4 +139,3 @@ Read-only commands (`auth status`, `space list`) run without confirmation.
|
|
|
139
139
|
| `GOBI_BASE_URL` | `https://api.joingobi.com` | API server URL |
|
|
140
140
|
| `GOBI_WEBDRIVE_BASE_URL` | `https://webdrive.joingobi.com` | File storage URL |
|
|
141
141
|
| `GOBI_WEB_BASE_URL` | `https://gobispace.com` | Public web URL (used when assembling shareable links) |
|
|
142
|
-
| `GOBI_SESSION_ID` | — | Default `--session` for `gobi draft add` (set automatically inside agent runs) |
|
|
@@ -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.25"
|
|
14
14
|
---
|
|
15
15
|
|
|
16
16
|
# gobi-media
|
|
17
17
|
|
|
18
|
-
Gobi media generation commands (v2.0.
|
|
18
|
+
Gobi media generation commands (v2.0.25).
|
|
19
19
|
|
|
20
20
|
Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
|
|
21
21
|
|
|
@@ -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.25"
|
|
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.25).
|
|
16
16
|
|
|
17
17
|
Requires gobi-cli installed and authenticated. See the **gobi-core** skill for setup.
|
|
18
18
|
|
|
@@ -11,12 +11,12 @@ description: >-
|
|
|
11
11
|
allowed-tools: Bash(gobi:*)
|
|
12
12
|
metadata:
|
|
13
13
|
author: gobi-ai
|
|
14
|
-
version: "2.0.
|
|
14
|
+
version: "2.0.25"
|
|
15
15
|
---
|
|
16
16
|
|
|
17
17
|
# gobi-space
|
|
18
18
|
|
|
19
|
-
Gobi space, global, and personal-space posts (v2.0.
|
|
19
|
+
Gobi space, global, and personal-space posts (v2.0.25).
|
|
20
20
|
|
|
21
21
|
Requires gobi-cli installed and authenticated. See the **gobi-core** skill for setup.
|
|
22
22
|
|
|
@@ -49,17 +49,15 @@ The same applies to replies: a reply has only `--content` (no title), so do not
|
|
|
49
49
|
|
|
50
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.
|
|
51
51
|
|
|
52
|
-
`--auto-attachments`
|
|
53
|
-
|
|
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.
|
|
52
|
+
> **Wiki-link uploads moved to artifacts.** The `--auto-attachments` flag that used to upload `[[wiki-linked files]]` from a post body now lives on `gobi artifact create` / `gobi artifact revise` (markdown kinds). To publish a markdown creation with resolvable wikilinks, create a markdown artifact with `--vault-slug` + `--auto-attachments` and attach it to the post (`--post-id`). See the **gobi-artifact** skill. Before relying on wikilink resolution, confirm the anchor vault is published: `gobi --json vault status --vault-slug <slug>` should report `isPublished: true`.
|
|
55
53
|
|
|
56
54
|
## Post media attachments (`--attach`)
|
|
57
55
|
|
|
58
|
-
|
|
56
|
+
`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`.
|
|
59
57
|
|
|
60
58
|
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.
|
|
61
59
|
|
|
62
|
-
Use `--attach` for media you want shown in the post itself; use
|
|
60
|
+
Use `--attach` for media you want shown in the post itself; use a markdown **artifact** (`gobi artifact create`) for `[[wikilinks]]`-bearing creations attached to the post.
|
|
63
61
|
|
|
64
62
|
## Public link formats
|
|
65
63
|
|
|
@@ -86,7 +84,7 @@ When you echo a "Post created!" line (or the JSON response is consumed by anothe
|
|
|
86
84
|
|
|
87
85
|
If `.gobi/settings.yaml` has no `selectedSpaceSlug` and `--space-slug` isn't passed, the command will error.
|
|
88
86
|
|
|
89
|
-
`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>`
|
|
87
|
+
`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>` to attribute the post; with no flag the post is created without an `authorVaultSlug`.
|
|
90
88
|
|
|
91
89
|
## Important: JSON Mode
|
|
92
90
|
|
|
@@ -114,7 +112,7 @@ gobi --json space list-posts
|
|
|
114
112
|
### Space posts
|
|
115
113
|
- `gobi space list-posts` — List posts in a space (paginated).
|
|
116
114
|
- `gobi space get-post <postId>` — Get a post with its ancestors and replies (paginated). Ancestors and replies are returned together; there is no separate `ancestors` or `list-replies` command.
|
|
117
|
-
- `gobi space create-post` — Create a space post. `--vault-slug` attributes it to a vault you own
|
|
115
|
+
- `gobi space create-post` — Create a space post. `--vault-slug` attributes it to a vault you own.
|
|
118
116
|
- `gobi space edit-post <postId>` — Edit a space post. You must be the author. `--vault-slug ""` detaches the vault.
|
|
119
117
|
- `gobi space delete-post <postId>` — Delete a space post. You must be the author.
|
|
120
118
|
|
|
@@ -130,11 +128,11 @@ gobi --json space list-posts
|
|
|
130
128
|
- `gobi global feed` — List the public global feed (posts and replies, newest first).
|
|
131
129
|
- `gobi global list-posts` — List personal posts. `--mine` for your own; `--vault-slug <slug>` to filter by author vault.
|
|
132
130
|
- `gobi global get-post <postId>` — Get a personal post with its ancestors and replies.
|
|
133
|
-
- `gobi global create-post` — Create a personal post. `--vault-slug`
|
|
134
|
-
- `gobi global edit-post <postId>` — Edit a personal post you authored. `--vault-slug ""` detaches the vault
|
|
131
|
+
- `gobi global create-post` — Create a personal post. `--vault-slug` works the same as on `space create-post`. It is optional: with no flag, the post is created without an `authorVaultSlug` (vault-less personal post).
|
|
132
|
+
- `gobi global edit-post <postId>` — Edit a personal post you authored. `--vault-slug ""` detaches the vault.
|
|
135
133
|
- `gobi global delete-post <postId>` — Delete a personal post you authored.
|
|
136
134
|
- `gobi global create-reply <postId>` — Reply to a personal post.
|
|
137
|
-
- `gobi global edit-reply <replyId>` — Edit a reply you authored. Accepts `--
|
|
135
|
+
- `gobi global edit-reply <replyId>` — Edit a reply you authored. Accepts `--vault-slug` for author attribution (mirrors `space edit-reply`).
|
|
138
136
|
- `gobi global delete-reply <replyId>` — Delete a reply you authored.
|
|
139
137
|
|
|
140
138
|
### Personal-space posts (private)
|
|
@@ -146,7 +144,7 @@ A couple of read-side flags don't mirror — `personal feed` has no `--following
|
|
|
146
144
|
- `gobi personal feed` — Your personal-space feed (posts and replies, newest first).
|
|
147
145
|
- `gobi personal list-posts` — List your personal-space posts.
|
|
148
146
|
- `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`, `--
|
|
147
|
+
- `gobi personal create-post` — Create a private personal-space post. Same flags as `gobi global create-post` (`--vault-slug`, `--repost-post-id`, `--attach`).
|
|
150
148
|
- `gobi personal edit-post <postId>` — Edit a personal-space post you authored.
|
|
151
149
|
- `gobi personal delete-post <postId>` — Delete a personal-space post you authored.
|
|
152
150
|
- `gobi personal create-reply <postId>` — Reply to a personal-space post (inherits the parent's private scope).
|
|
@@ -155,13 +153,9 @@ A couple of read-side flags don't mirror — `personal feed` has no `--following
|
|
|
155
153
|
|
|
156
154
|
## Confirm before mutating
|
|
157
155
|
|
|
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`
|
|
156
|
+
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` is set. This applies even when running autonomously.
|
|
159
157
|
|
|
160
158
|
- `create-post` / `create-reply` — content goes live on submission.
|
|
161
|
-
|
|
162
|
-
### Linking back to a draft
|
|
163
|
-
|
|
164
|
-
When a `create-post` is the side-effect of an actioned draft (e.g. the user picked "Post to Global Feed" / "Post to <space>"), pass `--draft-id <draftId>` to `gobi space create-post` or `gobi global create-post`. `--draft-id` is the **sole** source of `title` and `content` — it cannot coexist with `--title`, `--content`, or `--rich-text`. To change the wording, `gobi draft revise` first, then create the post. The draft's `vaultSlug` (when set) seeds the post's `--vault-slug` if not given explicitly. `--auto-attachments` and an explicit `--vault-slug` override are still allowed. On success the CLI records `{ postId, spaceSlug? }` on `draft.metadata`, which the client renders as an "Open post" button on the actioned draft.
|
|
165
159
|
- `edit-post` / `edit-reply` — confirm the *new* content; people who already saw the original may re-see it.
|
|
166
160
|
- `delete-post` / `delete-reply` — irreversible. Flag that explicitly and confirm the target id before running.
|
|
167
161
|
|
|
@@ -12,8 +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. With no --vault-slug
|
|
16
|
-
|
|
15
|
+
create-post [options] Create a post in the global feed. --vault-slug attributes it to a vault you own. With no --vault-slug, the post is created without an authorVaultSlug (vault-less
|
|
16
|
+
personal post).
|
|
17
17
|
edit-post [options] <postId> Edit a post you authored in the global feed.
|
|
18
18
|
delete-post <postId> Delete a post you authored in the global feed.
|
|
19
19
|
create-reply [options] <postId> Create a reply to a post in the global feed.
|
|
@@ -70,17 +70,13 @@ Options:
|
|
|
70
70
|
```
|
|
71
71
|
Usage: gobi global create-post [options]
|
|
72
72
|
|
|
73
|
-
Create a post in the global feed. --vault-slug attributes it to a vault you own. With no --vault-slug
|
|
74
|
-
post).
|
|
73
|
+
Create a post in the global feed. --vault-slug attributes it to a vault you own. With no --vault-slug, the post is created without an authorVaultSlug (vault-less personal post).
|
|
75
74
|
|
|
76
75
|
Options:
|
|
77
76
|
--title <title> Title of the post
|
|
78
77
|
--content <content> Post content (markdown supported, use "-" for stdin)
|
|
79
78
|
--rich-text <richText> Rich-text JSON array (mutually exclusive with --content)
|
|
80
79
|
--vault-slug <vaultSlug> Attribute the post to this vault (sets authorVaultSlug). Caller must own the vault.
|
|
81
|
-
--auto-attachments Upload wiki-linked [[files]] to webdrive before posting (also sets authorVaultSlug to that vault)
|
|
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
|
|
83
|
-
draft.metadata so the client can render an 'Open post' button. The draft's vaultSlug seeds --vault-slug when not given explicitly.
|
|
84
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: [])
|
|
85
81
|
--repost-post-id <postId> Wrap an existing top-level post as the embedded card on this new post. Composes with --content / --rich-text / --attach (the wrapping author's text + media render above
|
|
86
82
|
the embedded card). Reposts-of-reposts are collapsed to the transitive root server-side. The referenced post must exist, not be deleted, and not itself be a reply.
|
|
@@ -99,7 +95,6 @@ Options:
|
|
|
99
95
|
--content <content> New content (markdown supported, use "-" for stdin)
|
|
100
96
|
--rich-text <richText> Rich-text JSON array (mutually exclusive with --content)
|
|
101
97
|
--vault-slug <vaultSlug> Attribute the post to this vault (sets authorVaultSlug).
|
|
102
|
-
--auto-attachments Upload wiki-linked [[files]] to webdrive before editing (uses --vault-slug or .gobi vault)
|
|
103
98
|
--attach <file> Replace the post's media attachments with the given files (existing attachments are removed). Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size
|
|
104
99
|
ceilings: 5MB photos / 15MB GIFs / 512MB video. Omit to leave attachments unchanged. (default: [])
|
|
105
100
|
-h, --help display help for command
|
|
@@ -126,8 +121,7 @@ Create a reply to a post in the global feed.
|
|
|
126
121
|
Options:
|
|
127
122
|
--content <content> Reply content (markdown supported, use "-" for stdin)
|
|
128
123
|
--rich-text <richText> Rich-text JSON array (mutually exclusive with --content)
|
|
129
|
-
--vault-slug <vaultSlug> Attribute the reply to this vault (sets authorVaultSlug).
|
|
130
|
-
--auto-attachments Upload wiki-linked [[files]] to webdrive before posting (also attributes the reply to that vault)
|
|
124
|
+
--vault-slug <vaultSlug> Attribute the reply to this vault (sets authorVaultSlug).
|
|
131
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:
|
|
132
126
|
[])
|
|
133
127
|
-h, --help display help for command
|
|
@@ -143,8 +137,7 @@ Edit a reply you authored in the global feed.
|
|
|
143
137
|
Options:
|
|
144
138
|
--content <content> New reply content (markdown supported, use "-" for stdin)
|
|
145
139
|
--rich-text <richText> Rich-text JSON array (mutually exclusive with --content)
|
|
146
|
-
--vault-slug <vaultSlug> Attribute the reply to this vault (sets authorVaultSlug).
|
|
147
|
-
--auto-attachments Upload wiki-linked [[files]] to webdrive before editing (also attributes the reply to that vault)
|
|
140
|
+
--vault-slug <vaultSlug> Attribute the reply to this vault (sets authorVaultSlug).
|
|
148
141
|
-h, --help display help for command
|
|
149
142
|
```
|
|
150
143
|
|
|
@@ -74,9 +74,6 @@ Options:
|
|
|
74
74
|
--content <content> Post content (markdown supported, use "-" for stdin)
|
|
75
75
|
--rich-text <richText> Rich-text JSON array (mutually exclusive with --content)
|
|
76
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
77
|
--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
78
|
--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
79
|
post, or a post in a space you're a member of). Reposting someone else's personal-space post returns 404.
|
|
@@ -95,7 +92,6 @@ Options:
|
|
|
95
92
|
--content <content> New content (markdown supported, use "-" for stdin)
|
|
96
93
|
--rich-text <richText> Rich-text JSON array (mutually exclusive with --content)
|
|
97
94
|
--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
95
|
--attach <file> Replace the post's media attachments with the given files (existing attachments are removed). Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size
|
|
100
96
|
ceilings: 5MB photos / 15MB GIFs / 512MB video. Omit to leave attachments unchanged. (default: [])
|
|
101
97
|
-h, --help display help for command
|
|
@@ -122,8 +118,7 @@ Reply to a personal-space post. The reply inherits the parent's private scope au
|
|
|
122
118
|
Options:
|
|
123
119
|
--content <content> Reply content (markdown supported, use "-" for stdin)
|
|
124
120
|
--rich-text <richText> Rich-text JSON array (mutually exclusive with --content)
|
|
125
|
-
--vault-slug <vaultSlug> Attribute the reply to this vault (sets authorVaultSlug).
|
|
126
|
-
--auto-attachments Upload wiki-linked [[files]] to webdrive before posting (also attributes the reply to that vault)
|
|
121
|
+
--vault-slug <vaultSlug> Attribute the reply to this vault (sets authorVaultSlug).
|
|
127
122
|
--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:
|
|
128
123
|
[])
|
|
129
124
|
-h, --help display help for command
|
|
@@ -139,8 +134,7 @@ Edit a reply you authored in your personal space.
|
|
|
139
134
|
Options:
|
|
140
135
|
--content <content> New reply content (markdown supported, use "-" for stdin)
|
|
141
136
|
--rich-text <richText> Rich-text JSON array (mutually exclusive with --content)
|
|
142
|
-
--vault-slug <vaultSlug> Attribute the reply to this vault (sets authorVaultSlug).
|
|
143
|
-
--auto-attachments Upload wiki-linked [[files]] to webdrive before editing (also attributes the reply to that vault)
|
|
137
|
+
--vault-slug <vaultSlug> Attribute the reply to this vault (sets authorVaultSlug).
|
|
144
138
|
-h, --help display help for command
|
|
145
139
|
```
|
|
146
140
|
|
|
@@ -118,11 +118,8 @@ Options:
|
|
|
118
118
|
--title <title> Title of the post
|
|
119
119
|
--content <content> Post content (markdown supported, use "-" for stdin)
|
|
120
120
|
--rich-text <richText> Rich-text JSON array (mutually exclusive with --content)
|
|
121
|
-
--
|
|
122
|
-
--vault-slug <vaultSlug> Attribute the post to this vault (sets authorVaultSlug). Also used as upload destination for --auto-attachments.
|
|
121
|
+
--vault-slug <vaultSlug> Attribute the post to this vault (sets authorVaultSlug). Caller must own the vault.
|
|
123
122
|
--space-slug <spaceSlug> Space slug (overrides .gobi/settings.yaml)
|
|
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
|
|
125
|
-
on draft.metadata so the client can render an 'Open post' button. The draft's vaultSlug seeds --vault-slug when not given explicitly.
|
|
126
123
|
--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: [])
|
|
127
124
|
--repost-post-id <postId> Wrap an existing top-level post as the embedded card on this new post. Composes with --content / --rich-text / --attach (the wrapping author's text + media render above
|
|
128
125
|
the embedded card). Reposts-of-reposts are collapsed to the transitive root server-side. The referenced post must exist, not be deleted, and not itself be a reply.
|
|
@@ -140,8 +137,7 @@ Options:
|
|
|
140
137
|
--title <title> New title for the post
|
|
141
138
|
--content <content> New content for the post (markdown supported, use "-" for stdin)
|
|
142
139
|
--rich-text <richText> Rich-text JSON array (mutually exclusive with --content)
|
|
143
|
-
--
|
|
144
|
-
--vault-slug <vaultSlug> Attribute the post to this vault (sets authorVaultSlug). Also used as upload destination for --auto-attachments.
|
|
140
|
+
--vault-slug <vaultSlug> Attribute the post to this vault (sets authorVaultSlug). Caller must own the vault.
|
|
145
141
|
--space-slug <spaceSlug> Space slug (overrides .gobi/settings.yaml)
|
|
146
142
|
--attach <file> Replace the post's media attachments with the given files (existing attachments are removed). Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size
|
|
147
143
|
ceilings: 5MB photos / 15MB GIFs / 512MB video. Omit to leave attachments unchanged. (default: [])
|
|
@@ -170,8 +166,7 @@ Create a reply to a post in a space.
|
|
|
170
166
|
Options:
|
|
171
167
|
--content <content> Reply content (markdown supported, use "-" for stdin)
|
|
172
168
|
--rich-text <richText> Rich-text JSON array (mutually exclusive with --content)
|
|
173
|
-
--
|
|
174
|
-
--vault-slug <vaultSlug> Attribute the reply to this vault (sets authorVaultSlug). Also used as upload destination for --auto-attachments.
|
|
169
|
+
--vault-slug <vaultSlug> Attribute the reply to this vault (sets authorVaultSlug). Caller must own the vault.
|
|
175
170
|
--space-slug <spaceSlug> Space slug (overrides .gobi/settings.yaml)
|
|
176
171
|
--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:
|
|
177
172
|
[])
|
|
@@ -188,8 +183,7 @@ Edit a reply you authored in a space.
|
|
|
188
183
|
Options:
|
|
189
184
|
--content <content> New content for the reply (markdown supported, use "-" for stdin)
|
|
190
185
|
--rich-text <richText> Rich-text JSON array (mutually exclusive with --content)
|
|
191
|
-
--
|
|
192
|
-
--vault-slug <vaultSlug> Attribute the reply to this vault (sets authorVaultSlug). Also used as upload destination for --auto-attachments.
|
|
186
|
+
--vault-slug <vaultSlug> Attribute the reply to this vault (sets authorVaultSlug). Caller must own the vault.
|
|
193
187
|
--space-slug <spaceSlug> Space slug (overrides .gobi/settings.yaml)
|
|
194
188
|
-h, --help display help for command
|
|
195
189
|
```
|
|
@@ -8,12 +8,12 @@ description: >-
|
|
|
8
8
|
allowed-tools: Bash(gobi:*)
|
|
9
9
|
metadata:
|
|
10
10
|
author: gobi-ai
|
|
11
|
-
version: "2.0.
|
|
11
|
+
version: "2.0.25"
|
|
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.25).
|
|
17
17
|
|
|
18
18
|
Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
|
|
19
19
|
|
|
@@ -42,7 +42,7 @@ gobi --json vault publish
|
|
|
42
42
|
|
|
43
43
|
- `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`).
|
|
44
44
|
- `gobi vault list` — List vaults you own. The primary vault is marked.
|
|
45
|
-
- `gobi vault status` — Show the configured vault's publish state (`isPublished`), profile fields (`title`, `description`, `tags`), referenced files (`thumbnailPath`, `homepagePath`, `promptPath`), file count, and the public profile URL. Use this as a diagnostic before
|
|
45
|
+
- `gobi vault status` — Show the configured vault's publish state (`isPublished`), profile fields (`title`, `description`, `tags`), referenced files (`thumbnailPath`, `homepagePath`, `promptPath`), file count, and the public profile URL. Use this as a diagnostic before authoring a markdown artifact with `--auto-attachments` (see gobi-artifact skill) to confirm the vault is public — files uploaded to a non-public vault are stored on webdrive but are not visible at `gobispace.com/@{vaultSlug}` until you run `gobi vault publish`.
|
|
46
46
|
- `gobi vault create <slug> --name <name>` — Create a new vault with the given slug and display name. Slug must be unique (use `vault list` to see what's taken). Does not change the configured vault — run `vault init` here or `vault set-primary <slug>` afterwards if you want to anchor to it.
|
|
47
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.
|
|
48
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).
|
|
@@ -18,7 +18,7 @@ Commands:
|
|
|
18
18
|
first.
|
|
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
|
-
status [options] Show the configured vault's publish state and metadata (use before
|
|
21
|
+
status [options] Show the configured vault's publish state and metadata (use before authoring a markdown artifact with --auto-attachments to confirm the vault is public).
|
|
22
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.
|
|
@@ -100,7 +100,7 @@ Options:
|
|
|
100
100
|
```
|
|
101
101
|
Usage: gobi vault status [options]
|
|
102
102
|
|
|
103
|
-
Show the configured vault's publish state and metadata (use before
|
|
103
|
+
Show the configured vault's publish state and metadata (use before authoring a markdown artifact with --auto-attachments to confirm the vault is public).
|
|
104
104
|
|
|
105
105
|
Options:
|
|
106
106
|
--vault-slug <vaultSlug> Vault slug to inspect (defaults to .gobi/settings.yaml)
|