@gobi-ai/cli 2.0.20 → 2.0.22

package/skills/gobi-core/SKILL.md

@@ -2,10 +2,9 @@
 name: gobi-core
 description: >-
   Core Gobi CLI: authentication (login/logout/status), space selection (gobi
-  space warp/list), CLI updates (gobi update), and session management
-  (list/get/reply to conversations). Use when the user needs to authenticate,
-  manage sessions, or update the CLI. Vault setup is in the gobi-vault skill;
-  file sync is also in gobi-vault.
+  space warp/list), and CLI updates (gobi update). Use when the user needs to
+  authenticate or update the CLI. Vault setup is in the gobi-vault skill; file
+  sync is also in gobi-vault.
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
@@ -41,7 +40,7 @@ brew tap gobi-ai/tap && brew install gobi
 - **Vault**: A filetree-backed knowledge home. A local directory becomes a vault when it contains `.gobi/settings.yaml` with a `vaultSlug`. Each vault has a slug (e.g. `brave-path-zr962w`); public profile is configured by a `PUBLISH.md` document at the vault root and pushed via `gobi vault publish`.
 - **Personal Post**: A post on the author's profile that surfaces in the public global feed. Same `Post` data model as a Space Post — only the scope differs.
 - **Space Post**: A post inside a community space.
-- **Space**: A shared community knowledge area. A user can be a member of one or more spaces; each space contains posts, replies, sessions, and connected vaults.
+- **Space**: A shared community knowledge area. A user can be a member of one or more spaces; each space contains posts, replies, and connected vaults.
 - **Draft**: A unit of standing guidance authored by an agent during chat. Each draft carries 0–3 AI-suggested actions the user picks from. The top 5 pending drafts feed the agent's system prompt every turn.
 
 ## Setup steps (run only what you need)
@@ -73,7 +72,7 @@ gobi auth status
 
 | Command family | Needs vault in `.gobi`? | Needs space in `.gobi`? | Per-call override |
 |----------------|------------------------|------------------------|-------------------|
-| `auth …`, `update`, `session …`, `saved …`, `draft …`, `media …`, `sense …` | no | no | – |
+| `auth …`, `update`, `draft …`, `media …`, `sense …` | no | no | – |
 | `vault publish` / `unpublish` / `sync` | **yes** | no | none — must run `gobi vault init` first |
 | `vault init` | no (it sets it up) | no | – |
 | `space list` / `warp [slug]` / `get [slug]` | no | no | – |
@@ -93,7 +92,7 @@ When a command needs vault or space and neither `.gobi` nor an override flag pro
 For programmatic/agent usage, always pass `--json` as a **global** option (before the subcommand) to get structured JSON output:
 
 ```bash
-gobi --json session list
+gobi --json space list
 ```
 
 JSON responses have the shape `{ "success": true, "data": ... }` on success or `{ "success": false, "error": "..." }` on failure. Pagination metadata (`pagination: { hasMore, nextCursor }`) ships alongside `data` on list endpoints.
