@gobi-ai/cli 1.3.0 → 1.3.2

package/.claude-plugin/marketplace.json

@@ -4,12 +4,12 @@
     "name": "gobi-ai"
   },
   "description": "Claude Code plugin for the Gobi collaborative knowledge platform CLI",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "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, generate images and videos.",
-      "version": "1.3.0",
+      "version": "1.3.2",
       "author": {
         "name": "gobi-ai"
       },
@@ -20,6 +20,7 @@
         "./skills/gobi-space",
         "./skills/gobi-brain",
         "./skills/gobi-feed",
+        "./skills/gobi-notes",
         "./skills/gobi-media",
         "./skills/gobi-sense",
         "./skills/gobi-homepage"

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "gobi",
   "description": "Manage the Gobi collaborative knowledge platform from the command line",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "author": {
     "name": "gobi-ai"
   },
@@ -11,6 +11,7 @@
     "./skills/gobi-space",
     "./skills/gobi-brain",
     "./skills/gobi-feed",
+    "./skills/gobi-notes",
     "./skills/gobi-media",
     "./skills/gobi-sense",
     "./skills/gobi-homepage"

package/README.md

@@ -137,6 +137,19 @@ Public brains are accessible at `https://gobispace.com/@{vaultSlug}`.
 
 Times are ISO 8601 UTC (e.g. `2026-03-20T00:00:00Z`).
 
+### Notes
+
+| Command | Description |
+|---------|-------------|
+| `gobi notes list [--date YYYY-MM-DD]` | List your notes (recent via cursor, or all for a day) |
+| `gobi notes get <id>` | Get a single note |
+| `gobi notes create --content <c>` | Create a note (use `-` to read content from stdin) |
+| `gobi notes edit <id> [--content <c>] [--agent-id <id>]` | Edit a note (at least one required; `--agent-id null` clears the link) |
+| `gobi notes delete <id>` | Delete a note you authored |
+
+`notes list` and `notes create` accept `--timezone <iana>` (default: system timezone) for day boundaries.
+`notes list` also accepts `--limit`/`--cursor` for pagination.
+
 ### Sync
 
 | Command | Description |

package/dist/commands/feed.js

@@ -22,6 +22,7 @@ export function registerFeedCommand(program) {
             jsonOut({
                 items: resp.data || [],
                 pagination: resp.pagination || {},
+                mentions: resp.mentions || {},
             });
             return;
         }
@@ -63,8 +64,9 @@ export function registerFeedCommand(program) {
         const resp = (await apiGet(`/feed/${updateId}`, params));
         const data = unwrapResp(resp);
         const pagination = (resp.pagination || {});
+        const mentions = (resp.mentions || {});
         if (isJsonMode(feed)) {
-            jsonOut({ ...data, pagination });
+            jsonOut({ ...data, pagination, mentions });
             return;
         }
         const update = (data.update || data);
@@ -107,8 +109,9 @@ export function registerFeedCommand(program) {
             content,
         }));
         const reply = unwrapResp(resp);
+        const mentions = (resp.mentions || {});
         if (isJsonMode(feed)) {
-            jsonOut(reply);
+            jsonOut({ ...reply, mentions });
             return;
         }
         console.log(`Reply created!\n  ID: ${reply.id}\n  Created: ${reply.createdAt}`);

package/dist/commands/notes.js

