@gobi-ai/cli 0.6.20 → 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.19",
+  "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.19",
+      "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.19",
+  "version": "0.6.20",
   "author": {
     "name": "gobi-ai"
   },

package/commands/space-explore.md

@@ -6,13 +6,15 @@ 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 both discussions and learnings from others:
+Explore the active Gobi space to surface discussions, topics, and learnings from others:
 
-1. Run these two commands in parallel:
-   - `gobi space list-threads` — recent discussions in the space
-   - `gobi brain list-updates` — learnings and brain updates shared by members
-2. Display both in a readable summary, grouped by type (Discussions / Learnings).
-3. If `$ARGUMENTS` is provided, filter or highlight entries relevant to that topic or keyword.
+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/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.20",
+  "version": "0.7.0",
   "description": "CLI client for the Gobi collaborative knowledge platform",
   "license": "MIT",
   "type": "module",

package/skills/gobi/SKILL.md

@@ -10,12 +10,12 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "0.6.19"
+  version: "0.6.20"
 ---
 
 # gobi-cli
 
-A CLI client for the Gobi collaborative knowledge platform (v0.6.19).
+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
 
 ```