@@ -106,26 +105,19 @@ JSON responses have the shape `{ "success": true, "data": ... }` on success or `
   - `gobi auth logout` — Log out of Gobi and remove stored credentials.
 - `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 session` — Session commands (get, list, reply).
-  - `gobi session get` — Get a session and its messages (paginated).
-  - `gobi session list` — List all sessions you are part of, sorted by most recent activity.
-  - `gobi session create-reply` — Send a human reply to a session you are a member of.
 - `gobi update` — Update gobi-cli to the latest version.
 
 > Vault setup (`gobi vault init`) and file sync (`gobi vault sync`) live in the **gobi-vault** skill.
 
 ## Confirm before mutating
 
-`gobi session create-reply` posts a human-attributed message into a chat session — the message becomes part of the user's permanent chat history and triggers the agent to respond. Before running it, confirm with the user — show the exact session id and the message text. This applies even when running autonomously.
-
 `auth login` / `auth logout` are explicit user-driven commands; they prompt the user themselves and don't need an extra confirmation layer. `update` upgrades the CLI binary — fine to run without extra confirmation.
 
-Read-only commands (`auth status`, `session list`, `session get`, `space list`) run without confirmation.
+Read-only commands (`auth status`, `space list`) run without confirmation.
 
 ## Reference Documentation
 
 - [gobi auth](references/auth.md)
-- [gobi session](references/session.md)
 - [gobi update](references/update.md)
 - [gobi space (list/warp)](references/space.md)
 

package/skills/gobi-draft/SKILL.md

@@ -80,13 +80,11 @@ When the user picks an action via `gobi draft action <id> <index>`, the response
 When the user picks an action like "Post to Global Feed" / "Post to <space>" / "Save as note" and your next turn creates the post or note, pass `--draft-id <draftId>` to the relevant create command. `--draft-id` is the **sole** source of `title` and `content` — the CLI fetches the draft and uses its title and content directly, so `--title` / `--content` / `--rich-text` are not allowed alongside it on `create-post`, and `--content` is not allowed alongside it on `create-note`. If you want to change the wording, `gobi draft revise` first, then create.
 
 - `gobi space create-post --draft-id` / `gobi global create-post --draft-id` — uses draft's title and content as the post's `title` and `content`. The draft's `vaultSlug` (when set) seeds `--vault-slug` if not given explicitly. `--auto-attachments`, `--space-slug`, and an explicit `--vault-slug` override remain allowed. Records `{ postId, spaceSlug? }` on `draft.metadata` for an "Open post" button.
-- `gobi saved create-note --draft-id` — fetches the draft and folds it into the note as `# <title>\n\n<content>` (or just content when title is empty). Records `{ noteId }` on `draft.metadata` for an "Open note" button.
 
 ```bash
 gobi --json global create-post --draft-id <draftId>
 gobi --json space create-post --space-slug <slug> --draft-id <draftId>
 gobi --json global create-post --draft-id <draftId> --auto-attachments
-gobi --json saved create-note --draft-id <draftId>
 ```
 
 ## Available Commands

package/dist/commands/saved.js

