@gobi-ai/cli 2.0.36 → 2.0.40

package/.claude-plugin/marketplace.json

@@ -4,12 +4,12 @@
     "name": "gobi-ai"
   },
   "description": "Claude Code plugin for the Gobi collaborative knowledge platform CLI",
-  "version": "2.0.36",
+  "version": "2.0.40",
   "plugins": [
     {
       "name": "gobi",
       "description": "Manage the Gobi collaborative knowledge platform from the command line. Publish vault profiles, create posts and replies, generate images and videos.",
-      "version": "2.0.36",
+      "version": "2.0.40",
       "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": "2.0.36",
+  "version": "2.0.40",
   "author": {
     "name": "gobi-ai"
   },

package/README.md

@@ -53,9 +53,9 @@ gobi vault publish
 # Sync local files with the webdrive
 gobi vault sync
 
-# Browse the global feed and create a personal post
-gobi global feed
-gobi global create-post --title "Hello" --content "Trying gobi"
+# Browse your personal feed and create a private post
+gobi personal feed
+gobi personal create-post --title "Hello" --content "Trying gobi"
 ```
 
 Each setup step unlocks a different family of commands — run only the ones the workflow needs:
@@ -74,7 +74,7 @@ Everything below applies whether you're building a Claude Code skill, an autonom
 
 ### JSON envelope
 
-Pass `--json` as a **global flag** (before the subcommand) and every command returns a structured envelope:
+Pass `--json` as a **top-level flag** (before the subcommand) and every command returns a structured envelope:
 
 ```sh
 gobi --json space list-posts
@@ -165,7 +165,7 @@ Public vaults are accessible at `https://gobispace.com/@{vaultSlug}`.
 
 ### Spaces
 
-A *Space* is a community knowledge area. A *Space Post* lives in one space. The same `Post` data type, in a different scope, is a *Personal Post* (see Global feed below) — so anything you can do to a Space Post you can do to a Personal Post.
+A *Space* is a community knowledge area. A *Space Post* lives in one space. The same `Post` data type, in a different scope, is a private *personal-space post* (see Personal space below) — so anything you can do to a Space Post you can do to a personal-space post.
 
 > Space and member administration (creating spaces, inviting/approving members, joining/leaving) is web-UI only and not available in the CLI.
 
@@ -184,50 +184,41 @@ A *Space* is a community knowledge area. A *Space Post* lives in one space. The
 | `gobi space edit-reply <replyId> [--content <c>] [--rich-text <json>]` | Edit a reply you authored. |
 | `gobi space delete-reply <replyId>` | Delete a reply you authored |
 
-### Global feed (personal posts)
-
-A *Personal Post* surfaces in the public global feed. Same `Post` model as a Space Post, scoped to the user instead of a space.
-
-| Command | Description |
-|---------|-------------|
-| `gobi global feed [--following]` | List the global public feed (posts + replies, newest first). `--following` limits to authors you follow. |
-| `gobi global list-posts [--mine]` | List personal posts; filter to your own |
-| `gobi global get-post <postId> [--full]` | Get a personal post with its ancestors and replies. `--full` shows reply content without truncation. |
-| `gobi global create-post [--title <t>] (--content <c> \| --rich-text <json>) [--artifact <artifactId>]… [--repost-post-id <id>] [--attach <file>]…` | Create a personal post. `--artifact` attaches an existing artifact to the post (repeatable). `--repost-post-id` reposts an existing post. `--attach` uploads local media for inline rendering (see `gobi space create-post` above for the mix rule). |
-| `gobi global edit-post <postId> [--title <t>] [--content <c>]` | Edit a personal post you authored. |
-| `gobi global delete-post <postId>` | Delete a personal post you authored |
-| `gobi global create-reply <postId> (--content <c> \| --rich-text <json>) [--attach <file>]…` | Create a reply to a personal post |
-| `gobi global edit-reply <replyId> [--content <c>] [--rich-text <json>]` | Edit a reply you authored. |
-| `gobi global delete-reply <replyId>` | Delete a reply you authored |
-
 ### Personal space (private posts)
 
-> Naming note: a **Personal Post** (under `gobi global`, above) is the public-feed kind — it lives on your vault profile and surfaces on the global feed. A **personal-space post** (this section, under `gobi personal`) is the private kind — same `Post` data model, but scoped via `personalSpaceUserId` so only you can see it.
-
-Private posts and replies visible only to you. Same `Post` data model and subcommand shape as `gobi global`, but scoped to a personal space — they never appear on the public global feed.
+Private posts and replies visible only to you. Same `Post` data model and subcommand shape as a Space Post, but scoped to a personal space — they never appear in any public feed.
 
 | Command | Description |
 |---------|-------------|
 | `gobi personal feed` | Your personal-space feed (posts + replies, newest first) |
 | `gobi personal list-posts` | List personal-space posts |
 | `gobi personal get-post <postId> [--full]` | Get a personal-space post with its ancestors and replies |
-| `gobi personal create-post [--title <t>] (--content <c> \| --rich-text <json>) [--artifact <artifactId>]… [--repost-post-id <id>] [--attach <file>]…` | Create a private post in your personal space. `--artifact` attaches an existing artifact to the post (repeatable). `--attach` works the same as on `gobi global create-post`. |
+| `gobi personal create-post [--title <t>] (--content <c> \| --rich-text <json>) [--artifact <artifactId>]… [--repost-post-id <id>] [--attach <file>]…` | Create a private post in your personal space. `--artifact` attaches an existing artifact to the post (repeatable). `--attach` works the same as on `gobi space create-post`. |
 | `gobi personal edit-post <postId> [--title <t>] [--content <c>]` | Edit a personal-space post you authored |
 | `gobi personal delete-post <postId>` | Delete a personal-space post you authored |
 | `gobi personal create-reply <postId> (--content <c> \| --rich-text <json>) [--attach <file>]…` | Reply to a personal-space post (inherits the parent's private scope) |
 | `gobi personal edit-reply <replyId> [--content <c>] [--rich-text <json>]` | Edit a reply you authored |
 | `gobi personal delete-reply <replyId>` | Delete a reply you authored |
 
-### Sense
+### Sense (activities & conversations)
+
+Activity and conversation data captured by Gobi Sense (the wearable) and the mobile app, then ingested by the cloud pipeline. Read-only. See the `gobi-sense` skill for full workflows.
+
+Like posts and artifacts, Sense data is **scoped to a space**: the subcommands live under `gobi personal …` (your personal space) and `gobi space …` (the active team space — `gobi space warp <slug>` or `gobi space --space-slug <slug> …`). `<scope>` below is `personal` or `space`.
 
-Activity and transcription data captured by Gobi Sense (or the mobile app).
+- **activities** — what you were doing (category + details, start/end times). In a team space, every member's activities show up, attributed to their recorder.
+- **conversations** — phone-mic Audio Logs plus Sense-detected conversations, each with a transcript and auto-generated summary. In a team space, every member's conversations show up, attributed to their recorder (transcript/audio stay owner-only). (This replaces the old `list-transcriptions` — transcriptions were unified into conversations.)
 
 | Command | Description |
 |---------|-------------|
-| `gobi sense list-activities --start-time <iso> --end-time <iso>` | List activity records in a time range |
-| `gobi sense list-transcriptions --start-time <iso> --end-time <iso>` | List transcription records in a time range |
+| `gobi <scope> activities list [--limit N] [--before <cursor>] [--mine]` | List Sense activities in this scope (newest first) |
+| `gobi <scope> activities get <activityId>` | Get one activity's details |
+| `gobi <scope> activities transcript <activityId>` | Get an activity's transcript (owner-only) |
+| `gobi <scope> conversations list [--limit N] [--before <cursor>] [--mine]` | List conversations captured in this scope (newest first) |
+| `gobi <scope> conversations transcript <conversationId>` | Get a conversation's transcript and summary |
+| `gobi <scope> conversations audio <conversationId>` | Get a signed URL for the recording (owner-only) |
 
-Times are ISO 8601 UTC (e.g. `2026-03-20T00:00:00Z`).
+`gobi space …` lists are a complete, fully-paginated per-space history (every member's records); add `--mine` to restrict either `list` to records you recorded. `gobi personal conversations list` is filtered from the cross-scope conversations feed, so it shows your recent personal conversations rather than a fully paginated history (`gobi personal activities list` is fully paginated).
 
 ### Artifacts
 
@@ -268,7 +259,7 @@ Image, video, and avatar generation. See the `gobi-media` skill for full workflo
 | `gobi media list-videos` / `gobi media get-video <id>` | List or get videos |
 | `gobi media upload <file>` | Upload a local file and get a media id |
 
-### Global options
+### Top-level options
 
 | Option | Scope | Description |
 |--------|-------|-------------|
@@ -304,10 +295,10 @@ The CLI ships a `.claude-plugin/` manifest with skills that wrap the command gro
 |-------|--------|
 | `gobi-core` | Auth, update, space list/warp |
 | `gobi-vault` | `gobi vault init/list/publish/unpublish/sync` |
-| `gobi-space` | `gobi space …`, `gobi global …`, and `gobi personal …` |
+| `gobi-space` | `gobi space …` and `gobi personal …` |
 | `gobi-artifact` | `gobi personal artifact …` and `gobi space artifact …` |
 | `gobi-media` | `gobi media …` |
-| `gobi-sense` | `gobi sense list-activities/list-transcriptions` |
+| `gobi-sense` | `gobi personal activities/conversations …` and `gobi space activities/conversations …` |
 | `gobi-homepage` | Building custom HTML homepages with `window.gobi` |
 
 Each skill's `SKILL.md` is hand-written orientation; `references/` is regenerated from `--help` output by `npm run generate-skill-docs`.

package/commands/login.md

@@ -4,7 +4,7 @@ description: Log in to Gobi via Google OAuth
 argument-hint: ""
 ---
 
-Always use the globally installed `gobi` binary (not via npx or ts-node).
+Always use the installed `gobi` binary on your PATH (not via npx or ts-node).
 
 Log the user in to Gobi using device code flow:
 

package/commands/logout.md

@@ -4,7 +4,7 @@ description: Log out of Gobi and remove stored credentials
 argument-hint: ""
 ---
 
-Always use the globally installed `gobi` binary (not via npx or ts-node).
+Always use the installed `gobi` binary on your PATH (not via npx or ts-node).
 
 Run `gobi auth logout` to log out of Gobi.
 

package/commands/post.md

@@ -5,7 +5,7 @@ argument-hint: "[approval|bypass]"
 disable-model-invocation: true
 ---
 
-Always use the globally installed `gobi` binary (not via npx or ts-node).
+Always use the installed `gobi` binary on your PATH (not via npx or ts-node).
 
 ## Argument: permissionMode
 

package/commands/space-explore.md

@@ -4,17 +4,15 @@ description: Explore what's happening in the active Gobi space — posts and lea
 argument-hint: "[topic or keyword]"
 ---
 
-Always use the globally installed `gobi` binary (not via npx or ts-node).
+Always use the installed `gobi` binary on your PATH (not via npx or ts-node).
 
 Explore the active Gobi space to surface posts, topics, and learnings from others:
 
-1. Run these three commands in parallel:
+1. Run these two commands in parallel:
    - `gobi --json space list-posts` — recent posts in the space
    - `gobi --json space list-topics` — available topics in the space
-   - `gobi --json global feed` — recent posts and replies shared by members across the platform
-2. Display results in a readable summary, grouped by type (Topics / Space posts / Global feed).
+2. Display results in a readable summary, grouped by type (Topics / Space posts).
 3. If `$ARGUMENTS` is provided, filter or highlight entries relevant to that topic or keyword. If a matching topic is found, also run `gobi --json space list-topic-posts <topicSlug>` to show posts tagged with that topic.
 4. Ask the user if they'd like to read anything in full:
    - For a topic: run `gobi space list-topic-posts <topicSlug>` and show the posts.
    - For a space post: run `gobi space get-post <postId>` and show it with ancestors and replies.
-   - For a global feed post: run `gobi global get-post <postId>` to show it with ancestors and replies.

package/commands/space-share.md

@@ -1,10 +1,10 @@
 ---
 name: space-share
-description: Summarize recent learnings from this session and draft a personal post to share to the global feed.
+description: Summarize recent learnings from this session and draft a post to share to a Gobi space.
 argument-hint: "[context]"
 ---
 
-Always use the globally installed `gobi` binary (not via npx or ts-node).
+Always use the installed `gobi` binary on your PATH (not via npx or ts-node).
 
 ## Pre-flight check
 
@@ -16,7 +16,7 @@ gobi --json auth status
 
 Check that `.gobi/settings.yaml` exists. If you plan to publish to a Space (`gobi space create-post`), it must contain `selectedSpaceSlug` — otherwise stop and ask the user to run `gobi space warp` first.
 
-## Draft a personal post
+## Draft a post
 
 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").
 
@@ -36,16 +36,16 @@ Focus on:
 
 Format the draft as a short post (2–5 bullet points max). Show it to the user and ask for confirmation before posting.
 
-Once confirmed, post it to the global feed:
+Once confirmed, post it to the active space:
 
 ```bash
-gobi global create-post --title "<short title>" --content "<confirmed content>"
+gobi space create-post --title "<short title>" --content "<confirmed content>"
 ```
 
-Or to the active space:
+Or keep it private in your personal space:
 
 ```bash
-gobi space create-post --title "<short title>" --content "<confirmed content>"
+gobi personal create-post --title "<short title>" --content "<confirmed content>"
 ```
 
 Confirm success and show the user the result.

package/commands/warp.md

@@ -6,7 +6,7 @@ argument-hint: "[spaceSlug]"
 
 Warp to a Gobi space:
 
-Always use the globally installed `gobi` binary (not npx or ts-node).
+Always use the installed `gobi` binary on your PATH (not npx or ts-node).
 
 - If a space slug is provided as `$ARGUMENTS`, run `gobi space warp $ARGUMENTS` directly.
 - If no argument is given:

package/dist/commands/personal.js

@@ -2,6 +2,7 @@ import { apiGet, apiPost, apiPatch, apiPut, apiDelete } from "../client.js";
 import { buildMentionMap, formatAttachmentLines, formatAttachmentSummary, formatPostLabel, formatReactionChips, formatReplyLine, isJsonMode, jsonOut, postBodyText, readStdin, unwrapResp, } from "./utils.js";
 import { uploadPostAttachments, assertPostAttachmentMix, } from "../attachments.js";
 import { registerArtifactSubcommands } from "./artifact.js";
+import { registerActivitiesSubcommands, registerConversationsSubcommands, } from "./sense.js";
 function readContent(value) {
     if (value === "-")
         return readStdin();
@@ -32,8 +33,8 @@ export function registerPersonalCommand(program) {
     const personal = program
         .command("personal")
         .description("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 never surface on the public feed.");
+        "Posts/replies live in the same data model as space posts, scoped via " +
+        "personalSpaceUserId so they never surface on the public feed.");
     // ── Feed (unified) ──
     personal
         .command("feed")
@@ -165,13 +166,13 @@ export function registerPersonalCommand(program) {
     });
     // ── Get post (with ancestors and replies) ──
     //
-    // Same `/posts/:id` and `/posts/:id/ancestors` routes the global command
-    // uses — the server gates these by `viewerUserId`, so private rows
-    // resolve for the owner and 404 for everyone else. Personal-space posts
-    // and global posts share this endpoint without ambiguity.
+    // The shared `/posts/:id` and `/posts/:id/ancestors` routes — the server
+    // gates these by `viewerUserId`, so private rows resolve for the owner and
+    // 404 for everyone else. Personal-space and public posts share this
+    // endpoint without ambiguity.
     personal
         .command("get-post <postId>")
-        .description("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.")
+        .description("Get a personal-space post with its ancestors and replies (paginated). Only the owner can resolve a private id.")
         .option("--limit <number>", "Items per page", "20")
         .option("--cursor <string>", "Pagination cursor from previous response")
         .option("--full", "Show full reply content without truncation")
@@ -245,8 +246,8 @@ export function registerPersonalCommand(program) {
     // ── Create post ──
     //
     // Targets `POST /posts/personal-space`, the only endpoint that stamps
-    // `personalSpaceUserId` on the row. Body shape is identical to the
-    // global `POST /posts` create (same CreatePostDto). The server skips the
+    // `personalSpaceUserId` on the row. Body shape is identical to the public
+    // `POST /posts` create (same CreatePostDto). The server skips the
     // `@gobi` mention dispatch and the notification fan-out for this lane —
     // private posts have no audience.
     personal
@@ -257,7 +258,7 @@ export function registerPersonalCommand(program) {
         .option("--rich-text <richText>", "Rich-text JSON array (mutually exclusive with --content)")
         .option("--artifact <artifactId>", "Attach an existing artifact to the post (repeatable). Create artifacts with `gobi personal artifact create`.", (value, prev = []) => [...prev, value], [])
         .option("--attach <file>", "Local media or document file to attach. Repeatable. Mix rule: up to 4 photos + up to 4 document files (pdf/md/txt/csv) OR 1 GIF OR 1 video. Size ceilings: 10MB photos / 15MB GIFs / 512MB video / 250MB files.", (value, prev = []) => [...prev, value], [])
-        .option("--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 post, or a post in a space you're a member of). Reposting someone else's personal-space post returns 404.")
+        .option("--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 public post, or a post in a space you're a member of). Reposting someone else's personal-space post returns 404.")
         .action(async (opts) => {
         // A post is substantive if it has a text body OR carries an attachment
         // (artifact card / media) OR embeds a repost. Only block the truly empty
@@ -315,9 +316,9 @@ export function registerPersonalCommand(program) {
     });
     // ── Edit post ──
     //
-    // Same `PATCH /posts/:postId` route the global command uses — the server
-    // gates on `authorId === userId` and the read-path guard runs first, so
-    // a non-owner can't edit (or even discover) a private post.
+    // The shared `PATCH /posts/:postId` route — the server gates on
+    // `authorId === userId` and the read-path guard runs first, so a non-owner
+    // can't edit (or even discover) a private post.
     personal
         .command("edit-post <postId>")
         .description("Edit a post you authored in your personal space.")
@@ -385,8 +386,8 @@ export function registerPersonalCommand(program) {
     //
     // `POST /posts/:postId/replies` inherits scope from the parent on the
     // server — reply to a personal-space parent → reply is scoped to that
-    // personal space. The same command works for global and personal; we
-    // expose it here for discoverability/symmetry with `gobi global`.
+    // personal space. The same server route backs space and personal replies;
+    // we expose it here for discoverability under `gobi personal`.
     personal
         .command("create-reply <postId>")
         .description("Reply to a personal-space post. The reply inherits the parent's private scope automatically.")
@@ -505,4 +506,27 @@ export function registerPersonalCommand(program) {
     registerArtifactSubcommands(personal, { resolve: () => ({}) }, "Versioned creations attached to posts, scoped to your personal space (visible " +
         "only to you). Kinds: image | video | gif | markdown | meeting_summary. Always " +
         "human-owned; revisions form a draft/published tree (one published per artifact).");
+    // ── Sense: activities + conversations (scoped to your personal space) ──
+    const senseScope = {
+        label: "personal",
+        listActivities: async (params) => {
+            const resp = (await apiGet("/app/activities", params));
+            return {
+                items: (resp.activities || []),
+                pagination: resp.pagination,
+            };
+        },
+        // `/app/conversations` spans all the user's scopes (newest ~50, no paging);
+        // filter to the personal scope (spaceId 0). Params are ignored — the endpoint
+        // takes none.
+        listConversations: async () => {
+            const resp = (await apiGet("/app/conversations"));
+            const all = (resp.conversations || []);
+            return { items: all.filter((c) => Number(c.spaceId ?? 0) === 0) };
+        },
+    };
+    registerActivitiesSubcommands(personal, senseScope, "Your personal Sense activities (what you were doing, from the wearable/app), " +
+        "browse-only. Recorded in your personal space (visible only to you).");
+    registerConversationsSubcommands(personal, senseScope, "Your personal Sense conversations (phone-mic Audio Logs + detected conversations), " +
+        "browse-only. Recorded in your personal space (visible only to you).");
 }