@gobi-ai/cli 2.0.30 → 2.0.31

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.30",
+  "version": "2.0.31",
   "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.30",
+      "version": "2.0.31",
       "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.30",
+  "version": "2.0.31",
   "author": {
     "name": "gobi-ai"
   },

package/dist/attachments.js

@@ -7,8 +7,10 @@ import { apiPost } from "./client.js";
 import { normalizeSyncPattern } from "./commands/sync.js";
 // Best-effort extension → MIME mapping. Anything we don't recognize falls
 // back to `application/octet-stream`; the backend caps size per content-type
-// tier (5MB photos / 15MB GIFs / 512MB video) so it's the authority on what's
-// allowed. We're just trying to set a usable Content-Type for the S3 PUT.
+// tier (10MB photos / 15MB GIFs / 512MB video / 250MB document files) so
+// it's the authority on what's allowed. We're just trying to set a usable
+// Content-Type for the S3 PUT — and for document files the declared MIME is
+// what routes the post row into the 'file' kind, so it must be accurate.
 const POST_MEDIA_MIME_MAP = {
     ".jpg": "image/jpeg",
     ".jpeg": "image/jpeg",
@@ -26,20 +28,30 @@ const POST_MEDIA_MIME_MAP = {
     ".webm": "video/webm",
     ".m4v": "video/x-m4v",
     ".pdf": "application/pdf",
+    ".md": "text/markdown",
+    ".markdown": "text/markdown",
+    ".txt": "text/plain",
+    ".csv": "text/csv",
 };
-// X-style cap: 4 photos OR 1 GIF OR 1 video. Anything not photo/gif/video
-// is treated as "photo" for cap purposes so misclassified files still get
-// the 4-cap rather than slipping through unlimited.
+const FILE_EXTENSIONS = [".pdf", ".md", ".markdown", ".txt", ".csv"];
+const VIDEO_EXTENSIONS = [".mp4", ".mov", ".webm", ".m4v"];
+// Mirrors the backend mix rule: up to 4 photos + up to 4 document files
+// (pdf/md/txt/csv) together, OR 1 GIF, OR 1 video — GIF and video are
+// exclusive with everything. Unknown extensions count against the photo cap
+// (the backend's 'other' kind) so nothing slips through unlimited.
 export function assertPostAttachmentMix(paths) {
     let photos = 0;
     let gifs = 0;
     let videos = 0;
+    let files = 0;
     for (const p of paths) {
         const ext = extname(p).toLowerCase();
         if (ext === ".gif")
             gifs += 1;
-        else if ([".mp4", ".mov", ".webm", ".m4v"].includes(ext))
+        else if (VIDEO_EXTENSIONS.includes(ext))
             videos += 1;
+        else if (FILE_EXTENSIONS.includes(ext))
+            files += 1;
         else
             photos += 1;
     }
@@ -49,10 +61,12 @@ export function assertPostAttachmentMix(paths) {
         throw new Error("Only 1 GIF allowed per post");
     if (photos > 4)
         throw new Error("Up to 4 photos allowed per post");
-    if (videos > 0 && (gifs > 0 || photos > 0)) {
+    if (files > 4)
+        throw new Error("Up to 4 files allowed per post");
+    if (videos > 0 && (gifs > 0 || photos > 0 || files > 0)) {
         throw new Error("A video can't be combined with other media");
     }
-    if (gifs > 0 && (videos > 0 || photos > 0)) {
+    if (gifs > 0 && (videos > 0 || photos > 0 || files > 0)) {
         throw new Error("A GIF can't be combined with other media");
     }
 }
@@ -90,7 +104,15 @@ export async function uploadPostAttachment(filePath) {
     if (!putRes.ok) {
         throw new Error(`Failed to PUT ${filePath} to S3: HTTP ${putRes.status}`);
     }
-    return { mediaUrl, mediaKey };
+    const attachment = { mediaUrl, mediaKey };
+    // Document files carry name + MIME on the row: the declared mimeType is
+    // what the backend trusts for kind/preview routing, and the original
+    // filename only survives here (the S3 key is a UUID).
+    if (FILE_EXTENSIONS.includes(ext)) {
+        attachment.fileName = basename(abs);
+        attachment.mimeType = contentType;
+    }
+    return attachment;
 }
 export async function uploadPostAttachments(paths) {
     const out = [];

package/dist/client.js

@@ -38,6 +38,9 @@ export function apiPost(path, body) {
 export function apiPatch(path, body) {
     return request("PATCH", path, { body });
 }
+export function apiPut(path, body) {
+    return request("PUT", path, { body });
+}
 export function apiDelete(path) {
     return request("DELETE", path);
 }

package/dist/commands/global.js

@@ -1,6 +1,6 @@
 import { WEB_BASE_URL } from "../constants.js";
-import { apiGet, apiPost, apiPatch, apiDelete } from "../client.js";
-import { isJsonMode, jsonOut, readStdin, unwrapResp, } from "./utils.js";
+import { apiGet, apiPost, apiPatch, apiPut, apiDelete } from "../client.js";
+import { formatAttachmentLines, formatAttachmentSummary, formatReactionChips, isJsonMode, jsonOut, readStdin, unwrapResp, } from "./utils.js";
 import { uploadPostAttachments, assertPostAttachmentMix, } from "../attachments.js";
 function readContent(value) {
     if (value === "-")
@@ -26,7 +26,11 @@ function formatFeedLine(m) {
     else {
         label = m.title || m.content || "";
     }
-    return `${id} ${kind} ${author}  "${label}"  ${m.createdAt}`;
+    const chips = formatReactionChips(m);
+    const attachSummary = formatAttachmentSummary(m);
+    return (`${id} ${kind} ${author}  "${label}"  ${m.createdAt}` +
+        (attachSummary ? `  ${attachSummary}` : "") +
+        (chips ? `  ${chips}` : ""));
 }
 export function registerGlobalCommand(program) {
     const global = program
@@ -145,20 +149,28 @@ export function registerGlobalCommand(program) {
                 `User ${r.authorId}`;
             const text = r.content || "";
             const truncated = opts.full || text.length <= 200 ? text : text.slice(0, 200) + "…";
-            replyLines.push(`  - ${rAuthor}: ${truncated} (${r.createdAt})`);
+            const rChips = formatReactionChips(r);
+            const rAttach = formatAttachmentSummary(r);
+            replyLines.push(`  - [r:${r.id}] ${rAuthor}: ${truncated} (${r.createdAt})${rAttach ? `  ${rAttach}` : ""}${rChips ? `  ${rChips}` : ""}`);
         }
         const isReplyPost = post.parentPostId != null;
         const heading = isReplyPost
             ? `Reply [r:${post.id}]`
             : `Post: ${post.title || "(no title)"}`;
+        const postChips = formatReactionChips(post);
+        const attachmentLines = formatAttachmentLines(post);
         const output = [
             heading,
             `By: ${author} on ${post.createdAt}`,
+            ...(postChips ? [`Reactions: ${postChips}`] : []),
             ...(ancestorLines.length
                 ? ["", `Ancestors (${ancestors.length} items, root first):`, ...ancestorLines]
                 : []),
             "",
             post.content || "",
+            ...(attachmentLines.length
+                ? ["", `Attachments (${attachmentLines.length}):`, ...attachmentLines]
+                : []),
             "",
             `Replies (${replies.length} items):`,
             ...replyLines,
@@ -176,7 +188,7 @@ export function registerGlobalCommand(program) {
         .option("--content <content>", "Post content (markdown supported, use \"-\" for stdin)")
         .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 artifact create`.", (value, prev = []) => [...prev, value], [])
-        .option("--attach <file>", "Local media file to attach. Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size ceilings: 5MB photos / 15MB GIFs / 512MB video.", (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 post. Composes with --content / --rich-text / --attach (the wrapping author's text + media render above the embedded card). Reposts-of-reposts are collapsed to the transitive root server-side. The referenced post must exist, not be deleted, and not itself be a reply.")
         .action(async (opts) => {
         if (!opts.content && !opts.richText) {
@@ -234,7 +246,7 @@ export function registerGlobalCommand(program) {
         .option("--title <title>", "New title")
         .option("--content <content>", "New content (markdown supported, use \"-\" for stdin)")
         .option("--rich-text <richText>", "Rich-text JSON array (mutually exclusive with --content)")
-        .option("--attach <file>", "Replace the post's media attachments with the given files (existing attachments are removed). Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size ceilings: 5MB photos / 15MB GIFs / 512MB video. Omit to leave attachments unchanged.", (value, prev = []) => [...prev, value], [])
+        .option("--attach <file>", "Replace the post's media attachments with the given files (existing attachments are removed). 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. Omit to leave attachments unchanged.", (value, prev = []) => [...prev, value], [])
         .option("--artifact <artifactId>", "Replace the post's artifact attachments with the given artifact(s) (existing artifact attachments are removed). Repeatable. Omit to leave them unchanged. Create artifacts with `gobi artifact create`.", (value, prev = []) => [...prev, value], [])
         .action(async (postId, opts) => {
         const wantsAttachChange = !!(opts.attach && opts.attach.length > 0);
@@ -297,7 +309,7 @@ export function registerGlobalCommand(program) {
         .description("Create a reply to a post in the global feed.")
         .option("--content <content>", "Reply content (markdown supported, use \"-\" for stdin)")
         .option("--rich-text <richText>", "Rich-text JSON array (mutually exclusive with --content)")
-        .option("--attach <file>", "Local media file to attach to this reply. Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size ceilings: 5MB photos / 15MB GIFs / 512MB video.", (value, prev = []) => [...prev, value], [])
+        .option("--attach <file>", "Local media or document file to attach to this reply. 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], [])
         .action(async (postId, opts) => {
         if (!opts.content && !opts.richText) {
             throw new Error("Provide either --content or --rich-text.");
@@ -376,4 +388,34 @@ export function registerGlobalCommand(program) {
         }
         console.log(`Reply ${replyId} deleted.`);
     });
+    // ── Reactions (react, unreact) ──
+    global
+        .command("react <postId> <emoji>")
+        .description("Add an emoji reaction to a global-feed post or reply (idempotent). <postId> is the numeric id of a post OR a reply — the [p:N]/[r:N] ids shown in feed output.")
+        .action(async (postId, emoji) => {
+        const resp = (await apiPut(`/posts/${postId}/reactions`, {
+            emoji,
+        }));
+        const data = unwrapResp(resp);
+        if (isJsonMode(global)) {
+            jsonOut(data);
+            return;
+        }
+        const chips = formatReactionChips(data);
+        console.log(`Reacted ${emoji} to ${postId}.` + (chips ? `\n  Now: ${chips}` : ""));
+    });
+    global
+        .command("unreact <postId> <emoji>")
+        .description("Remove your emoji reaction from a global-feed post or reply. <postId> is the numeric id of a post OR a reply.")
+        .action(async (postId, emoji) => {
+        const resp = (await apiDelete(`/posts/${postId}/reactions/${encodeURIComponent(emoji)}`));
+        const data = unwrapResp(resp);
+        if (isJsonMode(global)) {
+            jsonOut(data);
+            return;
+        }
+        const chips = formatReactionChips(data);
+        console.log(`Removed ${emoji} reaction from ${postId}.` +
+            (chips ? `\n  Now: ${chips}` : ""));
+    });
 }

package/dist/commands/personal.js

@@ -1,5 +1,5 @@
-import { apiGet, apiPost, apiPatch, apiDelete } from "../client.js";
-import { isJsonMode, jsonOut, readStdin, unwrapResp, } from "./utils.js";
+import { apiGet, apiPost, apiPatch, apiPut, apiDelete } from "../client.js";
+import { formatAttachmentLines, formatAttachmentSummary, formatReactionChips, isJsonMode, jsonOut, readStdin, unwrapResp, } from "./utils.js";
 import { uploadPostAttachments, assertPostAttachmentMix, } from "../attachments.js";
 function readContent(value) {
     if (value === "-")
@@ -22,7 +22,11 @@ function formatFeedLine(m) {
     else {
         label = m.title || m.content || "";
     }
-    return `${id} ${kind} ${author}  "${label}"  ${m.createdAt}`;
+    const chips = formatReactionChips(m);
+    const attachSummary = formatAttachmentSummary(m);
+    return (`${id} ${kind} ${author}  "${label}"  ${m.createdAt}` +
+        (attachSummary ? `  ${attachSummary}` : "") +
+        (chips ? `  ${chips}` : ""));
 }
 export function registerPersonalCommand(program) {
     const personal = program
@@ -147,20 +151,28 @@ export function registerPersonalCommand(program) {
                 `User ${r.authorId}`;
             const text = r.content || "";
             const truncated = opts.full || text.length <= 200 ? text : text.slice(0, 200) + "…";
-            replyLines.push(`  - ${rAuthor}: ${truncated} (${r.createdAt})`);
+            const rChips = formatReactionChips(r);
+            const rAttach = formatAttachmentSummary(r);
+            replyLines.push(`  - [r:${r.id}] ${rAuthor}: ${truncated} (${r.createdAt})${rAttach ? `  ${rAttach}` : ""}${rChips ? `  ${rChips}` : ""}`);
         }
         const isReplyPost = post.parentPostId != null;
         const heading = isReplyPost
             ? `Reply [r:${post.id}] (private)`
             : `Post: ${post.title || "(no title)"} (private)`;
+        const postChips = formatReactionChips(post);
+        const attachmentLines = formatAttachmentLines(post);
         const output = [
             heading,
             `By: ${author} on ${post.createdAt}`,
+            ...(postChips ? [`Reactions: ${postChips}`] : []),
             ...(ancestorLines.length
                 ? ["", `Ancestors (${ancestors.length} items, root first):`, ...ancestorLines]
                 : []),
             "",
             post.content || "",
+            ...(attachmentLines.length
+                ? ["", `Attachments (${attachmentLines.length}):`, ...attachmentLines]
+                : []),
             "",
             `Replies (${replies.length} items):`,
             ...replyLines,
@@ -184,7 +196,7 @@ export function registerPersonalCommand(program) {
         .option("--content <content>", "Post content (markdown supported, use \"-\" for stdin)")
         .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 artifact create`.", (value, prev = []) => [...prev, value], [])
-        .option("--attach <file>", "Local media file to attach. Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size ceilings: 5MB photos / 15MB GIFs / 512MB video.", (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.")
         .action(async (opts) => {
         if (!opts.content && !opts.richText) {
@@ -245,7 +257,7 @@ export function registerPersonalCommand(program) {
         .option("--title <title>", "New title")
         .option("--content <content>", "New content (markdown supported, use \"-\" for stdin)")
         .option("--rich-text <richText>", "Rich-text JSON array (mutually exclusive with --content)")
-        .option("--attach <file>", "Replace the post's media attachments with the given files (existing attachments are removed). Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size ceilings: 5MB photos / 15MB GIFs / 512MB video. Omit to leave attachments unchanged.", (value, prev = []) => [...prev, value], [])
+        .option("--attach <file>", "Replace the post's media attachments with the given files (existing attachments are removed). 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. Omit to leave attachments unchanged.", (value, prev = []) => [...prev, value], [])
         .option("--artifact <artifactId>", "Replace the post's artifact attachments with the given artifact(s) (existing artifact attachments are removed). Repeatable. Omit to leave them unchanged. Create artifacts with `gobi artifact create`.", (value, prev = []) => [...prev, value], [])
         .action(async (postId, opts) => {
         const wantsAttachChange = !!(opts.attach && opts.attach.length > 0);
@@ -313,7 +325,7 @@ export function registerPersonalCommand(program) {
         .description("Reply to a personal-space post. The reply inherits the parent's private scope automatically.")
         .option("--content <content>", "Reply content (markdown supported, use \"-\" for stdin)")
         .option("--rich-text <richText>", "Rich-text JSON array (mutually exclusive with --content)")
-        .option("--attach <file>", "Local media file to attach to this reply. Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size ceilings: 5MB photos / 15MB GIFs / 512MB video.", (value, prev = []) => [...prev, value], [])
+        .option("--attach <file>", "Local media or document file to attach to this reply. 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], [])
         .action(async (postId, opts) => {
         if (!opts.content && !opts.richText) {
             throw new Error("Provide either --content or --rich-text.");
@@ -392,4 +404,34 @@ export function registerPersonalCommand(program) {
         }
         console.log(`Reply ${replyId} deleted.`);
     });
+    // ── Reactions (react, unreact) ──
+    personal
+        .command("react <postId> <emoji>")
+        .description("Add an emoji reaction to a personal-space post or reply (idempotent). <postId> is the numeric id of a post OR a reply.")
+        .action(async (postId, emoji) => {
+        const resp = (await apiPut(`/posts/${postId}/reactions`, {
+            emoji,
+        }));
+        const data = unwrapResp(resp);
+        if (isJsonMode(personal)) {
+            jsonOut(data);
+            return;
+        }
+        const chips = formatReactionChips(data);
+        console.log(`Reacted ${emoji} to ${postId}.` + (chips ? `\n  Now: ${chips}` : ""));
+    });
+    personal
+        .command("unreact <postId> <emoji>")
+        .description("Remove your emoji reaction from a personal-space post or reply. <postId> is the numeric id of a post OR a reply.")
+        .action(async (postId, emoji) => {
+        const resp = (await apiDelete(`/posts/${postId}/reactions/${encodeURIComponent(emoji)}`));
+        const data = unwrapResp(resp);
+        if (isJsonMode(personal)) {
+            jsonOut(data);
+            return;
+        }
+        const chips = formatReactionChips(data);
+        console.log(`Removed ${emoji} reaction from ${postId}.` +
+            (chips ? `\n  Now: ${chips}` : ""));
+    });
 }

package/dist/commands/space.js

@@ -1,7 +1,7 @@
 import { WEB_BASE_URL } from "../constants.js";
-import { apiGet, apiPost, apiPatch, apiDelete } from "../client.js";
+import { apiGet, apiPost, apiPatch, apiPut, apiDelete } from "../client.js";
 import { requireSpace, selectSpace, setSpaceRequirement, writeSpaceSetting, } from "./init.js";
-import { isJsonMode, jsonOut, readStdin, resolveSpaceSlug, unwrapResp, } from "./utils.js";
+import { formatAttachmentLines, formatAttachmentSummary, formatReactionChips, isJsonMode, jsonOut, readStdin, resolveSpaceSlug, unwrapResp, } from "./utils.js";
 import { uploadPostAttachments, assertPostAttachmentMix, } from "../attachments.js";
 function readContent(value) {
     if (value === "-")
@@ -23,7 +23,20 @@ function formatFeedLine(m) {
     else {
         label = m.title || m.content || "";
     }
-    return `${id} ${kind} ${author}  "${label}"  ${m.createdAt}`;
+    const chips = formatReactionChips(m);
+    const attachSummary = formatAttachmentSummary(m);
+    return (`${id} ${kind} ${author}  "${label}"  ${m.createdAt}` +
+        (attachSummary ? `  ${attachSummary}` : "") +
+        (chips ? `  ${chips}` : ""));
+}
+function parseChannelIdOption(value) {
+    if (value == null)
+        return undefined;
+    const n = Number(value);
+    if (!Number.isInteger(n) || n <= 0) {
+        throw new Error("--channel must be a positive integer channel id.");
+    }
+    return n;
 }
 export function registerSpaceCommand(program) {
     const space = program
@@ -179,6 +192,7 @@ export function registerSpaceCommand(program) {
         .description("List the unified feed (posts and replies, newest first) in a space.")
         .option("--limit <number>", "Items per page", "20")
         .option("--cursor <string>", "Pagination cursor from previous response")
+        .option("--channel <channelId>", "Channel id to read instead of the main feed (see `list-channels`). Omit for the main feed.")
         .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
         .action(async (opts) => {
         const spaceSlug = resolveSpaceSlug(space, opts);
@@ -187,6 +201,7 @@ export function registerSpaceCommand(program) {
         };
         if (opts.cursor)
             params.cursor = opts.cursor;
+        params.channelId = parseChannelIdOption(opts.channel);
         const resp = (await apiGet(`/spaces/${spaceSlug}/feed`, params));
         if (isJsonMode(space)) {
             jsonOut({
@@ -251,20 +266,28 @@ export function registerSpaceCommand(program) {
             const body = opts.full || !text || text.length <= 200
                 ? text
                 : text.slice(0, 200) + "…";
-            replyLines.push(`  - ${rAuthor}: ${body} (${r.createdAt})`);
+            const rChips = formatReactionChips(r);
+            const rAttach = formatAttachmentSummary(r);
+            replyLines.push(`  - [r:${r.id}] ${rAuthor}: ${body} (${r.createdAt})${rAttach ? `  ${rAttach}` : ""}${rChips ? `  ${rChips}` : ""}`);
         }
         const isReplyPost = post.parentPostId != null;
         const heading = isReplyPost
             ? `Reply [r:${post.id}]`
             : `Post: ${post.title || "(no title)"}`;
+        const postChips = formatReactionChips(post);
+        const attachmentLines = formatAttachmentLines(post);
         const output = [
             heading,
             `By: ${author} on ${post.createdAt}`,
+            ...(postChips ? [`Reactions: ${postChips}`] : []),
             ...(ancestorLines.length
                 ? ["", `Ancestors (${ancestors.length} items, root first):`, ...ancestorLines]
                 : []),
             "",
             post.content || "",
+            ...(attachmentLines.length
+                ? ["", `Attachments (${attachmentLines.length}):`, ...attachmentLines]
+                : []),
             "",
             `Replies (${replies.length} items):`,
             ...replyLines,
@@ -277,6 +300,7 @@ export function registerSpaceCommand(program) {
         .description("List posts in a space (paginated).")
         .option("--limit <number>", "Items per page", "20")
         .option("--cursor <string>", "Pagination cursor from previous response")
+        .option("--channel <channelId>", "Channel id to read instead of the main feed (see `list-channels`). Omit for the main feed.")
         .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
         .action(async (opts) => {
         const spaceSlug = resolveSpaceSlug(space, opts);
@@ -285,6 +309,7 @@ export function registerSpaceCommand(program) {
         };
         if (opts.cursor)
             params.cursor = opts.cursor;
+        params.channelId = parseChannelIdOption(opts.channel);
         const resp = (await apiGet(`/spaces/${spaceSlug}/posts`, params));
         if (isJsonMode(space)) {
             jsonOut({
@@ -304,7 +329,8 @@ export function registerSpaceCommand(program) {
         for (const t of items) {
             const author = t.author?.name ||
                 `User ${t.authorId}`;
-            lines.push(`- [${t.id}] "${t.title}" by ${author} (${t.replyCount} replies, ${t.createdAt})`);
+            const attachSummary = formatAttachmentSummary(t);
+            lines.push(`- [${t.id}] "${t.title}" by ${author} (${t.replyCount} replies, ${t.createdAt})${attachSummary ? `  ${attachSummary}` : ""}`);
         }
         const footer = pagination.hasMore ? `\n  Next cursor: ${pagination.nextCursor}` : "";
         console.log(`Posts (${items.length} items):\n` + lines.join("\n") + footer);
@@ -317,8 +343,9 @@ export function registerSpaceCommand(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 artifact create`.", (value, prev = []) => [...prev, value], [])
         .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
-        .option("--attach <file>", "Local media file to attach. Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size ceilings: 5MB photos / 15MB GIFs / 512MB video.", (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 post. Composes with --content / --rich-text / --attach (the wrapping author's text + media render above the embedded card). Reposts-of-reposts are collapsed to the transitive root server-side. The referenced post must exist, not be deleted, and not itself be a reply.")
+        .option("--channel <channelId>", "Channel id to post into (see `list-channels`). Omit to post to the space's main feed. You must be able to see the channel (member, space owner/admin, or the space agent on an agent-enabled channel).")
         .action(async (opts) => {
         if (!opts.content && !opts.richText) {
             throw new Error("Provide either --content or --rich-text.");
@@ -355,6 +382,9 @@ export function registerSpaceCommand(program) {
             }
             body.repostPostId = n;
         }
+        const channelId = parseChannelIdOption(opts.channel);
+        if (channelId != null)
+            body.channelId = channelId;
         const spaceSlug = resolveSpaceSlug(space, opts);
         const resp = (await apiPost(`/spaces/${spaceSlug}/posts`, body));
         const post = unwrapResp(resp);
@@ -376,7 +406,7 @@ export function registerSpaceCommand(program) {
         .option("--content <content>", "New content for the post (markdown supported, use \"-\" for stdin)")
         .option("--rich-text <richText>", "Rich-text JSON array (mutually exclusive with --content)")
         .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
-        .option("--attach <file>", "Replace the post's media attachments with the given files (existing attachments are removed). Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size ceilings: 5MB photos / 15MB GIFs / 512MB video. Omit to leave attachments unchanged.", (value, prev = []) => [...prev, value], [])
+        .option("--attach <file>", "Replace the post's media attachments with the given files (existing attachments are removed). 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. Omit to leave attachments unchanged.", (value, prev = []) => [...prev, value], [])
         .option("--artifact <artifactId>", "Replace the post's artifact attachments with the given artifact(s) (existing artifact attachments are removed). Repeatable. Omit to leave them unchanged. Create artifacts with `gobi artifact create`.", (value, prev = []) => [...prev, value], [])
         .action(async (postId, opts) => {
         const wantsAttachChange = !!(opts.attach && opts.attach.length > 0);
@@ -445,7 +475,7 @@ export function registerSpaceCommand(program) {
         .option("--content <content>", "Reply content (markdown supported, use \"-\" for stdin)")
         .option("--rich-text <richText>", "Rich-text JSON array (mutually exclusive with --content)")
         .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
-        .option("--attach <file>", "Local media file to attach to this reply. Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size ceilings: 5MB photos / 15MB GIFs / 512MB video.", (value, prev = []) => [...prev, value], [])
+        .option("--attach <file>", "Local media or document file to attach to this reply. 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], [])
         .action(async (postId, opts) => {
         if (!opts.content && !opts.richText) {
             throw new Error("Provide either --content or --rich-text.");
@@ -530,4 +560,113 @@ export function registerSpaceCommand(program) {
         }
         console.log(`Reply ${replyId} deleted.`);
     });
+    // ── Reactions (react, unreact) ──
+    space
+        .command("react <postId> <emoji>")
+        .description("Add an emoji reaction to a post or reply (idempotent). <postId> is the numeric id of a post OR a reply — the [p:N]/[r:N] ids shown in feed output.")
+        .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
+        .action(async (postId, emoji, opts) => {
+        const spaceSlug = resolveSpaceSlug(space, opts);
+        const resp = (await apiPut(`/spaces/${spaceSlug}/posts/${postId}/reactions`, { emoji }));
+        const data = unwrapResp(resp);
+        if (isJsonMode(space)) {
+            jsonOut(data);
+            return;
+        }
+        const chips = formatReactionChips(data);
+        console.log(`Reacted ${emoji} to ${postId}.` + (chips ? `\n  Now: ${chips}` : ""));
+    });
+    space
+        .command("unreact <postId> <emoji>")
+        .description("Remove your emoji reaction from a post or reply. <postId> is the numeric id of a post OR a reply.")
+        .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
+        .action(async (postId, emoji, opts) => {
+        const spaceSlug = resolveSpaceSlug(space, opts);
+        const resp = (await apiDelete(`/spaces/${spaceSlug}/posts/${postId}/reactions/${encodeURIComponent(emoji)}`));
+        const data = unwrapResp(resp);
+        if (isJsonMode(space)) {
+            jsonOut(data);
+            return;
+        }
+        const chips = formatReactionChips(data);
+        console.log(`Removed ${emoji} reaction from ${postId}.` +
+            (chips ? `\n  Now: ${chips}` : ""));
+    });
+    // ── Channels (read-only; channel admin is web-UI only) ──
+    //
+    // Private member-gated sub-feeds inside a space. The main feed is virtual
+    // (no channel row): feed/list-posts/create-post without --channel target
+    // it. Members see their channels; space owners/admins see all; the space
+    // agent sees agent-enabled channels only. Create/rename/delete and roster
+    // management are deliberately not exposed here — like space and member
+    // admin, that's web-UI territory.
+    space
+        .command("list-channels")
+        .description("List channels visible to you in a space (members: yours; space owner/admin: all). The main feed is not a channel — read it by omitting --channel on `feed`.")
+        .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
+        .action(async (opts) => {
+        const spaceSlug = resolveSpaceSlug(space, opts);
+        const resp = (await apiGet(`/spaces/${spaceSlug}/channels`));
+        const items = (resp.data || []);
+        if (isJsonMode(space)) {
+            jsonOut(items);
+            return;
+        }
+        if (!items.length) {
+            console.log("No channels found.");
+            return;
+        }
+        const lines = [];
+        for (const c of items) {
+            const flags = [
+                `${c.memberCount} member${c.memberCount === 1 ? "" : "s"}`,
+                c.isMember ? "member: you" : "member: no",
+                c.agentAccess ? "agent: on" : "agent: off",
+            ].join(", ");
+            lines.push(`- [${c.id}] #${c.name} (${flags})`);
+            if (c.description)
+                lines.push(`    Description: ${c.description}`);
+        }
+        console.log(`Channels (${items.length}):\n` + lines.join("\n"));
+    });
+    space
+        .command("get-channel <channelId>")
+        .description("Get one channel (channel members, space owner/admin, or the agent on agent-enabled channels).")
+        .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
+        .action(async (channelId, opts) => {
+        const spaceSlug = resolveSpaceSlug(space, opts);
+        const resp = (await apiGet(`/spaces/${spaceSlug}/channels/${channelId}`));
+        const c = unwrapResp(resp);
+        if (isJsonMode(space)) {
+            jsonOut(c);
+            return;
+        }
+        const desc = c.description ? `\n  Description: ${c.description}` : "";
+        console.log(`Channel [${c.id}] #${c.name}${desc}\n` +
+            `  Agent access: ${c.agentAccess ? "on" : "off"}\n` +
+            `  Created: ${c.createdAt}`);
+    });
+    space
+        .command("list-channel-members <channelId>")
+        .description("List the members of a channel.")
+        .option("--space-slug <spaceSlug>", "Space slug (overrides .gobi/settings.yaml)")
+        .action(async (channelId, opts) => {
+        const spaceSlug = resolveSpaceSlug(space, opts);
+        const resp = (await apiGet(`/spaces/${spaceSlug}/channels/${channelId}/members`));
+        const items = (resp.data || []);
+        if (isJsonMode(space)) {
+            jsonOut(items);
+            return;
+        }
+        if (!items.length) {
+            console.log("No members found.");
+            return;
+        }
+        const lines = [];
+        for (const m of items) {
+            const user = (m.user || {});
+            lines.push(`- [${m.userId}] ${user.name || "Unknown"} (joined ${m.createdAt})`);
+        }
+        console.log(`Channel members (${items.length}):\n` + lines.join("\n"));
+    });
 }

package/dist/commands/utils.js

@@ -28,3 +28,73 @@ export function unwrapResp(resp) {
     }
     return resp;
 }
+// Compact reaction chips for single-line output: `👍2* 🎉1` — the trailing
+// `*` marks emojis the caller has reacted with (remove via `unreact`).
+export function formatReactionChips(m) {
+    const reactions = m.reactions || [];
+    if (!Array.isArray(reactions) || !reactions.length)
+        return "";
+    return reactions
+        .map((r) => `${r.emoji}${r.count}${r.reactedByMe ? "*" : ""}`)
+        .join(" ");
+}
+// Classify a wire attachment the way the clients do: declared mimeType first,
+// then the media-url extension (covers rows that predate the mimeType field).
+function attachmentKind(a) {
+    if (a.artifact)
+        return "artifact";
+    const mime = (a.mimeType || "").toLowerCase();
+    const url = (a.mediaUrl || "").toLowerCase().split("?")[0];
+    if (mime === "image/gif" || (!mime && url.endsWith(".gif")))
+        return "gif";
+    if (mime.startsWith("image/"))
+        return "photo";
+    if (mime.startsWith("video/"))
+        return "video";
+    if (mime)
+        return "file";
+    if (/\.(jpe?g|png|webp|heic|heif|avif|svg|bmp|tiff)$/.test(url))
+        return "photo";
+    if (/\.(mp4|mov|webm|m4v)$/.test(url))
+        return "video";
+    if (/\.(pdf|md|txt|csv)$/.test(url))
+        return "file";
+    return "media";
+}
+// Compact attachment marker for single-line output: `📎 2 photos, 1 file`.
+// Counts per kind; full URLs are in `get-post` (or --json).
+export function formatAttachmentSummary(m) {
+    const attachments = m.attachments || [];
+    if (!Array.isArray(attachments) || !attachments.length)
+        return "";
+    const counts = new Map();
+    for (const a of attachments) {
+        const kind = attachmentKind(a);
+        counts.set(kind, (counts.get(kind) ?? 0) + 1);
+    }
+    const parts = [];
+    for (const [kind, count] of counts) {
+        parts.push(count === 1 ? `1 ${kind}` : `${count} ${kind}s`);
+    }
+    return `📎 ${parts.join(", ")}`;
+}
+// One line per attachment with the fetchable URL — used by `get-post` so an
+// agent can download/describe the media without re-querying in --json mode.
+export function formatAttachmentLines(m, indent = "  ") {
+    const attachments = m.attachments || [];
+    if (!Array.isArray(attachments) || !attachments.length)
+        return [];
+    return attachments.map((a) => {
+        const kind = attachmentKind(a);
+        if (kind === "artifact") {
+            const art = a.artifact;
+            const title = art.title ? ` "${art.title}"` : "";
+            const status = art.isPublished ? "published" : "unpublished";
+            return `${indent}- artifact [${art.kind}]${title} (${art.artifactId}, ${status})${art.mediaUrl ? ` — ${art.mediaUrl}` : ""}`;
+        }
+        const dims = a.width && a.height ? ` ${a.width}×${a.height}` : "";
+        const name = a.fileName ? ` "${a.fileName}"` : "";
+        const mime = a.mimeType ? ` (${a.mimeType})` : "";
+        return `${indent}- ${kind}${name}${dims}${mime} — ${a.mediaUrl}`;
+    });
+}

package/package.json

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

package/skills/gobi-artifact/SKILL.md

@@ -9,12 +9,12 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "2.0.30"
+  version: "2.0.31"
 ---
 
 # gobi-artifact
 
-Gobi artifact commands for versioned, post-attachable creations (v2.0.30).
+Gobi artifact commands for versioned, post-attachable creations (v2.0.31).
 
 Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
 

package/skills/gobi-core/SKILL.md

@@ -8,12 +8,12 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "2.0.30"
+  version: "2.0.31"
 ---
 
 # gobi-core
 
-Core CLI commands for the Gobi collaborative knowledge platform (v2.0.30).
+Core CLI commands for the Gobi collaborative knowledge platform (v2.0.31).
 
 ## Prerequisites
 

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

@@ -6,13 +6,13 @@ Usage: gobi space [options] [command]
 Space commands (posts, replies). Space and member admin is web-UI only.
 
 Options:
-  --space-slug <spaceSlug>                Space slug (overrides .gobi/settings.yaml)
-  -h, --help                              display help for command
+  --space-slug <spaceSlug>                    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.
-  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.
+  help [command]                              display help for command
 ```
 
 ## list

package/skills/gobi-homepage/SKILL.md

@@ -7,7 +7,7 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "2.0.30"
+  version: "2.0.31"
 ---
 
 # Gobi Homepage Developer Guide

package/skills/gobi-media/SKILL.md

@@ -10,12 +10,12 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "2.0.30"
+  version: "2.0.31"
 ---
 
 # gobi-media
 
-Gobi media generation commands (v2.0.30).
+Gobi media generation commands (v2.0.31).
 
 Requires gobi-cli installed and authenticated. See gobi-core skill for setup.
 

package/skills/gobi-sense/SKILL.md

@@ -7,12 +7,12 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "2.0.30"
+  version: "2.0.31"
 ---
 
 # gobi-sense
 
-Gobi sense commands for activity and transcription data (v2.0.30).
+Gobi sense commands for activity and transcription data (v2.0.31).
 
 Requires gobi-cli installed and authenticated. See the **gobi-core** skill for setup.
 

package/skills/gobi-space/SKILL.md

@@ -11,12 +11,12 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "2.0.30"
+  version: "2.0.31"
 ---
 
 # gobi-space
 
-Gobi space, global, and personal-space posts (v2.0.30).
+Gobi space, global, and personal-space posts (v2.0.31).
 
 Requires gobi-cli installed and authenticated. See the **gobi-core** skill for setup.
 
@@ -51,13 +51,15 @@ Posts have no vault attribution. Both `create-post` and `edit-post` across all t
 
 > **Wiki-link uploads moved to artifacts.** The `--auto-attachments` flag that used to upload `[[wiki-linked files]]` from a post body now lives on `gobi artifact create` / `gobi artifact revise` (markdown kinds). To publish a markdown creation with resolvable wikilinks, create a markdown artifact with `--vault-slug` + `--auto-attachments` and attach it to the post (`--post-id`). See the **gobi-artifact** skill. Before relying on wikilink resolution, confirm the anchor vault is published: `gobi --json vault status --vault-slug <slug>` should report `isPublished: true`.
 
-## Post media attachments (`--attach`)
+## Post media + file attachments (`--attach`)
 
-`create-post` and `create-reply` across all three scopes (`gobi space`, `gobi global`, `gobi personal`) accept `--attach <file>` (repeatable) for inline post media — the photos/GIF/video that render in-feed alongside the post body. The CLI uploads each file to S3 via `POST /posts/upload-url` and passes the resulting `{ mediaUrl, mediaKey }` array as the post's `attachments`.
+`create-post` and `create-reply` across all three scopes (`gobi space`, `gobi global`, `gobi personal`) accept `--attach <file>` (repeatable) for inline post attachments — photos/GIF/video that render in-feed alongside the post body, and document files (**pdf/md/txt/csv**) that render as Slack-style file cards. The CLI uploads each file to S3 via `POST /posts/upload-url`; document files additionally carry `fileName` + `mimeType` on the row (the S3 key is a UUID, so that's the only place the original name survives).
 
-X-style mix rule (enforced client-side before upload): up to **4 photos** OR **1 GIF** OR **1 video** — they don't combine. Server-side ceilings: 5MB photos, 15MB GIFs, 512MB video.
+Mix rule (enforced client-side before upload): up to **4 photos + 4 document files** together, OR **1 GIF**, OR **1 video** — GIF and video are exclusive with everything. Size ceilings: 10MB photos, 15MB GIFs, 512MB video, 250MB document files.
 
-Use `--attach` for media you want shown in the post itself; use a markdown **artifact** (`gobi artifact create`) for `[[wikilinks]]`-bearing creations attached to the post.
+Use `--attach` for media/files you want shown in the post itself; use a markdown **artifact** (`gobi artifact create`) for `[[wikilinks]]`-bearing creations attached to the post.
+
+**Reading attachments back:** feed and list lines show a compact marker like `📎 2 photos, 1 file`; `get-post` prints an `Attachments (N):` block with one line per attachment — kind, original fileName, dimensions/MIME, and the fetchable CDN URL (artifact attachments show kind/title/artifactId instead). In `--json` mode the full `attachments` array is on every post/reply object.
 
 ## Public link formats
 
@@ -106,7 +108,7 @@ gobi --json space list-posts
 - `gobi space list-topic-posts` — List posts tagged with a topic in a space (cursor-paginated).
 
 ### Feed
-- `gobi space feed` — List the unified feed (posts and replies, newest first).
+- `gobi space feed` — List the unified feed (posts and replies, newest first). `--channel <channelId>` reads a channel's feed instead of the main feed.
 
 ### Space posts
 - `gobi space list-posts` — List posts in a space (paginated).
@@ -120,6 +122,22 @@ gobi --json space list-posts
 - `gobi space edit-reply <replyId>` — Edit a reply. You must be the author.
 - `gobi space delete-reply <replyId>` — Delete a reply. You must be the author.
 
+### Reactions
+
+Emoji reactions on posts **and** replies, across all three scopes (`gobi space`, `gobi global`, `gobi personal`). The id is the bare number from the `[p:N]`/`[r:N]` ids in feed output. Feed and `get-post` lines render existing reactions as compact chips like `👍2* 🎉1` — the count follows each emoji, and a trailing `*` marks ones you reacted with.
+
+- `gobi space react <postId> <emoji>` — Add a reaction (idempotent; re-reacting with the same emoji is a no-op).
+- `gobi space unreact <postId> <emoji>` — Remove your reaction. Pass the emoji literally (`gobi space unreact 123 👍`).
+
+### Channels (space scope only)
+
+Channels are private, member-gated sub-feeds inside a space. The **main feed is not a channel** — `feed` / `list-posts` / `create-post` without `--channel` target it, as always. Members see their own channels; space owners/admins see all of them; the space agent sees only channels with agent access enabled. Posting into a channel requires being able to see it. Channel administration (create, rename, delete, add/remove members, leave) is web-UI only — like space and member admin, the CLI deliberately doesn't expose it.
+
+- `gobi space list-channels` — List channels visible to you (shows member count, your membership, agent access).
+- `gobi space get-channel <channelId>` — Get one channel's details.
+- `gobi space list-channel-members <channelId>` — List a channel's members.
+- `--channel <channelId>` on `feed`, `list-posts`, and `create-post` reads/writes that channel instead of the main feed.
+
 ### Personal posts (global feed)
 
 `gobi global` is the same surface for Personal Posts — posts that live on the author's profile and surface in the public global feed.
@@ -157,8 +175,9 @@ Most posts and replies are publicly visible — in a community space (`gobi spac
 - `create-post` / `create-reply` — content goes live on submission.
 - `edit-post` / `edit-reply` — confirm the *new* content; people who already saw the original may re-see it.
 - `delete-post` / `delete-reply` — irreversible. Flag that explicitly and confirm the target id before running.
+- `react` / `unreact` are lightweight and reversible — when the user asked for the reaction, no extra confirmation needed.
 
-Read-only commands (`list-posts`, `get-post`, `feed`, `list-topics`, `list-topic-posts`, `get`) run without confirmation.
+Read-only commands (`list-posts`, `get-post`, `feed`, `list-topics`, `list-topic-posts`, `get`, `list-channels`, `get-channel`, `list-channel-members`) run without confirmation.
 
 ## Reference Documentation
 

package/skills/gobi-space/references/global.md

@@ -18,6 +18,8 @@ Commands:
   create-reply [options] <postId>  Create a reply to a post in the global feed.
   edit-reply [options] <replyId>   Edit a reply you authored in the global feed.
   delete-reply <replyId>           Delete a reply you authored in the global feed.
+  react <postId> <emoji>           Add an emoji reaction to a global-feed post or reply (idempotent). <postId> is the numeric id of a post OR a reply — the [p:N]/[r:N] ids shown in feed output.
+  unreact <postId> <emoji>         Remove your emoji reaction from a global-feed post or reply. <postId> is the numeric id of a post OR a reply.
   help [command]                   display help for command
 ```
 
@@ -75,7 +77,8 @@ Options:
   --content <content>        Post content (markdown supported, use "-" for stdin)
   --rich-text <richText>     Rich-text JSON array (mutually exclusive with --content)
   --artifact <artifactId>    Attach an existing artifact to the post (repeatable). Create artifacts with `gobi artifact create`. (default: [])
-  --attach <file>            Local media file to attach. Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size ceilings: 5MB photos / 15MB GIFs / 512MB video. (default: [])
+  --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. (default: [])
   --repost-post-id <postId>  Wrap an existing top-level post as the embedded card on this new post. Composes with --content / --rich-text / --attach (the wrapping author's text + media render above
                              the embedded card). Reposts-of-reposts are collapsed to the transitive root server-side. The referenced post must exist, not be deleted, and not itself be a reply.
   -h, --help                 display help for command
@@ -92,8 +95,8 @@ Options:
   --title <title>          New title
   --content <content>      New content (markdown supported, use "-" for stdin)
   --rich-text <richText>   Rich-text JSON array (mutually exclusive with --content)
-  --attach <file>          Replace the post's media attachments with the given files (existing attachments are removed). Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size
-                           ceilings: 5MB photos / 15MB GIFs / 512MB video. Omit to leave attachments unchanged. (default: [])
+  --attach <file>          Replace the post's media attachments with the given files (existing attachments are removed). 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. Omit to leave attachments unchanged. (default: [])
   --artifact <artifactId>  Replace the post's artifact attachments with the given artifact(s) (existing artifact attachments are removed). Repeatable. Omit to leave them unchanged. Create artifacts
                            with `gobi artifact create`. (default: [])
   -h, --help               display help for command
@@ -120,8 +123,8 @@ Create a reply to a post in the global feed.
 Options:
   --content <content>     Reply content (markdown supported, use "-" for stdin)
   --rich-text <richText>  Rich-text JSON array (mutually exclusive with --content)
-  --attach <file>         Local media file to attach to this reply. Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size ceilings: 5MB photos / 15MB GIFs / 512MB video. (default:
-                          [])
+  --attach <file>         Local media or document file to attach to this reply. 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. (default: [])
   -h, --help              display help for command
 ```
 
@@ -148,3 +151,25 @@ Delete a reply you authored in the global feed.
 Options:
   -h, --help  display help for command
 ```
+
+## react
+
+```
+Usage: gobi global react [options] <postId> <emoji>
+
+Add an emoji reaction to a global-feed post or reply (idempotent). <postId> is the numeric id of a post OR a reply — the [p:N]/[r:N] ids shown in feed output.
+
+Options:
+  -h, --help  display help for command
+```
+
+## unreact
+
+```
+Usage: gobi global unreact [options] <postId> <emoji>
+
+Remove your emoji reaction from a global-feed post or reply. <postId> is the numeric id of a post OR a reply.
+
+Options:
+  -h, --help  display help for command
+```

package/skills/gobi-space/references/personal.md

@@ -19,6 +19,8 @@ Commands:
   create-reply [options] <postId>  Reply to a personal-space post. The reply inherits the parent's private scope automatically.
   edit-reply [options] <replyId>   Edit a reply you authored in your personal space.
   delete-reply <replyId>           Delete a reply you authored in your personal space.
+  react <postId> <emoji>           Add an emoji reaction to a personal-space post or reply (idempotent). <postId> is the numeric id of a post OR a reply.
+  unreact <postId> <emoji>         Remove your emoji reaction from a personal-space post or reply. <postId> is the numeric id of a post OR a reply.
   help [command]                   display help for command
 ```
 
@@ -74,7 +76,8 @@ Options:
   --content <content>        Post content (markdown supported, use "-" for stdin)
   --rich-text <richText>     Rich-text JSON array (mutually exclusive with --content)
   --artifact <artifactId>    Attach an existing artifact to the post (repeatable). Create artifacts with `gobi artifact create`. (default: [])
-  --attach <file>            Local media file to attach. Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size ceilings: 5MB photos / 15MB GIFs / 512MB video. (default: [])
+  --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. (default: [])
   --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.
   -h, --help                 display help for command
@@ -91,8 +94,8 @@ Options:
   --title <title>          New title
   --content <content>      New content (markdown supported, use "-" for stdin)
   --rich-text <richText>   Rich-text JSON array (mutually exclusive with --content)
-  --attach <file>          Replace the post's media attachments with the given files (existing attachments are removed). Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size
-                           ceilings: 5MB photos / 15MB GIFs / 512MB video. Omit to leave attachments unchanged. (default: [])
+  --attach <file>          Replace the post's media attachments with the given files (existing attachments are removed). 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. Omit to leave attachments unchanged. (default: [])
   --artifact <artifactId>  Replace the post's artifact attachments with the given artifact(s) (existing artifact attachments are removed). Repeatable. Omit to leave them unchanged. Create artifacts
                            with `gobi artifact create`. (default: [])
   -h, --help               display help for command
@@ -119,8 +122,8 @@ Reply to a personal-space post. The reply inherits the parent's private scope au
 Options:
   --content <content>     Reply content (markdown supported, use "-" for stdin)
   --rich-text <richText>  Rich-text JSON array (mutually exclusive with --content)
-  --attach <file>         Local media file to attach to this reply. Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size ceilings: 5MB photos / 15MB GIFs / 512MB video. (default:
-                          [])
+  --attach <file>         Local media or document file to attach to this reply. 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. (default: [])
   -h, --help              display help for command
 ```
 
@@ -147,3 +150,25 @@ Delete a reply you authored in your personal space.
 Options:
   -h, --help  display help for command
 ```
+
+## react
+
+```
+Usage: gobi personal react [options] <postId> <emoji>
+
+Add an emoji reaction to a personal-space post or reply (idempotent). <postId> is the numeric id of a post OR a reply.
+
+Options:
+  -h, --help  display help for command
+```
+
+## unreact
+
+```
+Usage: gobi personal unreact [options] <postId> <emoji>
+
+Remove your emoji reaction from a personal-space post or reply. <postId> is the numeric id of a post OR a reply.
+
+Options:
+  -h, --help  display help for command
+```

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

@@ -6,23 +6,29 @@ Usage: gobi space [options] [command]
 Space commands (posts, replies). Space and member admin is web-UI only.
 
 Options:
-  --space-slug <spaceSlug>                Space slug (overrides .gobi/settings.yaml)
-  -h, --help                              display help for command
+  --space-slug <spaceSlug>                    Space slug (overrides .gobi/settings.yaml)
+  -h, --help                                  display help for command
 
 Commands:
-  get [options] [spaceSlug]               Get details for a space. Pass a slug or omit to use the current space (from .gobi/settings.yaml or --space-slug).
-  list-topics [options]                   List topics in a space, ordered by most recent content linkage.
-  list-topic-posts [options] <topicSlug>  List posts tagged with a topic in a space (cursor-paginated).
-  feed [options]                          List the unified feed (posts and replies, newest first) in a space.
-  get-post [options] <postId>             Get a post with its ancestors and replies (paginated).
-  list-posts [options]                    List posts in a space (paginated).
-  create-post [options]                   Create a post in a space.
-  edit-post [options] <postId>            Edit a post you authored in a space.
-  delete-post [options] <postId>          Delete a post you authored in a space.
-  create-reply [options] <postId>         Create a reply to a post in a space.
-  edit-reply [options] <replyId>          Edit a reply you authored in a space.
-  delete-reply [options] <replyId>        Delete a reply you authored in a space.
-  help [command]                          display help for command
+  get [options] [spaceSlug]                   Get details for a space. Pass a slug or omit to use the current space (from .gobi/settings.yaml or --space-slug).
+  list-topics [options]                       List topics in a space, ordered by most recent content linkage.
+  list-topic-posts [options] <topicSlug>      List posts tagged with a topic in a space (cursor-paginated).
+  feed [options]                              List the unified feed (posts and replies, newest first) in a space.
+  get-post [options] <postId>                 Get a post with its ancestors and replies (paginated).
+  list-posts [options]                        List posts in a space (paginated).
+  create-post [options]                       Create a post in a space.
+  edit-post [options] <postId>                Edit a post you authored in a space.
+  delete-post [options] <postId>              Delete a post you authored in a space.
+  create-reply [options] <postId>             Create a reply to a post in a space.
+  edit-reply [options] <replyId>              Edit a reply you authored in a space.
+  delete-reply [options] <replyId>            Delete a reply you authored in a space.
+  react [options] <postId> <emoji>            Add an emoji reaction to a post or reply (idempotent). <postId> is the numeric id of a post OR a reply — the [p:N]/[r:N] ids shown in feed output.
+  unreact [options] <postId> <emoji>          Remove your emoji reaction from a post or reply. <postId> is the numeric id of a post OR a reply.
+  list-channels [options]                     List channels visible to you in a space (members: yours; space owner/admin: all). The main feed is not a channel — read it by omitting --channel on
+                                              `feed`.
+  get-channel [options] <channelId>           Get one channel (channel members, space owner/admin, or the agent on agent-enabled channels).
+  list-channel-members [options] <channelId>  List the members of a channel.
+  help [command]                              display help for command
 ```
 
 ## get
@@ -74,6 +80,7 @@ List the unified feed (posts and replies, newest first) in a space.
 Options:
   --limit <number>          Items per page (default: "20")
   --cursor <string>         Pagination cursor from previous response
+  --channel <channelId>     Channel id to read instead of the main feed (see `list-channels`). Omit for the main feed.
   --space-slug <spaceSlug>  Space slug (overrides .gobi/settings.yaml)
   -h, --help                display help for command
 ```
@@ -103,6 +110,7 @@ List posts in a space (paginated).
 Options:
   --limit <number>          Items per page (default: "20")
   --cursor <string>         Pagination cursor from previous response
+  --channel <channelId>     Channel id to read instead of the main feed (see `list-channels`). Omit for the main feed.
   --space-slug <spaceSlug>  Space slug (overrides .gobi/settings.yaml)
   -h, --help                display help for command
 ```
@@ -120,9 +128,12 @@ Options:
   --rich-text <richText>     Rich-text JSON array (mutually exclusive with --content)
   --artifact <artifactId>    Attach an existing artifact to the post (repeatable). Create artifacts with `gobi artifact create`. (default: [])
   --space-slug <spaceSlug>   Space slug (overrides .gobi/settings.yaml)
-  --attach <file>            Local media file to attach. Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size ceilings: 5MB photos / 15MB GIFs / 512MB video. (default: [])
+  --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. (default: [])
   --repost-post-id <postId>  Wrap an existing top-level post as the embedded card on this new post. Composes with --content / --rich-text / --attach (the wrapping author's text + media render above
                              the embedded card). Reposts-of-reposts are collapsed to the transitive root server-side. The referenced post must exist, not be deleted, and not itself be a reply.
+  --channel <channelId>      Channel id to post into (see `list-channels`). Omit to post to the space's main feed. You must be able to see the channel (member, space owner/admin, or the space agent
+                             on an agent-enabled channel).
   -h, --help                 display help for command
 ```
 
@@ -138,8 +149,8 @@ Options:
   --content <content>       New content for the post (markdown supported, use "-" for stdin)
   --rich-text <richText>    Rich-text JSON array (mutually exclusive with --content)
   --space-slug <spaceSlug>  Space slug (overrides .gobi/settings.yaml)
-  --attach <file>           Replace the post's media attachments with the given files (existing attachments are removed). Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size
-                            ceilings: 5MB photos / 15MB GIFs / 512MB video. Omit to leave attachments unchanged. (default: [])
+  --attach <file>           Replace the post's media attachments with the given files (existing attachments are removed). 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. Omit to leave attachments unchanged. (default: [])
   --artifact <artifactId>   Replace the post's artifact attachments with the given artifact(s) (existing artifact attachments are removed). Repeatable. Omit to leave them unchanged. Create artifacts
                             with `gobi artifact create`. (default: [])
   -h, --help                display help for command
@@ -168,8 +179,8 @@ Options:
   --content <content>       Reply content (markdown supported, use "-" for stdin)
   --rich-text <richText>    Rich-text JSON array (mutually exclusive with --content)
   --space-slug <spaceSlug>  Space slug (overrides .gobi/settings.yaml)
-  --attach <file>           Local media file to attach to this reply. Repeatable. X-style mix rule: up to 4 photos OR 1 GIF OR 1 video. Size ceilings: 5MB photos / 15MB GIFs / 512MB video. (default:
-                            [])
+  --attach <file>           Local media or document file to attach to this reply. 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. (default: [])
   -h, --help                display help for command
 ```
 
@@ -198,3 +209,63 @@ Options:
   --space-slug <spaceSlug>  Space slug (overrides .gobi/settings.yaml)
   -h, --help                display help for command
 ```
+
+## react
+
+```
+Usage: gobi space react [options] <postId> <emoji>
+
+Add an emoji reaction to a post or reply (idempotent). <postId> is the numeric id of a post OR a reply — the [p:N]/[r:N] ids shown in feed output.
+
+Options:
+  --space-slug <spaceSlug>  Space slug (overrides .gobi/settings.yaml)
+  -h, --help                display help for command
+```
+
+## unreact
+
+```
+Usage: gobi space unreact [options] <postId> <emoji>
+
+Remove your emoji reaction from a post or reply. <postId> is the numeric id of a post OR a reply.
+
+Options:
+  --space-slug <spaceSlug>  Space slug (overrides .gobi/settings.yaml)
+  -h, --help                display help for command
+```
+
+## list-channels
+
+```
+Usage: gobi space list-channels [options]
+
+List channels visible to you in a space (members: yours; space owner/admin: all). The main feed is not a channel — read it by omitting --channel on `feed`.
+
+Options:
+  --space-slug <spaceSlug>  Space slug (overrides .gobi/settings.yaml)
+  -h, --help                display help for command
+```
+
+## get-channel
+
+```
+Usage: gobi space get-channel [options] <channelId>
+
+Get one channel (channel members, space owner/admin, or the agent on agent-enabled channels).
+
+Options:
+  --space-slug <spaceSlug>  Space slug (overrides .gobi/settings.yaml)
+  -h, --help                display help for command
+```
+
+## list-channel-members
+
+```
+Usage: gobi space list-channel-members [options] <channelId>
+
+List the members of a channel.
+
+Options:
+  --space-slug <spaceSlug>  Space slug (overrides .gobi/settings.yaml)
+  -h, --help                display help for command
+```

package/skills/gobi-vault/SKILL.md

@@ -8,12 +8,12 @@ description: >-
 allowed-tools: Bash(gobi:*)
 metadata:
   author: gobi-ai
-  version: "2.0.30"
+  version: "2.0.31"
 ---
 
 # gobi-vault
 
-Gobi vault commands for publishing your vault profile and syncing files (v2.0.30).
+Gobi vault commands for publishing your vault profile and syncing files (v2.0.31).
 
 Requires gobi-cli installed and authenticated. See gobi-core skill for setup.