@@ -1,261 +0,0 @@
-import { apiGet, apiPost, apiPatch, apiDelete } from "../client.js";
-import { fetchDraftSummary, isJsonMode, jsonOut, readStdin, 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})`;
-}
-function formatSavedPostLine(item) {
-    const author = item.author?.name;
-    const title = item.title || item.content || "(no title)";
-    const snippet = title.length > 80 ? title.slice(0, 80) + "…" : title;
-    const space = item.spaceSlug ? `, space: ${item.spaceSlug}` : "";
-    return `- [${item.postId}] "${snippet.replace(/\n/g, " ")}" by ${author ?? "?"}${space} (saved ${item.savedAt})`;
-}
-export function registerSavedCommand(program) {
-    const saved = program
-        .command("saved")
-        .description("Saved-knowledge commands (notes and bookmarked posts).");
-    // ── Notes ──
-    saved
-        .command("list-notes")
-        .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", "20")
-        .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(saved)) {
-            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);
-    });
-    saved
-        .command("get-note <noteId>")
-        .description("Get a single note by id.")
-        .action(async (noteId) => {
-        const resp = (await apiGet(`/app/notes/${noteId}`));
-        const note = unwrapResp(resp);
-        if (isJsonMode(saved)) {
-            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);
-    });
-    saved
-        .command("create-note")
-        .description("Create a note. Provide --content (use '-' for stdin), or --draft-id to source content from a draft.")
-        .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")
-        .option("--draft-id <draftId>", "Use this draft as the source of content (mutually exclusive with --content). The draft's title is prepended as an H1 heading. On success, links the note back by recording noteId on draft.metadata so the client can render an 'Open note' button.")
-        .action(async (opts) => {
-        if (opts.draftId) {
-            if (opts.content) {
-                throw new Error("--draft-id sources content from the draft; --content is not allowed alongside it.");
-            }
-        }
-        else if (!opts.content) {
-            throw new Error("--content is required (use '-' to read from stdin), or pass --draft-id.");
-        }
-        let content;
-        if (opts.draftId) {
-            const draft = await fetchDraftSummary(opts.draftId);
-            content = draft.title
-                ? `# ${draft.title}\n\n${draft.content}`
-                : draft.content;
-        }
-        else {
-            content = opts.content === "-" ? readStdin() : 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 (opts.draftId && note.id != null) {
-            try {
-                await apiPatch(`/app/drafts/${opts.draftId}/metadata`, {
-                    noteId: typeof note.id === "number" ? note.id : Number(note.id),
-                });
-            }
-            catch (e) {
-                console.error(`Warning: failed to link note to draft ${opts.draftId}: ${e.message}`);
-            }
-        }
-        if (isJsonMode(saved)) {
-            jsonOut(note);
-            return;
-        }
-        console.log(`Note created!\n  ID: ${note.id}\n  Date: ${note.eventDate}\n  Created: ${note.createdAt}` +
-            (opts.draftId ? `\n  Linked to draft: ${opts.draftId}` : ""));
-    });
-    saved
-        .command("edit-note <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 === "-" ? readStdin() : 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(saved)) {
-            jsonOut(note);
-            return;
-        }
-        console.log(`Note edited!\n  ID: ${note.id}\n  Updated: ${note.updatedAt}`);
-    });
-    saved
-        .command("delete-note <noteId>")
-        .description("Delete a note you authored.")
-        .action(async (noteId) => {
-        await apiDelete(`/app/notes/${noteId}`);
-        if (isJsonMode(saved)) {
-            jsonOut({ id: noteId });
-            return;
-        }
-        console.log(`Note ${noteId} deleted.`);
-    });
-    // ── Saved posts (bookmarks) ──
-    saved
-        .command("list-posts")
-        .description("List posts you have bookmarked (paginated).")
-        .option("--type <type>", "Filter by type: all|article|space-post", "all")
-        .option("--limit <number>", "Items per page", "20")
-        .option("--cursor <string>", "Pagination cursor from previous response")
-        .action(async (opts) => {
-        const params = {
-            type: opts.type,
-            limit: parseInt(opts.limit, 10),
-        };
-        if (opts.cursor)
-            params.cursor = opts.cursor;
-        const resp = (await apiGet(`/reactions/me/saved`, params));
-        const items = (resp.data || []);
-        const pagination = (resp.pagination || {});
-        if (isJsonMode(saved)) {
-            jsonOut({ items, pagination });
-            return;
-        }
-        if (!items.length) {
-            console.log("No saved posts found.");
-            return;
-        }
-        const lines = items.map(formatSavedPostLine);
-        const footer = pagination.hasMore ? `\n  Next cursor: ${pagination.nextCursor}` : "";
-        console.log(`Saved posts (${items.length} items):\n` + lines.join("\n") + footer);
-    });
-    saved
-        .command("get-post <postId>")
-        .description("Get a saved post snapshot by post id.")
-        .action(async (postId) => {
-        const resp = (await apiGet(`/posts/${postId}`));
-        const data = unwrapResp(resp);
-        if (isJsonMode(saved)) {
-            jsonOut(data);
-            return;
-        }
-        const post = (data.update || data.post || data);
-        const author = post.author?.name ||
-            `User ${post.authorId}`;
-        const title = post.title || "(no title)";
-        console.log([
-            `Saved post [${post.id}]: ${title}`,
-            `By: ${author} on ${post.createdAt}`,
-            "",
-            post.content || "",
-        ].join("\n"));
-    });
-    saved
-        .command("create-post")
-        .description("Bookmark a post or reply by id. Records a snapshot in your saved-posts collection.")
-        .requiredOption("--source <id>", "Source post or reply id to bookmark (numeric)")
-        .action(async (opts) => {
-        const sourceId = parseInt(opts.source, 10);
-        if (!Number.isFinite(sourceId)) {
-            throw new Error("--source must be a numeric post or reply id.");
-        }
-        const resp = (await apiPost(`/reactions/posts/${sourceId}/save`, {
-            vaultIds: [],
-        }));
-        const data = unwrapResp(resp);
-        if (isJsonMode(saved)) {
-            jsonOut({ id: sourceId, ...data });
-            return;
-        }
-        console.log(`Saved post ${sourceId}.`);
-    });
-    saved
-        .command("delete-post <postId>")
-        .description("Remove a post from your saved-posts collection.")
-        .action(async (postId) => {
-        await apiDelete(`/reactions/posts/${postId}/save`);
-        if (isJsonMode(saved)) {
-            jsonOut({ id: postId });
-            return;
-        }
-        console.log(`Removed post ${postId} from saved.`);
-    });
-}

package/dist/commands/sessions.js