@@ -0,0 +1,153 @@
+import { readFileSync } from "fs";
+import { apiGet, apiPost, apiPatch, apiDelete } from "../client.js";
+import { isJsonMode, jsonOut, unwrapResp } from "./utils.js";
+function defaultTimezone() {
+    return Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC";
+}
+function formatNoteLine(note) {
+    const content = note.content ?? "";
+    const snippet = content
+        ? content.length > 80
+            ? content.slice(0, 80) + "…"
+            : content
+        : "(no content)";
+    const attachments = (note.attachments || []);
+    const attachStr = attachments.length
+        ? `, ${attachments.length} ${attachments.length === 1 ? "attachment" : "attachments"}`
+        : "";
+    const agent = note.agentId != null ? `, agent: ${note.agentId}` : "";
+    return `- [${note.id}] "${snippet.replace(/\n/g, " ")}" (${note.eventDate}${agent}${attachStr}, updated ${note.updatedAt})`;
+}
+export function registerNotesCommand(program) {
+    const notes = program
+        .command("notes")
+        .description("Personal notes (create, list, get, edit, delete).");
+    // ── List ──
+    notes
+        .command("list")
+        .description("List your notes. Without --date, returns recent notes via cursor pagination. With --date, returns all notes for that day.")
+        .option("--date <date>", "Filter to a single day (YYYY-MM-DD)")
+        .option("--timezone <tz>", "IANA timezone name (default: system timezone)")
+        .option("--limit <number>", "Items per page (1-100)", "50")
+        .option("--cursor <string>", "Pagination cursor from previous response")
+        .action(async (opts) => {
+        const params = {
+            timezone: opts.timezone || defaultTimezone(),
+            limit: parseInt(opts.limit, 10),
+        };
+        if (opts.date)
+            params.date = opts.date;
+        if (opts.cursor)
+            params.cursor = opts.cursor;
+        const resp = (await apiGet(`/app/notes`, params));
+        const items = (resp.data || []);
+        const pagination = (resp.pagination || {});
+        if (isJsonMode(notes)) {
+            jsonOut({ items, pagination });
+            return;
+        }
+        if (!items.length) {
+            console.log("No notes found.");
+            return;
+        }
+        const lines = items.map(formatNoteLine);
+        const footer = pagination.hasMore
+            ? `\n  Next cursor: ${pagination.nextCursor}`
+            : "";
+        console.log(`Notes (${items.length} items):\n` + lines.join("\n") + footer);
+    });
+    // ── Get ──
+    notes
+        .command("get <noteId>")
+        .description("Get a single note by id.")
+        .action(async (noteId) => {
+        const resp = (await apiGet(`/app/notes/${noteId}`));
+        const note = unwrapResp(resp);
+        if (isJsonMode(notes)) {
+            jsonOut(note);
+            return;
+        }
+        const attachments = (note.attachments || []);
+        const attachLines = attachments.map((a) => `  - [${a.id}] ${a.mediaUrl} (position ${a.position})`);
+        const agentLine = note.agentId != null ? `Agent: ${note.agentId}\n` : "";
+        const output = [
+            `Note: ${note.id}`,
+            `Date: ${note.eventDate}`,
+            `Created: ${note.createdAt}`,
+            `Updated: ${note.updatedAt}`,
+            agentLine.trimEnd(),
+            "",
+            note.content || "(no content)",
+            ...(attachLines.length ? ["", `Attachments (${attachLines.length}):`, ...attachLines] : []),
+        ]
+            .filter((line) => line !== "")
+            .concat([""])
+            .join("\n")
+            .trimEnd();
+        console.log(output);
+    });
+    // ── Create ──
+    notes
+        .command("create")
+        .description("Create a note. Provide --content (use '-' for stdin) and/or attachments.")
+        .option("--content <content>", 'Note content (markdown supported, use "-" for stdin)')
+        .option("--timezone <tz>", "IANA timezone name (default: system timezone)")
+        .option("--agent-id <number>", "Optional agent id to associate with the note")
+        .action(async (opts) => {
+        if (!opts.content) {
+            throw new Error("--content is required (use '-' to read from stdin)");
+        }
+        const content = opts.content === "-" ? readFileSync("/dev/stdin", "utf8") : opts.content;
+        const body = {
+            content,
+            timezone: opts.timezone || defaultTimezone(),
+        };
+        if (opts.agentId)
+            body.agentId = parseInt(opts.agentId, 10);
+        const resp = (await apiPost(`/app/notes`, body));
+        const note = unwrapResp(resp);
+        if (isJsonMode(notes)) {
+            jsonOut(note);
+            return;
+        }
+        console.log(`Note created!\n  ID: ${note.id}\n  Date: ${note.eventDate}\n  Created: ${note.createdAt}`);
+    });
+    // ── Edit ──
+    notes
+        .command("edit <noteId>")
+        .description("Edit a note. Provide --content and/or --agent-id.")
+        .option("--content <content>", 'New note content (markdown supported, use "-" for stdin)')
+        .option("--agent-id <number>", 'New agent id, or "null" to clear the association')
+        .action(async (noteId, opts) => {
+        if (opts.content == null && opts.agentId == null) {
+            throw new Error("Provide at least --content or --agent-id to update.");
+        }
+        const body = {};
+        if (opts.content != null) {
+            body.content =
+                opts.content === "-" ? readFileSync("/dev/stdin", "utf8") : opts.content;
+        }
+        if (opts.agentId != null) {
+            body.agentId = opts.agentId === "null" ? null : parseInt(opts.agentId, 10);
+        }
+        const resp = (await apiPatch(`/app/notes/${noteId}`, body));
+        const note = unwrapResp(resp);
+        if (isJsonMode(notes)) {
+            jsonOut(note);
+            return;
+        }
+        console.log(`Note edited!\n  ID: ${note.id}\n  Updated: ${note.updatedAt}`);
+    });
+    // ── Delete ──
+    notes
+        .command("delete <noteId>")
+        .description("Delete a note you authored.")
+        .action(async (noteId) => {
+        await apiDelete(`/app/notes/${noteId}`);
+        if (isJsonMode(notes)) {
+            jsonOut({ id: noteId });
+            return;
+        }
+        console.log(`Note ${noteId} deleted.`);
+    });
+}

