@gobi-ai/cli 1.3.1 → 1.3.3

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.1",
+  "version": "1.3.3",
   "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.1",
+      "version": "1.3.3",
       "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.1",
+  "version": "1.3.3",
   "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/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/proposal.js

@@ -0,0 +1,158 @@
+import { readFileSync } from "fs";
+import { apiDelete, apiGet, apiPatch, apiPost } from "../client.js";
+import { isJsonMode, jsonOut, unwrapResp } from "./utils.js";
+function readContent(value) {
+    if (value === "-")
+        return readFileSync("/dev/stdin", "utf8");
+    return value;
+}
+function snippet(content, max = 80) {
+    const single = content.replace(/\s+/g, " ");
+    return single.length > max ? `${single.slice(0, max)}…` : single;
+}
+function formatProposalLine(p) {
+    const status = p.status === "pending" ? "·" : p.status === "accepted" ? "✓" : "✗";
+    return `- [${status}] p${p.priority} rev${p.revision} ${p.proposalId.slice(0, 8)}  ${snippet(p.content)}`;
+}
+export function registerProposalCommand(program) {
+    const proposal = program
+        .command("proposal")
+        .description("Proposals authored by your agent during chat. Top-5 feed the system prompt; accept/reject/revise post into the originating chat session.");
+    // ── List ──
+    proposal
+        .command("list")
+        .description("List proposals (priority ASC, then newest first).")
+        .option("--limit <number>", "Max proposals to return (1-200)", "50")
+        .action(async (opts) => {
+        const params = { limit: parseInt(opts.limit, 10) };
+        const resp = (await apiGet("/app/proposals", params));
+        const items = (resp.data || []);
+        if (isJsonMode(proposal)) {
+            jsonOut(items);
+            return;
+        }
+        if (!items.length) {
+            console.log("No proposals.");
+            return;
+        }
+        console.log(`Proposals (${items.length}):`);
+        for (const p of items)
+            console.log(formatProposalLine(p));
+    });
+    // ── Get ──
+    proposal
+        .command("get <proposalId>")
+        .description("Show one proposal with its history.")
+        .action(async (proposalId) => {
+        const resp = (await apiGet(`/app/proposals/${proposalId}`));
+        const p = unwrapResp(resp);
+        if (isJsonMode(proposal)) {
+            jsonOut(p);
+            return;
+        }
+        console.log(`Proposal ${p.proposalId}`);
+        console.log(`  status:   ${p.status}`);
+        console.log(`  priority: ${p.priority}`);
+        console.log(`  revision: ${p.revision}`);
+        console.log(`  session:  ${p.sessionId ?? "(none)"}`);
+        console.log(`  created:  ${p.createdAt}`);
+        console.log("");
+        console.log("Content:");
+        console.log(p.content);
+        if (p.history.length) {
+            console.log("");
+            console.log("History:");
+            for (const h of p.history) {
+                const detail = h.type === "revise_requested"
+                    ? `: ${h.comment}`
+                    : h.type === "prioritized"
+                        ? `: priority=${h.priority}`
+                        : "";
+                console.log(`  ${h.createdAt}  rev${h.revision}  ${h.type}${detail}`);
+            }
+        }
+    });
+    // ── Edit content ──
+    proposal
+        .command("edit <proposalId> <content>")
+        .description("Replace proposal content (bumps revision). Pass '-' for stdin.")
+        .action(async (proposalId, content) => {
+        const resp = (await apiPatch(`/app/proposals/${proposalId}`, {
+            content: readContent(content),
+        }));
+        const p = unwrapResp(resp);
+        if (isJsonMode(proposal)) {
+            jsonOut(p);
+            return;
+        }
+        console.log(`Updated ${p.proposalId} → rev${p.revision}.`);
+    });
+    // ── Delete ──
+    proposal
+        .command("delete <proposalId>")
+        .description("Delete a proposal.")
+        .action(async (proposalId) => {
+        await apiDelete(`/app/proposals/${proposalId}`);
+        if (isJsonMode(proposal)) {
+            jsonOut({ deleted: proposalId });
+            return;
+        }
+        console.log(`Deleted ${proposalId}.`);
+    });
+    // ── Prioritize ──
+    proposal
+        .command("prioritize <proposalId> <priority>")
+        .description("Set priority (lower = higher). Top 5 feed the system prompt.")
+        .action(async (proposalId, priority) => {
+        const resp = (await apiPatch(`/app/proposals/${proposalId}/priority`, {
+            priority: parseInt(priority, 10),
+        }));
+        const p = unwrapResp(resp);
+        if (isJsonMode(proposal)) {
+            jsonOut(p);
+            return;
+        }
+        console.log(`Set ${p.proposalId} priority to ${p.priority}.`);
+    });
+    // ── Accept ──
+    proposal
+        .command("accept <proposalId>")
+        .description('Accept — posts "Accept your proposal X" into the originating chat session.')
+        .action(async (proposalId) => {
+        const resp = (await apiPost(`/app/proposals/${proposalId}/accept`));
+        const p = unwrapResp(resp);
+        if (isJsonMode(proposal)) {
+            jsonOut(p);
+            return;
+        }
+        console.log(`Accepted ${p.proposalId}.`);
+    });
+    // ── Reject ──
+    proposal
+        .command("reject <proposalId>")
+        .description('Reject — posts "Reject your proposal X" into the originating chat session.')
+        .action(async (proposalId) => {
+        const resp = (await apiPost(`/app/proposals/${proposalId}/reject`));
+        const p = unwrapResp(resp);
+        if (isJsonMode(proposal)) {
+            jsonOut(p);
+            return;
+        }
+        console.log(`Rejected ${p.proposalId}.`);
+    });
+    // ── Revise ──
+    proposal
+        .command("revise <proposalId> <comment>")
+        .description('Ask the agent to revise — posts "Update your proposal X. Here\'s my comment. {comment}" into the chat session.')
+        .action(async (proposalId, comment) => {
+        const resp = (await apiPost(`/app/proposals/${proposalId}/revise`, {
+            comment: readContent(comment),
+        }));
+        const p = unwrapResp(resp);
+        if (isJsonMode(proposal)) {
+            jsonOut(p);
+            return;
+        }
+        console.log(`Revision requested on ${p.proposalId}.`);
+    });
+}

package/dist/main.js

@@ -7,11 +7,13 @@ 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";
 import { registerUpdateCommand } from "./commands/update.js";
 import { registerMediaCommand } from "./commands/media.js";
+import { registerProposalCommand } from "./commands/proposal.js";
 const require = createRequire(import.meta.url);
 const { version } = require("../package.json");
 const SKIP_BANNER_COMMANDS = new Set(["auth", "init", "update"]);
@@ -35,11 +37,13 @@ export async function cli() {
     registerSpaceCommand(program);
     registerBrainCommand(program);
     registerFeedCommand(program);
+    registerNotesCommand(program);
     registerSessionsCommand(program);
     registerSenseCommand(program);
     registerSyncCommand(program);
     registerUpdateCommand(program);
     registerMediaCommand(program);
+    registerProposalCommand(program);
     // Propagate helpWidth to all subcommands
     const helpWidth = process.stdout.columns || 200;
     for (const cmd of program.commands) {

package/package.json

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

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
+```