@@ -1,124 +0,0 @@
-import { apiGet, apiPost } from "../client.js";
-import { isJsonMode, jsonOut, readStdin, unwrapResp } from "./utils.js";
-export function registerSessionsCommand(program) {
-    const sessions = program
-        .command("session")
-        .description("Session commands (get, list, create-reply).");
-    // ── Get ──
-    sessions
-        .command("get <sessionId>")
-        .description("Get a session and its messages (paginated).")
-        .option("--limit <number>", "Items per page", "20")
-        .option("--cursor <string>", "Pagination cursor from previous response")
-        .action(async (sessionId, opts) => {
-        const params = {
-            limit: parseInt(opts.limit, 10),
-        };
-        if (opts.cursor)
-            params.cursor = opts.cursor;
-        const resp = (await apiGet(`/chat/${sessionId}/messages`, params));
-        const messages = (resp.data || []);
-        const pagination = (resp.pagination || {});
-        if (isJsonMode(sessions)) {
-            jsonOut({ messages, pagination });
-            return;
-        }
-        const msgLines = [];
-        for (const m of messages) {
-            const author = m.author?.name ||
-                m.source ||
-                `User ${m.authorId}`;
-            const text = m.content;
-            const truncated = text.length > 200 ? text.slice(0, 200) + "\u2026" : text;
-            msgLines.push(`  - ${author}: ${truncated} (${m.createdAt})`);
-        }
-        const output = [
-            `Session: ${sessionId}`,
-            "",
-            `Messages (${messages.length} items):`,
-            ...msgLines,
-            ...(pagination.hasMore ? [`  Next cursor: ${pagination.nextCursor}`] : []),
-        ].join("\n");
-        console.log(output);
-    });
-    // ── List ──
-    sessions
-        .command("list")
-        .description("List all sessions you are part of, sorted by most recent activity.")
-        .option("--limit <number>", "Items per page", "20")
-        .option("--cursor <string>", "Pagination cursor from previous response")
-        .action(async (opts) => {
-        const query = { limit: parseInt(opts.limit, 10) };
-        if (opts.cursor)
-            query.cursor = opts.cursor;
-        const resp = (await apiGet(`/chat/my-sessions`, query));
-        const items = (resp.data || []);
-        const pagination = (resp.pagination || {});
-        if (isJsonMode(sessions)) {
-            jsonOut({
-                items,
-                pagination: resp.pagination || {},
-            });
-            return;
-        }
-        if (!items.length) {
-            console.log("No sessions found.");
-            return;
-        }
-        const lines = [];
-        for (const s of items) {
-            const title = s.title || "(no title)";
-            const members = s.members || [];
-            const memberCount = s.memberCount ?? 0;
-            let memberInfo = "";
-            if (members.length > 0) {
-                const names = members.map((m) => m.vaultName || m.name || "Unknown");
-                const overflow = memberCount - members.length - 1; // -1 for "me"
-                memberInfo = ` | with: ${names.join(", ")}`;
-                if (overflow > 0)
-                    memberInfo += ` +${overflow} more`;
-            }
-            lines.push(`- [${s.sessionId}] "${title}" (mode: ${s.mode}, last activity: ${s.lastMessageAt})${memberInfo}`);
-        }
-        const footer = pagination.hasMore ? `\n  Next cursor: ${pagination.nextCursor}` : "";
-        console.log(`Sessions (${items.length} items):\n` + lines.join("\n") + footer);
-    });
-    // ── Reply ──
-    sessions
-        .command("create-reply <sessionId>")
-        .description("Send a human reply to a session you are a member of.")
-        .option("--content <content>", "Reply content (markdown supported, use \"-\" for stdin)")
-        .option("--rich-text <richText>", "Rich-text JSON array (e.g. [{\"type\":\"text\",\"text\":\"hello\"}])")
-        .action(async (sessionId, opts) => {
-        if (!opts.content && !opts.richText) {
-            throw new Error("Provide either --content or --rich-text.");
-        }
-        if (opts.content && opts.richText) {
-            throw new Error("--content and --rich-text are mutually exclusive.");
-        }
-        const body = {};
-        if (opts.richText != null) {
-            let parsed;
-            try {
-                parsed = JSON.parse(opts.richText);
-            }
-            catch {
-                throw new Error("Invalid --rich-text JSON.");
-            }
-            body.richText = parsed;
-        }
-        else {
-            body.content = opts.content === "-" ? readStdin() : opts.content;
-        }
-        const resp = (await apiPost(`/chat/${sessionId}/reply`, body));
-        const msg = unwrapResp(resp);
-        if (isJsonMode(sessions)) {
-            jsonOut(msg);
-            return;
-        }
-        console.log(`Reply sent!\n` +
-            `  Message ID: ${msg.id}\n` +
-            `  Source: ${msg.source}\n` +
-            `  Created: ${msg.createdAt}`);
-    });
-}

package/skills/gobi-core/references/session.md

