@gobi-ai/cli 0.6.19 → 0.7.0

package/.claude-plugin/marketplace.json

@@ -4,12 +4,12 @@
     "name": "gobi-ai"
   },
   "description": "Claude Code plugin for the Gobi collaborative knowledge platform CLI",
-  "version": "0.6.18",
+  "version": "0.6.20",
   "plugins": [
     {
       "name": "gobi",
       "description": "Manage the Gobi collaborative knowledge platform from the command line. Search and ask brains, publish brain documents, create threads, manage sessions.",
-      "version": "0.6.18",
+      "version": "0.6.20",
       "author": {
         "name": "gobi-ai"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "gobi",
   "description": "Manage the Gobi collaborative knowledge platform from the command line",
-  "version": "0.6.18",
+  "version": "0.6.20",
   "author": {
     "name": "gobi-ai"
   },

package/commands/login.md

@@ -0,0 +1,17 @@
+---
+name: login
+description: Log in to Gobi via Google OAuth
+argument-hint: ""
+---
+
+Always use the globally installed `gobi` binary (not via npx or ts-node).
+
+Log the user in to Gobi using device code flow:
+
+1. Run `gobi auth login` as a **background task** (use run_in_background).
+2. Poll the task output every 2 seconds until the login URL appears in stdout.
+3. Extract the URL and display it to the user as a clickable markdown link: `[Click here to log in to Gobi](<url>)`. Also show the user code separately.
+4. Tell the user to open the link in their browser and approve the login.
+5. Continue polling the background task until it exits (success or failure).
+6. On success, confirm the user is now logged in.
+7. On failure, show the error and suggest retrying.

package/commands/logout.md

@@ -0,0 +1,11 @@
+---
+name: logout
+description: Log out of Gobi and remove stored credentials
+argument-hint: ""
+---
+
+Always use the globally installed `gobi` binary (not via npx or ts-node).
+
+Run `gobi auth logout` to log out of Gobi.
+
+Confirm to the user that they have been logged out.

package/commands/space-explore.md

@@ -0,0 +1,20 @@
+---
+name: space-explore
+description: Explore what's happening in the active Gobi space — threads and learnings shared by others.
+argument-hint: "[topic or keyword]"
+---
+
+Always use the globally installed `gobi` binary (not via npx or ts-node).
+
+Explore the active Gobi space to surface discussions, topics, and learnings from others:
+
+1. Run these three commands in parallel:
+   - `gobi --json space list-threads` — recent discussions in the space
+   - `gobi --json space list-topics` — available topics across the platform
+   - `gobi --json brain list-updates` — learnings and brain updates shared by members
+2. Display results in a readable summary, grouped by type (Topics / Discussions / Learnings).
+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.
+4. Ask the user if they'd like to read anything in full:
+   - For a topic: run `gobi space list-topic-threads <topicSlug>` and show the threads.
+   - For a thread: run `gobi space get-thread <threadId>` and show it with replies.
+   - For a brain update: show the full content from the list output.

package/commands/space-share.md

@@ -0,0 +1,45 @@
+---
+name: space-share
+description: Summarize recent learnings from this session and draft a brain update to share to the active Gobi space.
+argument-hint: "[context]"
+---
+
+Always use the globally installed `gobi` binary (not via npx or ts-node).
+
+## Pre-flight check
+
+First, verify the user is warped into a space:
+
+```bash
+gobi --json auth status
+```
+
+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.
+
+## Draft a brain update
+
+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").
+
+Review the conversation history and extract learnings that meet ALL of these criteria:
+- **Reusable**: Other AI agents or developers could apply this knowledge to do better work
+- **Generalizable**: Not specific to a one-off task — patterns, decisions, constraints, or discoveries
+- **Not sensitive**: Exclude code snippets, file paths, PII, personal information, credentials, internal URLs, and proprietary implementation details
+
+Focus on:
+- Architectural decisions and the reasoning behind them
+- Workflow patterns that worked well
+- Constraints or gotchas discovered
+- Tool or API behaviors worth knowing
+- Process improvements
+
+## Present to the user
+
+Format the draft as a short brain update (2–5 bullet points max). Show it to the user and ask for confirmation before posting.
+
+Once confirmed, post it:
+
+```bash
+gobi brain post-update --title "<short title>" --content "<confirmed content>"
+```
+
+Confirm success and show the user the result.

package/commands/warp.md

@@ -0,0 +1,17 @@
+---
+name: warp
+description: Warp to a Gobi space. Pass a space slug to warp directly, or omit to choose from available spaces.
+argument-hint: "[spaceSlug]"
+---
+
+Warp to a Gobi space:
+
+Always use the globally installed `gobi` binary (not npx or ts-node).
+
+- If a space slug is provided as `$ARGUMENTS`, run `gobi space warp $ARGUMENTS` directly.
+- If no argument is given:
+  1. Run `gobi space list` to get available spaces.
+  2. Show the list to the user and ask them to pick one.
+  3. Run `gobi space warp <chosen-slug>` with their selection.
+
+After warping, confirm the active space to the user.

package/dist/commands/space.js

@@ -62,6 +62,70 @@ export function registerSpaceCommand(program) {
         }
         console.log(`Warped to space "${result.name}" (${result.slug})`);
     });
+    // ── Topics ──
+    space
+        .command("list-topics")
+        .description("List topics in a space, ordered by most recent content linkage.")
+        .option("--limit <number>", "Max topics to return (0 = all)", "50")
+        .action(async (opts) => {
+        const spaceSlug = resolveSpaceSlug(space);
+        const params = {
+            limit: parseInt(opts.limit, 10),
+        };
+        const resp = (await apiGet(`/spaces/${spaceSlug}/topics`, params));
+        const items = (resp.data || []);
+        if (isJsonMode(space)) {
+            jsonOut(items);
+            return;
+        }
+        if (!items.length) {
+            console.log("No topics found.");
+            return;
+        }
+        const lines = [];
+        for (const t of items) {
+            const desc = t.description ? ` - ${t.description}` : "";
+            lines.push(`- [${t.slug}] ${t.name}${desc}`);
+        }
+        console.log(`Topics (${items.length}):\n` + lines.join("\n"));
+    });
+    space
+        .command("list-topic-threads <topicSlug>")
+        .description("List threads tagged with a topic in a space (cursor-paginated).")
+        .option("--limit <number>", "Items per page", "20")
+        .option("--cursor <string>", "Pagination cursor from previous response")
+        .action(async (topicSlug, opts) => {
+        const spaceSlug = resolveSpaceSlug(space);
+        const params = {
+            limit: parseInt(opts.limit, 10),
+        };
+        if (opts.cursor)
+            params.cursor = opts.cursor;
+        const resp = (await apiGet(`/spaces/${spaceSlug}/topics/${topicSlug}/threads`, params));
+        const data = unwrapResp(resp);
+        const pagination = (resp.pagination || {});
+        if (isJsonMode(space)) {
+            jsonOut({ ...data, pagination });
+            return;
+        }
+        const topic = (data.topic || {});
+        const threads = (data.threads || []);
+        if (!threads.length) {
+            console.log(`No threads found for topic "${topic.name || topicSlug}".`);
+            return;
+        }
+        const lines = [];
+        for (const t of threads) {
+            const author = t.author?.name || "Unknown";
+            const spaceName = t.space?.name || "";
+            lines.push(`- [${t.id}] "${t.title}" by ${author} in ${spaceName} (${t.replyCount} replies, ${t.createdAt})`);
+        }
+        const footer = pagination.hasMore ? `\n  Next cursor: ${pagination.nextCursor}` : "";
+        console.log(`Topic: ${topic.name || topicSlug}\n` +
+            `Threads (${threads.length} items):\n` +
+            lines.join("\n") +
+            footer);
+    });
     // ── Threads (get, list, create, edit, delete) ──
     space
         .command("get-thread <threadId>")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gobi-ai/cli",
-  "version": "0.6.19",
+  "version": "0.7.0",
   "description": "CLI client for the Gobi collaborative knowledge platform",
   "license": "MIT",
   "type": "module",
@@ -28,7 +28,8 @@
     "dist",
     "!dist/**/*.test.js",
     "skills",
-    ".claude-plugin"
+    ".claude-plugin",
+    "commands"
   ],
   "bin": {
     "gobi": "./dist/index.js"

package/skills/gobi/SKILL.md

@@ -10,12 +10,12 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "0.6.18"
+  version: "0.6.20"
 ---
 
 # gobi-cli
 
-A CLI client for the Gobi collaborative knowledge platform (v0.6.18).
+A CLI client for the Gobi collaborative knowledge platform (v0.6.20).
 
 ## Prerequisites
 
@@ -146,6 +146,8 @@ Note: `--space-slug` is not available on other `brain` subcommands or on `sessio
 - `gobi space` — Space commands (threads, replies).
   - `gobi space list` — List spaces you are a member of.
   - `gobi space warp` — Select the active space. Pass a slug to warp directly, or omit for interactive selection.
+  - `gobi space list-topics` — List topics in a space, ordered by most recent content linkage.
+  - `gobi space list-topic-threads` — List threads tagged with a topic in a space (cursor-paginated).
   - `gobi space get-thread` — Get a thread and its replies (paginated).
   - `gobi space list-threads` — List threads in a space (paginated).
   - `gobi space create-thread` — Create a thread in a space.

package/skills/gobi/references/space.md

@@ -6,21 +6,23 @@ Usage: gobi space [options] [command]
 Space commands (threads, replies).
 
 Options:
-  --space-slug <slug>                Space slug (overrides .gobi/settings.yaml)
-  -h, --help                         display help for command
+  --space-slug <slug>                       Space slug (overrides .gobi/settings.yaml)
+  -h, --help                                display help for command
 
 Commands:
-  list                               List spaces you are a member of.
-  warp [spaceSlug]                   Select the active space. Pass a slug to warp directly, or omit for interactive selection.
-  get-thread [options] <threadId>    Get a thread and its replies (paginated).
-  list-threads [options]             List threads in a space (paginated).
-  create-thread [options]            Create a thread in a space.
-  edit-thread [options] <threadId>   Edit a thread. You must be the author.
-  delete-thread <threadId>           Delete a thread. You must be the author.
-  create-reply [options] <threadId>  Create a reply to a thread 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.
-  help [command]                     display help for command
+  list                                      List spaces you are a member of.
+  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-threads [options] <topicSlug>  List threads tagged with a topic in a space (cursor-paginated).
+  get-thread [options] <threadId>           Get a thread and its replies (paginated).
+  list-threads [options]                    List threads in a space (paginated).
+  create-thread [options]                   Create a thread in a space.
+  edit-thread [options] <threadId>          Edit a thread. You must be the author.
+  delete-thread <threadId>                  Delete a thread. You must be the author.
+  create-reply [options] <threadId>         Create a reply to a thread 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.
+  help [command]                            display help for command
 ```
 
 ## list
@@ -45,6 +47,31 @@ Options:
   -h, --help  display help for command
 ```
 
+## list-topics
+
+```
+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
+```
+
+## list-topic-threads
+
+```
+Usage: gobi space list-topic-threads [options] <topicSlug>
+
+List threads 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
+```
+
 ## get-thread
 
 ```