replicas-cli 0.3.72 → 0.3.74

package/dist/index.cjs

@@ -111,17 +111,17 @@ var require_visit = __commonJS({
     visit.BREAK = BREAK;
     visit.SKIP = SKIP;
     visit.REMOVE = REMOVE;
-    function visit_(key, node, visitor, path7) {
-      const ctrl = callVisitor(key, node, visitor, path7);
+    function visit_(key, node, visitor, path8) {
+      const ctrl = callVisitor(key, node, visitor, path8);
       if (identity.isNode(ctrl) || identity.isPair(ctrl)) {
-        replaceNode(key, path7, ctrl);
-        return visit_(key, ctrl, visitor, path7);
+        replaceNode(key, path8, ctrl);
+        return visit_(key, ctrl, visitor, path8);
       }
       if (typeof ctrl !== "symbol") {
         if (identity.isCollection(node)) {
-          path7 = Object.freeze(path7.concat(node));
+          path8 = Object.freeze(path8.concat(node));
           for (let i = 0; i < node.items.length; ++i) {
-            const ci = visit_(i, node.items[i], visitor, path7);
+            const ci = visit_(i, node.items[i], visitor, path8);
             if (typeof ci === "number")
               i = ci - 1;
             else if (ci === BREAK)
@@ -132,13 +132,13 @@ var require_visit = __commonJS({
             }
           }
         } else if (identity.isPair(node)) {
-          path7 = Object.freeze(path7.concat(node));
-          const ck = visit_("key", node.key, visitor, path7);
+          path8 = Object.freeze(path8.concat(node));
+          const ck = visit_("key", node.key, visitor, path8);
           if (ck === BREAK)
             return BREAK;
           else if (ck === REMOVE)
             node.key = null;
-          const cv = visit_("value", node.value, visitor, path7);
+          const cv = visit_("value", node.value, visitor, path8);
           if (cv === BREAK)
             return BREAK;
           else if (cv === REMOVE)
@@ -159,17 +159,17 @@ var require_visit = __commonJS({
     visitAsync.BREAK = BREAK;
     visitAsync.SKIP = SKIP;
     visitAsync.REMOVE = REMOVE;
-    async function visitAsync_(key, node, visitor, path7) {
-      const ctrl = await callVisitor(key, node, visitor, path7);
+    async function visitAsync_(key, node, visitor, path8) {
+      const ctrl = await callVisitor(key, node, visitor, path8);
       if (identity.isNode(ctrl) || identity.isPair(ctrl)) {
-        replaceNode(key, path7, ctrl);
-        return visitAsync_(key, ctrl, visitor, path7);
+        replaceNode(key, path8, ctrl);
+        return visitAsync_(key, ctrl, visitor, path8);
       }
       if (typeof ctrl !== "symbol") {
         if (identity.isCollection(node)) {
-          path7 = Object.freeze(path7.concat(node));
+          path8 = Object.freeze(path8.concat(node));
           for (let i = 0; i < node.items.length; ++i) {
-            const ci = await visitAsync_(i, node.items[i], visitor, path7);
+            const ci = await visitAsync_(i, node.items[i], visitor, path8);
             if (typeof ci === "number")
               i = ci - 1;
             else if (ci === BREAK)
@@ -180,13 +180,13 @@ var require_visit = __commonJS({
             }
           }
         } else if (identity.isPair(node)) {
-          path7 = Object.freeze(path7.concat(node));
-          const ck = await visitAsync_("key", node.key, visitor, path7);
+          path8 = Object.freeze(path8.concat(node));
+          const ck = await visitAsync_("key", node.key, visitor, path8);
           if (ck === BREAK)
             return BREAK;
           else if (ck === REMOVE)
             node.key = null;
-          const cv = await visitAsync_("value", node.value, visitor, path7);
+          const cv = await visitAsync_("value", node.value, visitor, path8);
           if (cv === BREAK)
             return BREAK;
           else if (cv === REMOVE)
@@ -213,23 +213,23 @@ var require_visit = __commonJS({
       }
       return visitor;
     }
-    function callVisitor(key, node, visitor, path7) {
+    function callVisitor(key, node, visitor, path8) {
       if (typeof visitor === "function")
-        return visitor(key, node, path7);
+        return visitor(key, node, path8);
       if (identity.isMap(node))
-        return visitor.Map?.(key, node, path7);
+        return visitor.Map?.(key, node, path8);
       if (identity.isSeq(node))
-        return visitor.Seq?.(key, node, path7);
+        return visitor.Seq?.(key, node, path8);
       if (identity.isPair(node))
-        return visitor.Pair?.(key, node, path7);
+        return visitor.Pair?.(key, node, path8);
       if (identity.isScalar(node))
-        return visitor.Scalar?.(key, node, path7);
+        return visitor.Scalar?.(key, node, path8);
       if (identity.isAlias(node))
-        return visitor.Alias?.(key, node, path7);
+        return visitor.Alias?.(key, node, path8);
       return void 0;
     }
-    function replaceNode(key, path7, node) {
-      const parent = path7[path7.length - 1];
+    function replaceNode(key, path8, node) {
+      const parent = path8[path8.length - 1];
       if (identity.isCollection(parent)) {
         parent.items[key] = node;
       } else if (identity.isPair(parent)) {
@@ -839,10 +839,10 @@ var require_Collection = __commonJS({
     var createNode = require_createNode();
     var identity = require_identity();
     var Node = require_Node();
-    function collectionFromPath(schema, path7, value) {
+    function collectionFromPath(schema, path8, value) {
       let v = value;
-      for (let i = path7.length - 1; i >= 0; --i) {
-        const k = path7[i];
+      for (let i = path8.length - 1; i >= 0; --i) {
+        const k = path8[i];
         if (typeof k === "number" && Number.isInteger(k) && k >= 0) {
           const a = [];
           a[k] = v;
@@ -861,7 +861,7 @@ var require_Collection = __commonJS({
         sourceObjects: /* @__PURE__ */ new Map()
       });
     }
-    var isEmptyPath = (path7) => path7 == null || typeof path7 === "object" && !!path7[Symbol.iterator]().next().done;
+    var isEmptyPath = (path8) => path8 == null || typeof path8 === "object" && !!path8[Symbol.iterator]().next().done;
     var Collection = class extends Node.NodeBase {
       constructor(type, schema) {
         super(type);
@@ -891,11 +891,11 @@ var require_Collection = __commonJS({
        * be a Pair instance or a `{ key, value }` object, which may not have a key
        * that already exists in the map.
        */
-      addIn(path7, value) {
-        if (isEmptyPath(path7))
+      addIn(path8, value) {
+        if (isEmptyPath(path8))
           this.add(value);
         else {
-          const [key, ...rest] = path7;
+          const [key, ...rest] = path8;
           const node = this.get(key, true);
           if (identity.isCollection(node))
             node.addIn(rest, value);
@@ -909,8 +909,8 @@ var require_Collection = __commonJS({
        * Removes a value from the collection.
        * @returns `true` if the item was found and removed.
        */
-      deleteIn(path7) {
-        const [key, ...rest] = path7;
+      deleteIn(path8) {
+        const [key, ...rest] = path8;
         if (rest.length === 0)
           return this.delete(key);
         const node = this.get(key, true);
@@ -924,8 +924,8 @@ var require_Collection = __commonJS({
        * scalar values from their surrounding node; to disable set `keepScalar` to
        * `true` (collections are always returned intact).
        */
-      getIn(path7, keepScalar) {
-        const [key, ...rest] = path7;
+      getIn(path8, keepScalar) {
+        const [key, ...rest] = path8;
         const node = this.get(key, true);
         if (rest.length === 0)
           return !keepScalar && identity.isScalar(node) ? node.value : node;
@@ -943,8 +943,8 @@ var require_Collection = __commonJS({
       /**
        * Checks if the collection includes a value with the key `key`.
        */
-      hasIn(path7) {
-        const [key, ...rest] = path7;
+      hasIn(path8) {
+        const [key, ...rest] = path8;
         if (rest.length === 0)
           return this.has(key);
         const node = this.get(key, true);
@@ -954,8 +954,8 @@ var require_Collection = __commonJS({
        * Sets a value in this collection. For `!!set`, `value` needs to be a
        * boolean to add/remove the item from the set.
        */
-      setIn(path7, value) {
-        const [key, ...rest] = path7;
+      setIn(path8, value) {
+        const [key, ...rest] = path8;
         if (rest.length === 0) {
           this.set(key, value);
         } else {
@@ -3470,9 +3470,9 @@ var require_Document = __commonJS({
           this.contents.add(value);
       }
       /** Adds a value to the document. */
-      addIn(path7, value) {
+      addIn(path8, value) {
         if (assertCollection(this.contents))
-          this.contents.addIn(path7, value);
+          this.contents.addIn(path8, value);
       }
       /**
        * Create a new `Alias` node, ensuring that the target `node` has the required anchor.
@@ -3547,14 +3547,14 @@ var require_Document = __commonJS({
        * Removes a value from the document.
        * @returns `true` if the item was found and removed.
        */
-      deleteIn(path7) {
-        if (Collection.isEmptyPath(path7)) {
+      deleteIn(path8) {
+        if (Collection.isEmptyPath(path8)) {
           if (this.contents == null)
             return false;
           this.contents = null;
           return true;
         }
-        return assertCollection(this.contents) ? this.contents.deleteIn(path7) : false;
+        return assertCollection(this.contents) ? this.contents.deleteIn(path8) : false;
       }
       /**
        * Returns item at `key`, or `undefined` if not found. By default unwraps
@@ -3569,10 +3569,10 @@ var require_Document = __commonJS({
        * scalar values from their surrounding node; to disable set `keepScalar` to
        * `true` (collections are always returned intact).
        */
-      getIn(path7, keepScalar) {
-        if (Collection.isEmptyPath(path7))
+      getIn(path8, keepScalar) {
+        if (Collection.isEmptyPath(path8))
           return !keepScalar && identity.isScalar(this.contents) ? this.contents.value : this.contents;
-        return identity.isCollection(this.contents) ? this.contents.getIn(path7, keepScalar) : void 0;
+        return identity.isCollection(this.contents) ? this.contents.getIn(path8, keepScalar) : void 0;
       }
       /**
        * Checks if the document includes a value with the key `key`.
@@ -3583,10 +3583,10 @@ var require_Document = __commonJS({
       /**
        * Checks if the document includes a value at `path`.
        */
-      hasIn(path7) {
-        if (Collection.isEmptyPath(path7))
+      hasIn(path8) {
+        if (Collection.isEmptyPath(path8))
           return this.contents !== void 0;
-        return identity.isCollection(this.contents) ? this.contents.hasIn(path7) : false;
+        return identity.isCollection(this.contents) ? this.contents.hasIn(path8) : false;
       }
       /**
        * Sets a value in this document. For `!!set`, `value` needs to be a
@@ -3603,13 +3603,13 @@ var require_Document = __commonJS({
        * Sets a value in this document. For `!!set`, `value` needs to be a
        * boolean to add/remove the item from the set.
        */
-      setIn(path7, value) {
-        if (Collection.isEmptyPath(path7)) {
+      setIn(path8, value) {
+        if (Collection.isEmptyPath(path8)) {
           this.contents = value;
         } else if (this.contents == null) {
-          this.contents = Collection.collectionFromPath(this.schema, Array.from(path7), value);
+          this.contents = Collection.collectionFromPath(this.schema, Array.from(path8), value);
         } else if (assertCollection(this.contents)) {
-          this.contents.setIn(path7, value);
+          this.contents.setIn(path8, value);
         }
       }
       /**
@@ -5569,9 +5569,9 @@ var require_cst_visit = __commonJS({
     visit.BREAK = BREAK;
     visit.SKIP = SKIP;
     visit.REMOVE = REMOVE;
-    visit.itemAtPath = (cst, path7) => {
+    visit.itemAtPath = (cst, path8) => {
       let item = cst;
-      for (const [field2, index] of path7) {
+      for (const [field2, index] of path8) {
         const tok = item?.[field2];
         if (tok && "items" in tok) {
           item = tok.items[index];
@@ -5580,23 +5580,23 @@ var require_cst_visit = __commonJS({
       }
       return item;
     };
-    visit.parentCollection = (cst, path7) => {
-      const parent = visit.itemAtPath(cst, path7.slice(0, -1));
-      const field2 = path7[path7.length - 1][0];
+    visit.parentCollection = (cst, path8) => {
+      const parent = visit.itemAtPath(cst, path8.slice(0, -1));
+      const field2 = path8[path8.length - 1][0];
       const coll = parent?.[field2];
       if (coll && "items" in coll)
         return coll;
       throw new Error("Parent collection not found");
     };
-    function _visit(path7, item, visitor) {
-      let ctrl = visitor(item, path7);
+    function _visit(path8, item, visitor) {
+      let ctrl = visitor(item, path8);
       if (typeof ctrl === "symbol")
         return ctrl;
       for (const field2 of ["key", "value"]) {
         const token = item[field2];
         if (token && "items" in token) {
           for (let i = 0; i < token.items.length; ++i) {
-            const ci = _visit(Object.freeze(path7.concat([[field2, i]])), token.items[i], visitor);
+            const ci = _visit(Object.freeze(path8.concat([[field2, i]])), token.items[i], visitor);
             if (typeof ci === "number")
               i = ci - 1;
             else if (ci === BREAK)
@@ -5607,10 +5607,10 @@ var require_cst_visit = __commonJS({
             }
           }
           if (typeof ctrl === "function" && field2 === "key")
-            ctrl = ctrl(item, path7);
+            ctrl = ctrl(item, path8);
         }
       }
-      return typeof ctrl === "function" ? ctrl(item, path7) : ctrl;
+      return typeof ctrl === "function" ? ctrl(item, path8) : ctrl;
     }
     exports2.visit = visit;
   }
@@ -6912,14 +6912,14 @@ var require_parser = __commonJS({
             case "scalar":
             case "single-quoted-scalar":
             case "double-quoted-scalar": {
-              const fs8 = this.flowScalar(this.type);
+              const fs9 = this.flowScalar(this.type);
               if (atNextItem || it.value) {
-                map2.items.push({ start, key: fs8, sep: [] });
+                map2.items.push({ start, key: fs9, sep: [] });
                 this.onKeyLine = true;
               } else if (it.sep) {
-                this.stack.push(fs8);
+                this.stack.push(fs9);
               } else {
-                Object.assign(it, { key: fs8, sep: [] });
+                Object.assign(it, { key: fs9, sep: [] });
                 this.onKeyLine = true;
               }
               return;
@@ -7047,13 +7047,13 @@ var require_parser = __commonJS({
             case "scalar":
             case "single-quoted-scalar":
             case "double-quoted-scalar": {
-              const fs8 = this.flowScalar(this.type);
+              const fs9 = this.flowScalar(this.type);
               if (!it || it.value)
-                fc.items.push({ start: [], key: fs8, sep: [] });
+                fc.items.push({ start: [], key: fs9, sep: [] });
               else if (it.sep)
-                this.stack.push(fs8);
+                this.stack.push(fs9);
               else
-                Object.assign(it, { key: fs8, sep: [] });
+                Object.assign(it, { key: fs9, sep: [] });
               return;
             }
             case "flow-map-end":
@@ -8577,10 +8577,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path7) {
-  if (!path7)
+function getElementAtPath(obj, path8) {
+  if (!path8)
     return obj;
-  return path7.reduce((acc, key) => acc?.[key], obj);
+  return path8.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -8989,11 +8989,11 @@ function explicitlyAborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path7, issues) {
+function prefixIssues(path8, issues) {
   return issues.map((iss) => {
     var _a3;
     (_a3 = iss).path ?? (_a3.path = []);
-    iss.path.unshift(path7);
+    iss.path.unshift(path8);
     return iss;
   });
 }
@@ -9140,16 +9140,16 @@ function flattenError(error51, mapper = (issue2) => issue2.message) {
 }
 function formatError(error51, mapper = (issue2) => issue2.message) {
   const fieldErrors = { _errors: [] };
-  const processError = (error52, path7 = []) => {
+  const processError = (error52, path8 = []) => {
     for (const issue2 of error52.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path7, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path8, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path7, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path8, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path7, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path8, ...issue2.path]);
       } else {
-        const fullpath = [...path7, ...issue2.path];
+        const fullpath = [...path8, ...issue2.path];
         if (fullpath.length === 0) {
           fieldErrors._errors.push(mapper(issue2));
         } else {
@@ -9176,17 +9176,17 @@ function formatError(error51, mapper = (issue2) => issue2.message) {
 }
 function treeifyError(error51, mapper = (issue2) => issue2.message) {
   const result = { errors: [] };
-  const processError = (error52, path7 = []) => {
+  const processError = (error52, path8 = []) => {
     var _a3, _b;
     for (const issue2 of error52.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path7, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path8, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path7, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path8, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path7, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path8, ...issue2.path]);
       } else {
-        const fullpath = [...path7, ...issue2.path];
+        const fullpath = [...path8, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -9218,8 +9218,8 @@ function treeifyError(error51, mapper = (issue2) => issue2.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path7 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path7) {
+  const path8 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path8) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -21911,13 +21911,13 @@ function resolveRef(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path7 = ref.slice(1).split("/").filter(Boolean);
-  if (path7.length === 0) {
+  const path8 = ref.slice(1).split("/").filter(Boolean);
+  if (path8.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path7[0] === defsKey) {
-    const key = path7[1];
+  if (path8[0] === defsKey) {
+    const key = path8[1];
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -23279,11 +23279,11 @@ function parseShellScript(script, cwd) {
   parseUntil(scope, 0, false);
   return scope.commands;
 }
-function resolveShellPath(dir, path7) {
-  if (path7.includes(SHELL_OPAQUE) || path7.startsWith("~")) return null;
-  if (!path7.startsWith("/") && dir === null) return null;
+function resolveShellPath(dir, path8) {
+  if (path8.includes(SHELL_OPAQUE) || path8.startsWith("~")) return null;
+  if (!path8.startsWith("/") && dir === null) return null;
   const parts = [];
-  for (const part of (path7.startsWith("/") ? path7 : `${dir}/${path7}`).split("/")) {
+  for (const part of (path8.startsWith("/") ? path8 : `${dir}/${path8}`).split("/")) {
     if (part === "..") parts.pop();
     else if (part && part !== ".") parts.push(part);
   }
@@ -23637,8 +23637,8 @@ function parseSkillName(tool, input) {
   const skillName = parsedInput.skill ?? parsedInput.name;
   return typeof skillName === "string" && skillName ? skillName : null;
 }
-function skillNameFromFilePath(path7) {
-  const parts = path7.split(/[\\/]+/).filter(Boolean);
+function skillNameFromFilePath(path8) {
+  const parts = path8.split(/[\\/]+/).filter(Boolean);
   if (parts.length < 2 || parts[parts.length - 1].toLowerCase() !== "skill.md") return null;
   const skillName = parts[parts.length - 2];
   return /[*?[\]{}…$]/.test(skillName) || ["skills", ".system"].includes(skillName.toLowerCase()) ? null : skillName;
@@ -23648,19 +23648,19 @@ function skillFilePath(tool, input) {
   if (!READ_TOOL_NAMES.has(tool.toLowerCase())) return null;
   const parsedInput = typeof input === "string" ? safeJsonParse(input, null) : input;
   if (!isRecord(parsedInput)) return null;
-  const path7 = [parsedInput.path, parsedInput.filePath, parsedInput.file_path].find((value) => typeof value === "string" && value.length > 0);
-  return path7 && skillNameFromFilePath(path7) ? path7 : null;
+  const path8 = [parsedInput.path, parsedInput.filePath, parsedInput.file_path].find((value) => typeof value === "string" && value.length > 0);
+  return path8 && skillNameFromFilePath(path8) ? path8 : null;
 }
 function createCallDisplayMessage(message2) {
   if (message2.inputRequest) return { ...message2, type: "tool_call" };
-  const path7 = skillFilePath(message2.tool, message2.input);
-  const skillName = message2.server.toLowerCase() === "skills" ? message2.tool : path7 ? skillNameFromFilePath(path7) : parseSkillName(message2.tool, message2.input);
+  const path8 = skillFilePath(message2.tool, message2.input);
+  const skillName = message2.server.toLowerCase() === "skills" ? message2.tool : path8 ? skillNameFromFilePath(path8) : parseSkillName(message2.tool, message2.input);
   if (skillName === null) return { ...message2, type: "tool_call" };
   return {
     id: message2.id,
     type: "skill",
     skillName,
-    ...path7 ? { path: path7 } : {},
+    ...path8 ? { path: path8 } : {},
     status: message2.status,
     timestamp: message2.timestamp
   };
@@ -23673,11 +23673,11 @@ function insertDisplayMessageByTimestamp(messages, message2) {
 }
 
 // ../shared/src/display-message/format.ts
-function fileContentDiff(path7, content, action) {
+function fileContentDiff(path8, content, action) {
   const lines = content.replace(/\n$/, "").split("\n");
   return [
-    `--- ${action === "add" ? "/dev/null" : `a/${path7}`}`,
-    `+++ ${action === "add" ? `b/${path7}` : "/dev/null"}`,
+    `--- ${action === "add" ? "/dev/null" : `a/${path8}`}`,
+    `+++ ${action === "add" ? `b/${path8}` : "/dev/null"}`,
     action === "add" ? `@@ -0,0 +1,${lines.length} @@` : `@@ -1,${lines.length} +0,0 @@`,
     ...lines.map((line) => `${action === "add" ? "+" : "-"}${line}`)
   ].join("\n");
@@ -23704,7 +23704,7 @@ var LINE_COUNT_VALUE_FLAGS = /* @__PURE__ */ new Set([
 ]);
 var SCRIPT_ROOT = "/
";
 var commandName = (argv) => argv[0].split("/").pop() ?? argv[0];
-var fileWrites = ({ writes }) => writes.filter(({ path: path7 }) => path7 !== "/dev/null");
+var fileWrites = ({ writes }) => writes.filter(({ path: path8 }) => path8 !== "/dev/null");
 function shellCommands(command) {
   return parseShellScript(command, SCRIPT_ROOT).filter(({ wrapper }) => !wrapper);
 }
@@ -23716,8 +23716,8 @@ function skillNamesFromCommand(command) {
     if (!SKILL_READ_COMMANDS.has(name) || writesFiles(name, argv) || fileWrites(shellCommand).length > 0) return [];
     const paths = readCommandPaths(name, argv);
     const stdinTarget = shellCommand.stdinTarget?.replaceAll(SHELL_OPAQUE, "\u2026");
-    return (paths.length === 0 && stdinTarget ? [stdinTarget] : paths).flatMap((path7) => {
-      const resolved = path7.startsWith("~") ? path7 : resolveShellPath(shellCommand.dir, path7)?.replace(SCRIPT_ROOT, "");
+    return (paths.length === 0 && stdinTarget ? [stdinTarget] : paths).flatMap((path8) => {
+      const resolved = path8.startsWith("~") ? path8 : resolveShellPath(shellCommand.dir, path8)?.replace(SCRIPT_ROOT, "");
       const skillName = resolved && skillNameFromFilePath(resolved);
       return skillName ? [skillName] : [];
     });
@@ -24197,7 +24197,7 @@ Starts an ffmpeg screen recorder and returns only after ffmpeg has written the f
 Only one recording at a time. Re-running \`start\` while one is active fails - call \`stop\` first.
 
 ### \`replicas computer record stop\`
-SIGINTs ffmpeg, verifies that the process has finalized the MP4, then prints the output path. A finalization timeout preserves the recording state so \`stop\` can be retried safely. Upload it with \`replicas media upload <path> --name "<name>"\` to share it.
+SIGINTs ffmpeg, verifies that the process has finalized the MP4, then prints the output path. A finalization timeout preserves the recording state so \`stop\` can be retried safely. To show the interaction in a PR or message, turn it into a short looping GIF with \`replicas media gif <path>\`, then upload with \`replicas media upload <path> --name "<name>"\`.
 
 ## Patterns
 
@@ -24242,9 +24242,10 @@ For tasks the user wants proof of:
 replicas computer record start /tmp/walkthrough.mp4
 # ... your work ...
 replicas computer record stop
-replicas media upload /tmp/walkthrough.mp4 --name "Walkthrough recording"
+replicas media gif /tmp/walkthrough.mp4 --duration 8
+replicas media upload /tmp/walkthrough.gif /tmp/walkthrough.mp4 --name "Walkthrough" --name "Walkthrough recording"
 \`\`\`
-Then embed the printed \`![\u2026](\u2026)\` line in your chat reply and follow \`MEDIA.md\` for any external destination.
+Then embed the printed \`![\u2026](\u2026)\` lines in your chat reply and follow \`MEDIA.md\` for any external destination: the GIF goes inline in PRs, and a grid of extracted frames never does.
 
 ## Failure modes
 
@@ -24886,7 +24887,7 @@ gh pr review 123 --request-changes --body "Changes needed"
 
 ## Media in GitHub workflows
 
-Media delivery is owned by \`references/MEDIA.md\`. Read its GitHub section before adding screenshots, recordings, diagrams, or HTML reports to a pull request, issue, review comment, or commit; it covers the public links every image upload prints, recording previews, organization-only HTML links, and the required **View in Replicas** link.
+Media delivery is owned by \`references/MEDIA.md\`. Read it before adding screenshots, GIFs, recordings, diagrams, or HTML reports to a pull request, issue, review comment, or commit; it covers when to use a GIF instead of screenshots, the public links every image upload prints, recording previews, organization-only HTML links, and the required **View in Replicas** link.
 `;
 var GITHUB_ABILITY = {
   label: "GitHub",
@@ -25069,24 +25070,74 @@ var LINEAR_ABILITY = {
 
 // ../shared/src/default-skills/replicas-agent/abilities/media.ts
 var SECTION7 = `### Media
-Deliver screenshots, screen recordings, generated diagrams, audio clips, and self-contained HTML pages to the Replicas dashboard and, when applicable, inline in the destination workflow.
+Deliver screenshots, GIFs, screen recordings, generated diagrams, audio clips, and self-contained HTML pages to the Replicas dashboard and, when applicable, inline in the destination workflow.
 
 **Reference:** \`references/MEDIA.md\`
 
 Use this when:
 - You are about to run \`replicas media upload\`; this reference owns the complete Replicas-first, destination-second workflow
 - You produce a screenshot, recording, generated image, or audio clip the user should see
+- You need to show motion or an interaction (an animation, a popup that moves, a flow) in a PR or message: make a short looping GIF with \`replicas media gif\`, never a grid of frames
 - You produce a self-contained HTML report that should be linked from a pull request
 - You record video output (browser automation, screen capture) \u2014 including the recommended aspect ratio and FPS
 - You need to embed media in a Slack/Linear/GitHub/GitLab message AND keep a referenceable copy in the Replicas dashboard`;
-var REFERENCE7 = `# Media (Screenshots, Recordings, Audio, HTML)
+var REFERENCE7 = `# Media (Screenshots, GIFs, Recordings, Audio, HTML)
 
-This is the single source of truth for delivering screenshots, screen recordings, generated diagrams, audio clips, and self-contained HTML pages through Replicas and external surfaces (Slack, Linear, GitHub, GitLab).
+This is the single source of truth for delivering screenshots, GIFs, screen recordings, generated diagrams, audio clips, and self-contained HTML pages through Replicas and external surfaces (Slack, Linear, GitHub, GitLab).
 
 ## Prerequisites
 
 The \`replicas\` CLI is pre-installed and authenticated in your workspace. No additional setup is needed.
 
+## Screenshot, GIF, or recording
+
+Pick the format from what the reader has to see:
+
+- **Static UI** (a layout, a new button, an error message): still screenshots.
+- **Motion or an interaction** (an animation, a popup that moves or flickers, a drag, a short multi-step flow): a short looping GIF. It plays inline in GitHub, Slack, Linear, GitLab, and Replicas chat, with no click and no sign-in.
+- **A long walkthrough, or anything with sound**: the MP4 recording, shown as a GIF or poster that links to it (see GitHub below).
+
+Never paste a contact sheet or grid of frames extracted from a recording, and never paste a run of separate frame screenshots. At PR width each frame is a thumbnail, and the reader can't tell what moved. Make a GIF instead.
+
+### Make a GIF from a recording
+
+\`\`\`bash
+replicas computer record start /tmp/after.mp4 --fps 30
+# ... perform only the interaction ...
+replicas computer record stop
+replicas media gif /tmp/after.mp4 --start 1 --duration 6
+replicas media upload /tmp/after.gif --name "Language menu after fix"
+\`\`\`
+
+\`replicas media gif <recording>\` takes any MP4, WebM, or MOV (desktop, Playwright, CDP screencast, or simulator recordings) and writes a looping GIF next to it (\`-o\` to choose the path). It starts at 12 fps and 960 px wide and lowers both until the file is under 5 MiB. GitHub's image proxy returns 404 for larger images, so a bigger GIF shows as a broken image in the PR.
+
+- Keep it to the interaction, usually 3\u201310 seconds: \`--start\` and \`--duration\` (default 10, max 30).
+- When the change is small on a large screen, \`--crop w:h:x:y\` (recording pixels) to the area that changes so text stays readable. Use the same crop for the before and after GIFs.
+- If it reports the GIF is still too large, show less: a shorter \`--duration\` or a tighter \`--crop\`.
+- Upload the GIF like any image. Its printed \`![\u2026](\u2026)\` line is public and renders inline everywhere.
+- Older workspaces may not have \`replicas media gif\` yet (\`replicas media gif --help\` fails). Use the same ffmpeg settings directly; keep \`-ss\` and \`-t\` before \`-i\` (palettegen waits for its input to end, so trimming after \`-i\` never finishes), and if the file is over 5 MiB, lower \`fps\` and the width and run it again:
+
+\`\`\`bash
+ffmpeg -v error -y -ss 1 -t 6 -i /tmp/after.mp4 \\
+  -vf "fps=12,scale='min(960,iw)':-1:flags=lanczos,split[a][b];[a]palettegen=stats_mode=diff[p];[b][p]paletteuse=dither=bayer:bayer_scale=5:diff_mode=rectangle" \\
+  -loop 0 /tmp/after.gif
+\`\`\`
+
+ffmpeg is baked into the workspace image. If it's missing, install it with \`sudo apt-get install -y ffmpeg\`.
+
+### Before and after
+
+Record both with the same steps, window size, and crop. Say in one line what to watch for, then put the GIFs side by side in a table, or in labeled sections when they are wide:
+
+\`\`\`markdown
+The menu should open on its trigger. Before, it jumps about 95px up in half the openings.
+
+| Before | After |
+| --- | --- |
+| ![Language menu before fix](<before-gif-url>) | ![Language menu after fix](<after-gif-url>) |
+| [View in Replicas](<before-dashboard-url>) | [View in Replicas](<after-dashboard-url>) |
+\`\`\`
+
 ## When to upload
 
 Upload to Replicas in these cases \u2014 and **only** these cases:
@@ -25113,7 +25164,7 @@ If none of these apply, don't upload.
 | Slack | \`files.getUploadURLExternal\` \u2192 raw-byte POST \u2192 \`files.completeUploadExternal\` | Uploaded file in the channel or thread |
 | Linear | \`fileUpload\` mutation \u2192 presigned upload \u2192 issue/comment mutation | Returned \`assetUrl\` in Markdown |
 | GitLab | Project \`/uploads\` endpoint with the original bytes | Returned GitLab Markdown |
-| GitHub | Printed public embed for an image or recording poster | Printed embed, linked to the recording when needed |
+| GitHub | Printed public embed for an image, GIF, or recording poster | Printed embed, linked to the recording when needed |
 
 The dashboard link is the subtitle and jump-back path. It is never a substitute for the destination embed.
 
@@ -25318,7 +25369,7 @@ jq -n \\
     }' | linear_graphql
 \`\`\`
 
-For a recording, upload the MP4 with its own MIME type, then upload a poster frame (\`ffmpeg -i /tmp/demo.mp4 -frames:v 1 /tmp/demo-poster.png\`) the same way as \`image/png\` and link it: \`[![Demo recording](<poster-asset-url>)](<recording-asset-url>)\`.
+To show motion, upload the GIF from \`replicas media gif\` this way as \`image/gif\` and embed its \`assetUrl\` like a screenshot. For a full recording, upload the MP4 with its own MIME type, then upload a poster frame (\`ffmpeg -i /tmp/demo.mp4 -frames:v 1 /tmp/demo-poster.png\`) the same way as \`image/png\` and link it: \`[![Demo recording](<poster-asset-url>)](<recording-asset-url>)\`.
 
 The same flow works for issue bodies (use \`issueCreate\` / \`issueUpdate\` with the same markdown body).
 
@@ -25343,10 +25394,10 @@ gh pr edit 456 --body-file /tmp/pr-body.md
 gh pr comment 456 --body-file /tmp/comment.md
 \`\`\`
 
-Videos stay private, and GitHub does not play external videos inline. Upload the MP4 normally, generate a poster with \`ffmpeg -i /tmp/demo.mp4 -frames:v 1 /tmp/demo-poster.png\`, upload the poster like any image, and link its printed embed to the recording's **View in Replicas** URL:
+GitHub does not play external videos inline, so show motion with a GIF (see *Make a GIF from a recording* above); its printed embed animates inline like any image. Videos stay private. When the full recording is also worth watching, upload the MP4 too and link the GIF to the recording's **View in Replicas** URL. When a still is enough, use a poster instead (\`ffmpeg -i /tmp/demo.mp4 -frames:v 1 /tmp/demo-poster.png\`), uploaded like any image:
 
 \`\`\`markdown
-[![Demo recording](<public-poster-url>)](<recording-dashboard-url>)
+[![Checkout flow](<public-gif-or-poster-url>)](<recording-dashboard-url>)
 \`\`\`
 
 Public links are unauthenticated bearer capabilities. Revoke with \`replicas media revoke <media-id>\` **only** when the user asks or the media should intentionally stop rendering; never as routine post-task cleanup, since revoking breaks every embed already posted on the PR.
@@ -25378,13 +25429,15 @@ const context = await browser.newContext({
 
 For \`ffmpeg\` screen captures, pass \`-r 30\` (or \`-r 60\`) to set the frame rate.
 
+Start recording just before the interaction and stop right after it, so the GIF made from it stays short.
+
 ## Supported formats
 
 Auto-detected from the filename extension:
 
 | Extension | Kind |
 |---|---|
-| \`png\`, \`jpg\`, \`jpeg\`, \`webp\` | image |
+| \`png\`, \`jpg\`, \`jpeg\`, \`webp\`, \`gif\` | image |
 | \`mp4\`, \`webm\` | video |
 | \`mp3\`, \`wav\` | audio |
 | \`html\`, \`htm\` | html |
@@ -25407,7 +25460,7 @@ replicas media upload chart-a.svg chart-b.svg --name "Latency chart" --name "Err
 var MEDIA_ABILITY = {
   label: "Media",
   description: "Deliver media to Replicas and destination workflows with inline uploads.",
-  bullet: "- Producing or showing the user any media \u2014 screenshots, screen recordings, generated images or diagrams, audio clips, or HTML recap pages \u2014 including in your Replicas chat reply, PR descriptions/comments, and other external platforms. Paste the printed `![\u2026](\u2026)` embeds in your chat reply, never only dashboard links, and upload the file itself to Slack, Linear, or GitLab",
+  bullet: "- Producing or showing the user any media \u2014 screenshots, screen recordings, generated images or diagrams, audio clips, or HTML recap pages \u2014 including in your Replicas chat reply, PR descriptions/comments, and other external platforms. Paste the printed `![\u2026](\u2026)` embeds in your chat reply, never only dashboard links, and upload the file itself to Slack, Linear, or GitLab. To show motion, turn the recording into a short GIF with `replicas media gif` instead of a grid of frames",
   section: SECTION7,
   referenceFile: { name: "MEDIA.md", content: REFERENCE7 }
 };
@@ -26392,7 +26445,7 @@ function stripAttachmentNote(text3) {
   }
   return {
     content,
-    files: match ? [...match[1].matchAll(/^- (.+)$/gm)].map(([, path7]) => path7) : [],
+    files: match ? [...match[1].matchAll(/^- (.+)$/gm)].map(([, path8]) => path8) : [],
     walkthroughs
   };
 }
@@ -27278,7 +27331,7 @@ function parseOpencodeEvents(events) {
         upsertDisplayMessage(messages, {
           id,
           type: "file_change",
-          changes: files.map((path7) => ({ path: path7, kind: "update" })),
+          changes: files.map((path8) => ({ path: path8, kind: "update" })),
           status: "completed",
           timestamp
         });
@@ -28593,7 +28646,7 @@ var headlessAgentRequestSchema = external_exports.object({
 });
 
 // ../shared/src/cli-version.ts
-var CLI_VERSION = "0.3.72";
+var CLI_VERSION = "0.3.74";
 
 // ../shared/src/version.ts
 function compareVersions(v1, v2) {
@@ -31074,8 +31127,8 @@ async function claudeAuthCommand(options = {}) {
 var CLIENT_ID = "1031625952748946";
 var AUTH_URL = "https://auth.meta.com";
 var API_KEY_URL = "https://api.meta.ai/muse-code/key";
-async function post(path7, body) {
-  return fetch(`${AUTH_URL}${path7}`, {
+async function post(path8, body) {
+  return fetch(`${AUTH_URL}${path8}`, {
     method: "POST",
     headers: { "Content-Type": "application/x-www-form-urlencoded" },
     body
@@ -31271,7 +31324,7 @@ async function credentialsGetCommand(service, options) {
   });
 }
 async function credentialsSetCommand(service, options) {
-  const path7 = credentialsPath(service, options, true);
+  const path8 = credentialsPath(service, options, true);
   const { org: org2, models, ...fields } = options;
   const secretField = service === "bedrock" ? "aws_secret_access_key" : "api_key";
   const body = {
@@ -31279,7 +31332,7 @@ async function credentialsSetCommand(service, options) {
     ...models ? { models: models.split(",").map((model2) => model2.trim()).filter(Boolean) } : {},
     [secretField]: await readSecret(service, secretField === "api_key" ? "API key" : "AWS secret access key")
   };
-  const response = await orgAuthenticatedFetch(path7, { method: "POST", body });
+  const response = await orgAuthenticatedFetch(path8, { method: "POST", body });
   output(response, () => console.log(import_chalk17.default.green(`Saved ${scopeLabel(options)} ${service} credentials.`)));
 }
 async function credentialsRemoveCommand(service, options) {
@@ -31364,10 +31417,9 @@ function printEnvironment(env) {
   if (env.description) {
     console.log(import_chalk19.default.gray(`    Description: ${env.description}`));
   }
-  if (env.repository_id) {
-    console.log(import_chalk19.default.gray(`    Repository: ${env.repository_id}`));
-  } else if (env.repository_set_id) {
-    console.log(import_chalk19.default.gray(`    Repository Set: ${env.repository_set_id}`));
+  const repositoryIds = env.repository_ids ?? [];
+  if (repositoryIds.length > 0) {
+    console.log(import_chalk19.default.gray(`    Repositories: ${repositoryIds.join(", ")}`));
   }
   if (env.variable_count !== void 0) {
     console.log(import_chalk19.default.gray(`    Variables: ${env.variable_count}, Files: ${env.file_count ?? 0}, Skills: ${env.skill_count ?? 0}, MCPs: ${env.mcp_count ?? 0}`));
@@ -32088,7 +32140,7 @@ async function replicaCreateCommand(name, options) {
       choices: environments.map((env) => ({
         title: env.name,
         value: env.id,
-        description: env.is_global ? "global" : env.repository_set_id ? "repository set" : env.repository_id ? "repository" : "unbound"
+        description: env.is_global ? "global" : `${env.repository_ids?.length ?? 0} repositories`
       }))
     });
     const answer = response2.environment;
@@ -32564,7 +32616,7 @@ async function canvasPutCommand(id, filename, options) {
 
 // src/commands/chat.ts
 var import_chalk23 = __toESM(require("chalk"));
-var chatPath2 = (id, chatId, path7 = "") => `/v1/replica/${id}/chats/${chatId}${path7}`;
+var chatPath2 = (id, chatId, path8 = "") => `/v1/replica/${id}/chats/${chatId}${path8}`;
 function printQueue(queue) {
   if (queue.length === 0) {
     console.log("Queue is empty.");
@@ -32649,8 +32701,8 @@ async function chatQueueListCommand(id, chatId) {
     printQueue(queue);
   });
 }
-async function mutateQueue(path7, method, body) {
-  output(await orgAuthenticatedFetch(path7, { method, body }), ({ queue }) => {
+async function mutateQueue(path8, method, body) {
+  output(await orgAuthenticatedFetch(path8, { method, body }), ({ queue }) => {
     if (queue) printQueue(queue);
     else console.log("Done.");
   });
@@ -32663,7 +32715,7 @@ var chatQueueActionCommand = (action) => (id, chatId, messageId) => mutateQueue(
 
 // src/commands/plugins.ts
 var import_chalk24 = __toESM(require("chalk"));
-var pluginsPath = async ({ env }, path7) => env ? `/v1/environments/${await resolveEnvironmentId(env)}/plugins${path7}` : `/v1/plugins${path7}`;
+var pluginsPath = async ({ env }, path8) => env ? `/v1/environments/${await resolveEnvironmentId(env)}/plugins${path8}` : `/v1/plugins${path8}`;
 async function pluginsListCommand(options) {
   output(await orgAuthenticatedFetch(await pluginsPath(options, "/connections")), ({ plugins: plugins2, environment: environment2 }) => {
     if (!options.all && environment2.length === 0) console.log("No plugins connected. Pass --all to list available plugins.");
@@ -33393,7 +33445,7 @@ async function automationCreateCommand(name, options) {
       choices: selectableEnvs.map((env) => ({
         title: env.name,
         value: env.id,
-        description: env.description || (env.repository_id ? "repo-bound" : env.repository_set_id ? "set-bound" : "unbound")
+        description: env.description || `${env.repository_ids?.length ?? 0} repositories`
       }))
     });
     if (!envResponse2.env) {
@@ -33718,10 +33770,10 @@ var import_chalk27 = __toESM(require("chalk"));
 
 // src/lib/agent-api.ts
 var ENGINE_PORT = process.env.REPLICAS_ENGINE_PORT || "3737";
-async function agentFetch(path7, options) {
-  return (await agentRequest(path7, options)).json();
+async function agentFetch(path8, options) {
+  return (await agentRequest(path8, options)).json();
 }
-async function agentRequest(path7, options) {
+async function agentRequest(path8, options) {
   const config3 = readAgentConfig();
   if (!config3) {
     throw new Error("Agent mode config not found");
@@ -33735,7 +33787,7 @@ async function agentRequest(path7, options) {
     ...options?.headers || {}
   };
   const body = options?.body === void 0 ? void 0 : isFormData ? options.body : JSON.stringify(options.body);
-  const response = await fetch(`${MONOLITH_URL}${path7}`, {
+  const response = await fetch(`${MONOLITH_URL}${path8}`, {
     ...options,
     headers,
     body
@@ -33746,7 +33798,7 @@ async function agentRequest(path7, options) {
   }
   return response;
 }
-async function engineFetch(path7, options) {
+async function engineFetch(path8, options) {
   const config3 = readAgentConfig();
   if (!config3) {
     throw new Error("Agent mode config not found");
@@ -33756,7 +33808,7 @@ async function engineFetch(path7, options) {
     "Content-Type": "application/json",
     ...options?.headers || {}
   };
-  const response = await fetch(`http://localhost:${ENGINE_PORT}${path7}`, {
+  const response = await fetch(`http://localhost:${ENGINE_PORT}${path8}`, {
     ...options,
     headers,
     body: options?.body !== void 0 ? JSON.stringify(options.body) : void 0
@@ -34029,6 +34081,87 @@ async function mediaUrlCommand(mediaId) {
   output(response, ({ url: url2 }) => console.log(url2));
 }
 
+// src/commands/media-gif.ts
+var import_child_process4 = require("child_process");
+var import_fs8 = __toESM(require("fs"));
+var import_path7 = __toESM(require("path"));
+var import_util3 = require("util");
+var GIF_MAX_BYTES = 5 * 1024 * 1024;
+var GIF_ATTEMPTS = 4;
+var execFileAsync = (0, import_util3.promisify)(import_child_process4.execFile);
+function parseOption(value, fallback, flag, min, max) {
+  const parsed = value === void 0 ? fallback : Number(value);
+  if (!Number.isFinite(parsed) || parsed < min || parsed > max) {
+    throw new Error(`${flag} must be between ${min} and ${max}, got '${value}'`);
+  }
+  return parsed;
+}
+function gifFilter({ fps, width, crop }) {
+  return [
+    crop && `crop=${crop}`,
+    `fps=${fps}`,
+    `scale='min(${width},iw)':-1:flags=lanczos`,
+    // stats_mode=diff spends the palette on what moves, and diff_mode=rectangle only re-encodes changed areas.
+    "split[a][b];[a]palettegen=stats_mode=diff[p];[b][p]paletteuse=dither=bayer:bayer_scale=5:diff_mode=rectangle"
+  ].filter(Boolean).join(",");
+}
+async function mediaGifCommand(input, options) {
+  const source = import_path7.default.resolve(input);
+  if (!import_fs8.default.existsSync(source) || !import_fs8.default.statSync(source).isFile()) throw new Error(`File not found: ${source}`);
+  const target = import_path7.default.resolve(options.output ?? `${source.replace(/\.[^./]+$/, "")}.gif`);
+  if (import_path7.default.extname(target).toLowerCase() !== ".gif") throw new Error("--output must end in .gif");
+  if (target === source) throw new Error("--output must differ from the input file");
+  if (options.crop && !/^\d+:\d+:\d+:\d+$/.test(options.crop)) {
+    throw new Error(`--crop must be width:height:x:y in pixels of the recording, got '${options.crop}'`);
+  }
+  const start = parseOption(options.start, 0, "--start", 0, 24 * 60 * 60);
+  const duration3 = parseOption(options.duration, 10, "--duration", 1, 30);
+  const maxWidth = parseOption(options.width, 960, "--width", 200, 1280);
+  const maxFps = parseOption(options.fps, 12, "--fps", 5, 20);
+  const temp = import_path7.default.join(import_path7.default.dirname(target), `.${import_path7.default.basename(target, ".gif")}.${process.pid}.tmp.gif`);
+  let fps = maxFps;
+  let width = maxWidth;
+  try {
+    for (let attempt = 0; attempt < GIF_ATTEMPTS; attempt++) {
+      fps = Math.max(5, Math.round(maxFps * 0.8 ** attempt));
+      width = Math.round(maxWidth * 0.8 ** attempt);
+      await execFileAsync("ffmpeg", [
+        "-v",
+        "error",
+        "-y",
+        "-ss",
+        String(start),
+        "-t",
+        String(duration3),
+        "-i",
+        source,
+        "-vf",
+        gifFilter({ fps, width, crop: options.crop }),
+        "-loop",
+        "0",
+        temp
+      ], { timeout: 18e4 }).catch((error51) => {
+        if (error51.code === "ENOENT") throw new Error("ffmpeg is not installed. Install it with `sudo apt-get install -y ffmpeg`.");
+        throw new Error(`ffmpeg failed: ${error51.stderr?.trim() || error51.message}`);
+      });
+      const size = import_fs8.default.statSync(temp).size;
+      if (size <= GIF_MAX_BYTES) {
+        import_fs8.default.renameSync(temp, target);
+        output({ path: target, size, fps, maxWidth: width, start, duration: duration3 }, () => {
+          console.log(`GIF: ${target} (${(size / 1024 / 1024).toFixed(1)} MiB, ${fps} fps, up to ${width}px wide, ${duration3}s from ${start}s, loops)`);
+          console.log(`Next: replicas media upload ${target} --name "<what it shows>", then paste the printed ![\u2026](\u2026) line in your reply and the PR.`);
+        });
+        return;
+      }
+    }
+  } finally {
+    import_fs8.default.rmSync(temp, { force: true });
+  }
+  throw new Error(
+    `The GIF is still over GitHub's 5 MiB limit at ${fps} fps and ${width}px wide. Show less: a shorter --duration with --start at the interaction, or --crop to the area that changes.`
+  );
+}
+
 // src/commands/history.ts
 var import_node_fs2 = require("fs");
 var import_node_path2 = require("path");
@@ -34557,6 +34690,7 @@ if (isAgentMode()) {
   service.command("stop <name>").description("Stop a service and its whole process group").action(run(serviceStopCommand));
   service.command("list").description("List registered services and whether they are running").action(run(serviceListCommand));
   service.command("logs <name>").description("Print the last lines of a service log").option("-n, --lines <n>", "Number of lines to print (default 50)").action(run(serviceLogsCommand));
+  media.command("gif <recording>").description("Turn a screen recording into a short looping GIF under GitHub's 5 MiB image limit, lowering fps and width until it fits").option("-o, --output <path>", "Output .gif path (default: the recording path with .gif)").option("--start <seconds>", "Where the GIF starts in the recording (default 0)").option("--duration <seconds>", "Length in seconds, 1-30 (default 10)").option("--width <px>", "Maximum width, 200-1280 (default 960)").option("--fps <n>", "Maximum frame rate, 5-20 (default 12)").option("--crop <w:h:x:y>", "Crop to the region that changes, in recording pixels, before scaling").action(run(mediaGifCommand));
   media.command("upload <files...>").description("Upload one or more image, video, audio, or HTML files. Multiple files are uploaded concurrently.").option("-k, --kind <kind>", "Media kind: image, video, audio, or html (inferred from extension if omitted)").option("-s, --session-id <id>", "Session ID to associate the asset with").option(
     "-n, --name <name>",
     "Required human-facing display name shown in the dashboard. Pass one --name per file, in order.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "replicas-cli",
-  "version": "0.3.72",
+  "version": "0.3.74",
   "description": "CLI for managing Replicas workspaces - SSH into cloud dev environments with automatic port forwarding",
   "main": "dist/index.cjs",
   "bin": {