@@ -1,55 +0,0 @@
-# gobi session
-
-```
-Usage: gobi session [options] [command]
-
-Session commands (get, list, create-reply).
-
-Options:
-  -h, --help                          display help for command
-
-Commands:
-  get [options] <sessionId>           Get a session and its messages (paginated).
-  list [options]                      List all sessions you are part of, sorted by most recent activity.
-  create-reply [options] <sessionId>  Send a human reply to a session you are a member of.
-  help [command]                      display help for command
-```
-
-## get
-
-```
-Usage: gobi session get [options] <sessionId>
-
-Get a session and its messages (paginated).
-
-Options:
-  --limit <number>   Items per page (default: "20")
-  --cursor <string>  Pagination cursor from previous response
-  -h, --help         display help for command
-```
-
-## list
-
-```
-Usage: gobi session list [options]
-
-List all sessions you are part of, sorted by most recent activity.
-
-Options:
-  --limit <number>   Items per page (default: "20")
-  --cursor <string>  Pagination cursor from previous response
-  -h, --help         display help for command
-```
-
-## create-reply
-
-```
-Usage: gobi session create-reply [options] <sessionId>
-
-Send a human reply to a session you are a member of.
-
-Options:
-  --content <content>     Reply content (markdown supported, use "-" for stdin)
-  --rich-text <richText>  Rich-text JSON array (e.g. [{"type":"text","text":"hello"}])
-  -h, --help              display help for command
-```

package/skills/gobi-saved/SKILL.md

@@ -1,70 +0,0 @@
----
-name: gobi-saved
-description: >-
-  Gobi saved commands for the user's personal saved-knowledge collection:
-  notes (list/get/create/edit/delete) and bookmarked posts (snapshot a
-  post/reply from feed/space; list/get/delete). Use when the user wants to
-  capture their own notes or bookmark/manage posts they've saved.
-allowed-tools: Bash(gobi:*)
-metadata:
-  author: gobi-ai
-  version: "2.0.9"
----
-
-# gobi-saved
-
-Gobi saved-knowledge commands (v2.0.9).
-
-Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
-
-## What is "saved"?
-
-`gobi saved` is the user's personal saved-knowledge collection. It covers two kinds of items:
-
-- **Notes** — user-authored notes (private, dated entries). Verbs: `list-notes`, `get-note`, `create-note`, `edit-note`, `delete-note`.
-- **Posts** — snapshots of posts (or replies) bookmarked from a space or the global feed. Verbs: `list-posts`, `get-post`, `create-post`, `delete-post`.
-
-Both are user-private — only the author can see/edit/delete their own items.
-
-> Naming note: `gobi saved create-post --source <id>` is a **bookmark** operation — it saves an existing post into your collection. It does *not* author a new post (use `gobi global create-post` or `gobi space create-post` for that).
-
-## Timezone
-
-`gobi saved list-notes` and `gobi saved create-note` 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 saved list-notes --date 2026-04-27
-```
-
-## Available Commands
-
-### Notes
-- `gobi saved list-notes` — List your notes. Without `--date`, returns recent notes via cursor pagination. With `--date YYYY-MM-DD`, returns all notes for that day.
-- `gobi saved get-note <noteId>` — Get a single note by id.
-- `gobi saved create-note --content <md>` — Create a note. Use `'-'` for stdin. Or pass `--draft-id <draftId>` to source content from a draft (mutually exclusive with `--content`); the draft's title is prepended as an H1, and the resulting `noteId` is recorded on `draft.metadata` so the client can render an "Open note" button.
-- `gobi saved edit-note <noteId>` — Edit a note. Provide `--content` and/or `--agent-id`.
-- `gobi saved delete-note <noteId>` — Delete a note you authored.
-
-### Posts (bookmarks)
-- `gobi saved list-posts` — List posts you have bookmarked (paginated). Filter with `--type all|article|space-post`.
-- `gobi saved get-post <postId>` — Get a saved post snapshot by post id.
-- `gobi saved create-post --source <id>` — Bookmark a post or reply by id. Records a snapshot in your saved-posts collection.
-- `gobi saved delete-post <postId>` — Remove a post from your saved-posts collection.
-
-## Confirm before mutating
-
-Saved items are the user's private collection but they still persist server-side and deletes are irreversible. Before running any write, confirm with the user — show the command and the note content / target id. This applies even when running autonomously.
-
-- `create-note`, `edit-note` — confirm the content (or content delta on edit).
-- `create-post` (bookmarking a feed post) — confirm the source id you're about to bookmark.
-- `delete-note`, `delete-post` — irreversible. Flag that explicitly and confirm the target id before running.
-
-Read-only commands (`list-notes`, `get-note`, `list-posts`, `get-post`) run without confirmation.
-
-## Reference Documentation
-
-- [gobi saved](references/saved.md)