package/dist/commands/space.js

@@ -142,8 +142,9 @@ export function registerSpaceCommand(program) {
         const resp = (await apiGet(`/spaces/${spaceSlug}/threads/${threadId}`, params));
         const data = unwrapResp(resp);
         const pagination = (resp.pagination || {});
+        const mentions = (resp.mentions || {});
         if (isJsonMode(space)) {
-            jsonOut({ ...data, pagination });
+            jsonOut({ ...data, pagination, mentions });
             return;
         }
         const thread = (data.thread || data);
@@ -187,6 +188,7 @@ export function registerSpaceCommand(program) {
             jsonOut({
                 items: resp.data || [],
                 pagination: resp.pagination || {},
+                mentions: resp.mentions || {},
             });
             return;
         }
@@ -292,8 +294,9 @@ export function registerSpaceCommand(program) {
         const spaceSlug = resolveSpaceSlug(space);
         const resp = (await apiPost(`/spaces/${spaceSlug}/threads/${threadId}/replies`, { content: readContent(opts.content) }));
         const msg = unwrapResp(resp);
+        const mentions = (resp.mentions || {});
         if (isJsonMode(space)) {
-            jsonOut(msg);
+            jsonOut({ ...msg, mentions });
             return;
         }
         console.log(`Reply created!\n  ID: ${msg.id}\n  Created: ${msg.createdAt}`);

package/dist/main.js

@@ -7,6 +7,7 @@ import { registerInitCommand, printContext } from "./commands/init.js";
 import { registerSpaceCommand } from "./commands/space.js";
 import { registerBrainCommand } from "./commands/brain.js";
 import { registerFeedCommand } from "./commands/feed.js";
+import { registerNotesCommand } from "./commands/notes.js";
 import { registerSessionsCommand } from "./commands/sessions.js";
 import { registerSenseCommand } from "./commands/sense.js";
 import { registerSyncCommand } from "./commands/sync.js";
@@ -35,6 +36,7 @@ export async function cli() {
     registerSpaceCommand(program);
     registerBrainCommand(program);
     registerFeedCommand(program);
+    registerNotesCommand(program);
     registerSessionsCommand(program);
     registerSenseCommand(program);
     registerSyncCommand(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gobi-ai/cli",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "CLI client for the Gobi collaborative knowledge platform",
   "license": "MIT",
   "type": "module",

package/skills/gobi-feed/SKILL.md

@@ -8,12 +8,12 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "1.3.0"
+  version: "1.3.1"
 ---
 
 # gobi-feed
 
-Gobi feed commands for the global brain-update feed (v1.3.0).
+Gobi feed commands for the global brain-update feed (v1.3.1).
 
 Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
 

package/skills/gobi-notes/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: gobi-notes
+description: >-
+  Gobi notes commands for personal note-taking: create, list (by day or
+  cursor), get, edit, and delete notes. Notes are private, dated entries
+  optionally tied to an agent. Use when the user wants to capture, review,
+  or modify their own notes.
+allowed-tools: Bash(gobi:*)
+metadata:
+  author: gobi-ai
+  version: "1.3.2"
+---
+
+# gobi-notes
+
+Gobi notes commands for personal note-taking (v1.3.2).
+
+Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
+
+## What is a note?
+
+A note is a private, dated entry you keep for yourself. Each note has:
+- **content** — markdown text (optional if attachments are present, but the CLI requires `--content` since it doesn't yet upload attachments)
+- **eventDate** — derived from your timezone at create time, used to group notes by day
+- **agentId** — optional association with a Gobi agent
+
+Notes are user-private — only you can see, edit, or delete your own notes.
+
+## Timezone
+
+`gobi notes list` and `gobi notes create` need a timezone to compute the calendar day. The CLI auto-detects your system timezone via `Intl.DateTimeFormat().resolvedOptions().timeZone`. Override with `--timezone <iana-name>` (e.g. `America/Los_Angeles`).
+
+## Important: JSON Mode
+
+For programmatic/agent usage, always pass `--json` as a **global** option (before the subcommand):
+
+```bash
+gobi --json notes list --date 2026-04-27
+```
+
+## Available Commands
+
+- `gobi notes` — Personal notes (create, list, get, edit, delete).
+  - `gobi notes list` — List your notes. Without --date, returns recent notes via cursor pagination. With --date, returns all notes for that day.
+  - `gobi notes get` — Get a single note by id.
+  - `gobi notes create` — Create a note. Provide --content (use '-' for stdin) and/or attachments.
+  - `gobi notes edit` — Edit a note. Provide --content and/or --agent-id.
+  - `gobi notes delete` — Delete a note you authored.
+
+## Reference Documentation
+
+- [gobi notes](references/notes.md)

package/skills/gobi-notes/references/notes.md

@@ -0,0 +1,82 @@
+# gobi notes
+
+```
+Usage: gobi notes [options] [command]
+
+Personal notes (create, list, get, edit, delete).
+
+Options:
+  -h, --help               display help for command
+
+Commands:
+  list [options]           List your notes. Without --date, returns recent notes via cursor pagination. With --date, returns all notes for that day.
+  get <noteId>             Get a single note by id.
+  create [options]         Create a note. Provide --content (use '-' for stdin) and/or attachments.
+  edit [options] <noteId>  Edit a note. Provide --content and/or --agent-id.
+  delete <noteId>          Delete a note you authored.
+  help [command]           display help for command
+```
+
+## list
+
+```
+Usage: gobi notes list [options]
+
+List your notes. Without --date, returns recent notes via cursor pagination. With --date, returns all notes for that day.
+
+Options:
+  --date <date>      Filter to a single day (YYYY-MM-DD)
+  --timezone <tz>    IANA timezone name (default: system timezone)
+  --limit <number>   Items per page (1-100) (default: "50")
+  --cursor <string>  Pagination cursor from previous response
+  -h, --help         display help for command
+```
+
+## get
+
+```
+Usage: gobi notes get [options] <noteId>
+
+Get a single note by id.
+
+Options:
+  -h, --help  display help for command
+```
+
+## create
+
+```
+Usage: gobi notes create [options]
+
+Create a note. Provide --content (use '-' for stdin) and/or attachments.
+
+Options:
+  --content <content>  Note content (markdown supported, use "-" for stdin)
+  --timezone <tz>      IANA timezone name (default: system timezone)
+  --agent-id <number>  Optional agent id to associate with the note
+  -h, --help           display help for command
+```
+
+## edit
+
+```
+Usage: gobi notes edit [options] <noteId>
+
+Edit a note. Provide --content and/or --agent-id.
+
+Options:
+  --content <content>  New note content (markdown supported, use "-" for stdin)
+  --agent-id <number>  New agent id, or "null" to clear the association
+  -h, --help           display help for command
+```
+
+## delete
+
+```
+Usage: gobi notes delete [options] <noteId>
+
+Delete a note you authored.
+
+Options:
+  -h, --help  display help for command
+```