yarkr-cli 1.0.5 → 1.0.6

package/README.md

@@ -4,8 +4,8 @@ Install skills, agents and MCP toolsets from [Yarkr](https://yarkr.com) into the
 Claude Code, Codex, opencode, Cursor and more.
 
 ```sh
-npx yarkr-cli add posterus-ltd/code-review-checklist     # a public package, no account needed (Node 22 or newer)
-npx yarkr-cli add posterus-ltd/github --harness codex    # pick the harnesses to write
+npx yarkr-cli add anthropics/frontend-design                # a public package, no account needed (Node 22 or newer)
+npx yarkr-cli add anthropics/webapp-testing --harness codex # pick the harnesses to write
 ```
 
 With `npx`, the command is always `npx yarkr-cli …`. Installed globally (`npm install -g yarkr-cli`), it answers to
@@ -17,11 +17,11 @@ An ark is a curated set of skills, agents and toolsets hosted in the registry. `
 the harness's own layout (`~/.claude/skills/…`, `~/.agents/…`, MCP configs and so on):
 
 ```sh
-npx yarkr-cli arks                                    # list public arks
-npx yarkr-cli sync acme/starter                       # install one into this folder
-npx yarkr-cli sync acme/starter -g                    # …or into your home directory
-npx yarkr-cli sync acme/starter --harness claude-code # only write Claude Code's files
-npx yarkr-cli ark                                     # what your arks give you, and which version
+npx yarkr-cli arks                                         # list public arks
+npx yarkr-cli sync anthropics/skills                       # install one into this folder
+npx yarkr-cli sync anthropics/skills -g                    # …or into your home directory
+npx yarkr-cli sync anthropics/skills --harness claude-code # only write Claude Code's files
+npx yarkr-cli ark                                          # what your arks give you, and which version
 ```
 
 Signed in, a bare `npx yarkr-cli sync` installs every ark you're a member of, plus your personal ark. Run it again to
@@ -36,7 +36,7 @@ releases:
 ```sh
 cd my-repo
 npx yarkr-cli init --ark acme/engineering            # optional: install a team's ark into this project
-npx yarkr-cli add posterus-ltd/playwright-test-authoring
+npx yarkr-cli add anthropics/mcp-builder
 git add yarkr.json yarkr.lock .yarkrrc .claude AGENTS.md && git commit
 npx yarkr-cli sync --check                           # in CI: exit 1 when anything is out of date
 ```
@@ -64,4 +64,4 @@ npx yarkr-cli whoami                 # check who you're signed in as
 In CI, store a read-only token as a secret and set `YARKR_TOKEN`. The CLI uses the public hub at `https://yarkr.com`
 unless you point it at your own instance with `npx yarkr-cli login --registry <url>`.
 
-Docs: [docs/cli.md](https://github.com/posterus-ltd/yarkr-public/blob/main/docs/cli.md) · Source: [github.com/posterus-ltd/yarkr-public](https://github.com/posterus-ltd/yarkr-public) · MIT
+Full command reference: [yarkr.com/docs/install-with-the-cli](https://yarkr.com/docs/install-with-the-cli) · All docs: [yarkr.com/docs](https://yarkr.com/docs)

package/dist/yarkr.js

@@ -1206,7 +1206,7 @@ var require_command = __commonJS({
     "use strict";
     var EventEmitter = __require("events").EventEmitter;
     var childProcess = __require("child_process");
-    var path19 = __require("path");
+    var path20 = __require("path");
     var fs = __require("fs");
     var process2 = __require("process");
     var { Argument: Argument2, humanReadableArgName } = require_argument();
@@ -2219,9 +2219,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
         let launchWithNode = false;
         const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
         function findFile(baseDir, baseName) {
-          const localBin = path19.resolve(baseDir, baseName);
+          const localBin = path20.resolve(baseDir, baseName);
           if (fs.existsSync(localBin)) return localBin;
-          if (sourceExt.includes(path19.extname(baseName))) return void 0;
+          if (sourceExt.includes(path20.extname(baseName))) return void 0;
           const foundExt = sourceExt.find(
             (ext) => fs.existsSync(`${localBin}${ext}`)
           );
@@ -2239,17 +2239,17 @@ Expecting one of '${allowedValues.join("', '")}'`);
           } catch {
             resolvedScriptPath = this._scriptPath;
           }
-          executableDir = path19.resolve(
-            path19.dirname(resolvedScriptPath),
+          executableDir = path20.resolve(
+            path20.dirname(resolvedScriptPath),
             executableDir
           );
         }
         if (executableDir) {
           let localFile = findFile(executableDir, executableFile);
           if (!localFile && !subcommand._executableFile && this._scriptPath) {
-            const legacyName = path19.basename(
+            const legacyName = path20.basename(
               this._scriptPath,
-              path19.extname(this._scriptPath)
+              path20.extname(this._scriptPath)
             );
             if (legacyName !== this._name) {
               localFile = findFile(
@@ -2260,7 +2260,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
           }
           executableFile = localFile || executableFile;
         }
-        launchWithNode = sourceExt.includes(path19.extname(executableFile));
+        launchWithNode = sourceExt.includes(path20.extname(executableFile));
         let proc;
         if (process2.platform !== "win32") {
           if (launchWithNode) {
@@ -3175,7 +3175,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @return {Command}
        */
       nameFromFilename(filename) {
-        this._name = path19.basename(filename, path19.extname(filename));
+        this._name = path20.basename(filename, path20.extname(filename));
         return this;
       }
       /**
@@ -3189,9 +3189,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [path]
        * @return {(string|null|Command)}
        */
-      executableDir(path20) {
-        if (path20 === void 0) return this._executableDir;
-        this._executableDir = path20;
+      executableDir(path21) {
+        if (path21 === void 0) return this._executableDir;
+        this._executableDir = path21;
         return this;
       }
       /**
@@ -3547,17 +3547,17 @@ var require_visit = __commonJS({
     visit2.BREAK = BREAK;
     visit2.SKIP = SKIP2;
     visit2.REMOVE = REMOVE;
-    function visit_(key, node2, visitor, path19) {
-      const ctrl = callVisitor(key, node2, visitor, path19);
+    function visit_(key, node2, visitor, path20) {
+      const ctrl = callVisitor(key, node2, visitor, path20);
       if (identity.isNode(ctrl) || identity.isPair(ctrl)) {
-        replaceNode(key, path19, ctrl);
-        return visit_(key, ctrl, visitor, path19);
+        replaceNode(key, path20, ctrl);
+        return visit_(key, ctrl, visitor, path20);
       }
       if (typeof ctrl !== "symbol") {
         if (identity.isCollection(node2)) {
-          path19 = Object.freeze(path19.concat(node2));
+          path20 = Object.freeze(path20.concat(node2));
           for (let i = 0; i < node2.items.length; ++i) {
-            const ci = visit_(i, node2.items[i], visitor, path19);
+            const ci = visit_(i, node2.items[i], visitor, path20);
             if (typeof ci === "number")
               i = ci - 1;
             else if (ci === BREAK)
@@ -3568,13 +3568,13 @@ var require_visit = __commonJS({
             }
           }
         } else if (identity.isPair(node2)) {
-          path19 = Object.freeze(path19.concat(node2));
-          const ck = visit_("key", node2.key, visitor, path19);
+          path20 = Object.freeze(path20.concat(node2));
+          const ck = visit_("key", node2.key, visitor, path20);
           if (ck === BREAK)
             return BREAK;
           else if (ck === REMOVE)
             node2.key = null;
-          const cv = visit_("value", node2.value, visitor, path19);
+          const cv = visit_("value", node2.value, visitor, path20);
           if (cv === BREAK)
             return BREAK;
           else if (cv === REMOVE)
@@ -3595,17 +3595,17 @@ var require_visit = __commonJS({
     visitAsync.BREAK = BREAK;
     visitAsync.SKIP = SKIP2;
     visitAsync.REMOVE = REMOVE;
-    async function visitAsync_(key, node2, visitor, path19) {
-      const ctrl = await callVisitor(key, node2, visitor, path19);
+    async function visitAsync_(key, node2, visitor, path20) {
+      const ctrl = await callVisitor(key, node2, visitor, path20);
       if (identity.isNode(ctrl) || identity.isPair(ctrl)) {
-        replaceNode(key, path19, ctrl);
-        return visitAsync_(key, ctrl, visitor, path19);
+        replaceNode(key, path20, ctrl);
+        return visitAsync_(key, ctrl, visitor, path20);
       }
       if (typeof ctrl !== "symbol") {
         if (identity.isCollection(node2)) {
-          path19 = Object.freeze(path19.concat(node2));
+          path20 = Object.freeze(path20.concat(node2));
           for (let i = 0; i < node2.items.length; ++i) {
-            const ci = await visitAsync_(i, node2.items[i], visitor, path19);
+            const ci = await visitAsync_(i, node2.items[i], visitor, path20);
             if (typeof ci === "number")
               i = ci - 1;
             else if (ci === BREAK)
@@ -3616,13 +3616,13 @@ var require_visit = __commonJS({
             }
           }
         } else if (identity.isPair(node2)) {
-          path19 = Object.freeze(path19.concat(node2));
-          const ck = await visitAsync_("key", node2.key, visitor, path19);
+          path20 = Object.freeze(path20.concat(node2));
+          const ck = await visitAsync_("key", node2.key, visitor, path20);
           if (ck === BREAK)
             return BREAK;
           else if (ck === REMOVE)
             node2.key = null;
-          const cv = await visitAsync_("value", node2.value, visitor, path19);
+          const cv = await visitAsync_("value", node2.value, visitor, path20);
           if (cv === BREAK)
             return BREAK;
           else if (cv === REMOVE)
@@ -3649,23 +3649,23 @@ var require_visit = __commonJS({
       }
       return visitor;
     }
-    function callVisitor(key, node2, visitor, path19) {
+    function callVisitor(key, node2, visitor, path20) {
       if (typeof visitor === "function")
-        return visitor(key, node2, path19);
+        return visitor(key, node2, path20);
       if (identity.isMap(node2))
-        return visitor.Map?.(key, node2, path19);
+        return visitor.Map?.(key, node2, path20);
       if (identity.isSeq(node2))
-        return visitor.Seq?.(key, node2, path19);
+        return visitor.Seq?.(key, node2, path20);
       if (identity.isPair(node2))
-        return visitor.Pair?.(key, node2, path19);
+        return visitor.Pair?.(key, node2, path20);
       if (identity.isScalar(node2))
-        return visitor.Scalar?.(key, node2, path19);
+        return visitor.Scalar?.(key, node2, path20);
       if (identity.isAlias(node2))
-        return visitor.Alias?.(key, node2, path19);
+        return visitor.Alias?.(key, node2, path20);
       return void 0;
     }
-    function replaceNode(key, path19, node2) {
-      const parent = path19[path19.length - 1];
+    function replaceNode(key, path20, node2) {
+      const parent = path20[path20.length - 1];
       if (identity.isCollection(parent)) {
         parent.items[key] = node2;
       } else if (identity.isPair(parent)) {
@@ -4277,10 +4277,10 @@ var require_Collection = __commonJS({
     var createNode = require_createNode();
     var identity = require_identity();
     var Node = require_Node();
-    function collectionFromPath(schema, path19, value) {
+    function collectionFromPath(schema, path20, value) {
       let v = value;
-      for (let i = path19.length - 1; i >= 0; --i) {
-        const k = path19[i];
+      for (let i = path20.length - 1; i >= 0; --i) {
+        const k = path20[i];
         if (typeof k === "number" && Number.isInteger(k) && k >= 0) {
           const a = [];
           a[k] = v;
@@ -4299,7 +4299,7 @@ var require_Collection = __commonJS({
         sourceObjects: /* @__PURE__ */ new Map()
       });
     }
-    var isEmptyPath = (path19) => path19 == null || typeof path19 === "object" && !!path19[Symbol.iterator]().next().done;
+    var isEmptyPath = (path20) => path20 == null || typeof path20 === "object" && !!path20[Symbol.iterator]().next().done;
     var Collection = class extends Node.NodeBase {
       constructor(type, schema) {
         super(type);
@@ -4329,11 +4329,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(path19, value) {
-        if (isEmptyPath(path19))
+      addIn(path20, value) {
+        if (isEmptyPath(path20))
           this.add(value);
         else {
-          const [key, ...rest] = path19;
+          const [key, ...rest] = path20;
           const node2 = this.get(key, true);
           if (identity.isCollection(node2))
             node2.addIn(rest, value);
@@ -4347,8 +4347,8 @@ var require_Collection = __commonJS({
        * Removes a value from the collection.
        * @returns `true` if the item was found and removed.
        */
-      deleteIn(path19) {
-        const [key, ...rest] = path19;
+      deleteIn(path20) {
+        const [key, ...rest] = path20;
         if (rest.length === 0)
           return this.delete(key);
         const node2 = this.get(key, true);
@@ -4362,8 +4362,8 @@ var require_Collection = __commonJS({
        * scalar values from their surrounding node; to disable set `keepScalar` to
        * `true` (collections are always returned intact).
        */
-      getIn(path19, keepScalar) {
-        const [key, ...rest] = path19;
+      getIn(path20, keepScalar) {
+        const [key, ...rest] = path20;
         const node2 = this.get(key, true);
         if (rest.length === 0)
           return !keepScalar && identity.isScalar(node2) ? node2.value : node2;
@@ -4381,8 +4381,8 @@ var require_Collection = __commonJS({
       /**
        * Checks if the collection includes a value with the key `key`.
        */
-      hasIn(path19) {
-        const [key, ...rest] = path19;
+      hasIn(path20) {
+        const [key, ...rest] = path20;
         if (rest.length === 0)
           return this.has(key);
         const node2 = this.get(key, true);
@@ -4392,8 +4392,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(path19, value) {
-        const [key, ...rest] = path19;
+      setIn(path20, value) {
+        const [key, ...rest] = path20;
         if (rest.length === 0) {
           this.set(key, value);
         } else {
@@ -6908,9 +6908,9 @@ var require_Document = __commonJS({
           this.contents.add(value);
       }
       /** Adds a value to the document. */
-      addIn(path19, value) {
+      addIn(path20, value) {
         if (assertCollection(this.contents))
-          this.contents.addIn(path19, value);
+          this.contents.addIn(path20, value);
       }
       /**
        * Create a new `Alias` node, ensuring that the target `node` has the required anchor.
@@ -6985,14 +6985,14 @@ var require_Document = __commonJS({
        * Removes a value from the document.
        * @returns `true` if the item was found and removed.
        */
-      deleteIn(path19) {
-        if (Collection.isEmptyPath(path19)) {
+      deleteIn(path20) {
+        if (Collection.isEmptyPath(path20)) {
           if (this.contents == null)
             return false;
           this.contents = null;
           return true;
         }
-        return assertCollection(this.contents) ? this.contents.deleteIn(path19) : false;
+        return assertCollection(this.contents) ? this.contents.deleteIn(path20) : false;
       }
       /**
        * Returns item at `key`, or `undefined` if not found. By default unwraps
@@ -7007,10 +7007,10 @@ var require_Document = __commonJS({
        * scalar values from their surrounding node; to disable set `keepScalar` to
        * `true` (collections are always returned intact).
        */
-      getIn(path19, keepScalar) {
-        if (Collection.isEmptyPath(path19))
+      getIn(path20, keepScalar) {
+        if (Collection.isEmptyPath(path20))
           return !keepScalar && identity.isScalar(this.contents) ? this.contents.value : this.contents;
-        return identity.isCollection(this.contents) ? this.contents.getIn(path19, keepScalar) : void 0;
+        return identity.isCollection(this.contents) ? this.contents.getIn(path20, keepScalar) : void 0;
       }
       /**
        * Checks if the document includes a value with the key `key`.
@@ -7021,10 +7021,10 @@ var require_Document = __commonJS({
       /**
        * Checks if the document includes a value at `path`.
        */
-      hasIn(path19) {
-        if (Collection.isEmptyPath(path19))
+      hasIn(path20) {
+        if (Collection.isEmptyPath(path20))
           return this.contents !== void 0;
-        return identity.isCollection(this.contents) ? this.contents.hasIn(path19) : false;
+        return identity.isCollection(this.contents) ? this.contents.hasIn(path20) : false;
       }
       /**
        * Sets a value in this document. For `!!set`, `value` needs to be a
@@ -7041,13 +7041,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(path19, value) {
-        if (Collection.isEmptyPath(path19)) {
+      setIn(path20, value) {
+        if (Collection.isEmptyPath(path20)) {
           this.contents = value;
         } else if (this.contents == null) {
-          this.contents = Collection.collectionFromPath(this.schema, Array.from(path19), value);
+          this.contents = Collection.collectionFromPath(this.schema, Array.from(path20), value);
         } else if (assertCollection(this.contents)) {
-          this.contents.setIn(path19, value);
+          this.contents.setIn(path20, value);
         }
       }
       /**
@@ -9008,9 +9008,9 @@ var require_cst_visit = __commonJS({
     visit2.BREAK = BREAK;
     visit2.SKIP = SKIP2;
     visit2.REMOVE = REMOVE;
-    visit2.itemAtPath = (cst, path19) => {
+    visit2.itemAtPath = (cst, path20) => {
       let item = cst;
-      for (const [field, index2] of path19) {
+      for (const [field, index2] of path20) {
         const tok = item?.[field];
         if (tok && "items" in tok) {
           item = tok.items[index2];
@@ -9019,23 +9019,23 @@ var require_cst_visit = __commonJS({
       }
       return item;
     };
-    visit2.parentCollection = (cst, path19) => {
-      const parent = visit2.itemAtPath(cst, path19.slice(0, -1));
-      const field = path19[path19.length - 1][0];
+    visit2.parentCollection = (cst, path20) => {
+      const parent = visit2.itemAtPath(cst, path20.slice(0, -1));
+      const field = path20[path20.length - 1][0];
       const coll = parent?.[field];
       if (coll && "items" in coll)
         return coll;
       throw new Error("Parent collection not found");
     };
-    function _visit(path19, item, visitor) {
-      let ctrl = visitor(item, path19);
+    function _visit(path20, item, visitor) {
+      let ctrl = visitor(item, path20);
       if (typeof ctrl === "symbol")
         return ctrl;
       for (const field of ["key", "value"]) {
         const token = item[field];
         if (token && "items" in token) {
           for (let i = 0; i < token.items.length; ++i) {
-            const ci = _visit(Object.freeze(path19.concat([[field, i]])), token.items[i], visitor);
+            const ci = _visit(Object.freeze(path20.concat([[field, i]])), token.items[i], visitor);
             if (typeof ci === "number")
               i = ci - 1;
             else if (ci === BREAK)
@@ -9046,10 +9046,10 @@ var require_cst_visit = __commonJS({
             }
           }
           if (typeof ctrl === "function" && field === "key")
-            ctrl = ctrl(item, path19);
+            ctrl = ctrl(item, path20);
         }
       }
-      return typeof ctrl === "function" ? ctrl(item, path19) : ctrl;
+      return typeof ctrl === "function" ? ctrl(item, path20) : ctrl;
     }
     exports.visit = visit2;
   }
@@ -16023,8 +16023,8 @@ var require_utils = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path19) {
-      let input2 = path19;
+    function removeDotSegments(path20) {
+      let input2 = path20;
       const output3 = [];
       let nextSlash = -1;
       let len = 0;
@@ -16433,8 +16433,8 @@ var require_schemes = __commonJS({
       }
       if (wsComponent.resourceName) {
         const queryIndex = wsComponent.resourceName.indexOf("?");
-        const path19 = queryIndex === -1 ? wsComponent.resourceName : wsComponent.resourceName.slice(0, queryIndex);
-        wsComponent.path = path19 && path19 !== "/" ? path19 : void 0;
+        const path20 = queryIndex === -1 ? wsComponent.resourceName : wsComponent.resourceName.slice(0, queryIndex);
+        wsComponent.path = path20 && path20 !== "/" ? path20 : void 0;
         wsComponent.query = queryIndex === -1 ? void 0 : wsComponent.resourceName.slice(queryIndex + 1);
         wsComponent.resourceName = void 0;
       }
@@ -19644,7 +19644,7 @@ var require_ajv = __commonJS({
 });
 
 // src/index.ts
-import path18 from "path";
+import path19 from "path";
 
 // ../../node_modules/.pnpm/commander@14.0.3/node_modules/commander/esm.mjs
 var import_index = __toESM(require_commander(), 1);
@@ -20479,10 +20479,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path19) {
-  if (!path19)
+function getElementAtPath(obj, path20) {
+  if (!path20)
     return obj;
-  return path19.reduce((acc, key) => acc?.[key], obj);
+  return path20.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -20822,11 +20822,11 @@ function explicitlyAborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path19, issues) {
+function prefixIssues(path20, issues) {
   return issues.map((iss) => {
     var _a3;
     (_a3 = iss).path ?? (_a3.path = []);
-    iss.path.unshift(path19);
+    iss.path.unshift(path20);
     return iss;
   });
 }
@@ -21276,16 +21276,16 @@ function flattenError(error62, mapper = (issue2) => issue2.message) {
 }
 function formatError(error62, mapper = (issue2) => issue2.message) {
   const fieldErrors = { _errors: [] };
-  const processError = (error63, path19 = []) => {
+  const processError = (error63, path20 = []) => {
     for (const issue2 of error63.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path19, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path20, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path19, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path20, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path19, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path20, ...issue2.path]);
       } else {
-        const fullpath = [...path19, ...issue2.path];
+        const fullpath = [...path20, ...issue2.path];
         if (fullpath.length === 0) {
           fieldErrors._errors.push(mapper(issue2));
         } else {
@@ -21324,17 +21324,17 @@ function formatError(error62, mapper = (issue2) => issue2.message) {
 }
 function treeifyError(error62, mapper = (issue2) => issue2.message) {
   const result = { errors: [] };
-  const processError = (error63, path19 = []) => {
+  const processError = (error63, path20 = []) => {
     var _a3;
     for (const issue2 of error63.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path19, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path20, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path19, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path20, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path19, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path20, ...issue2.path]);
       } else {
-        const fullpath = [...path19, ...issue2.path];
+        const fullpath = [...path20, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -21373,8 +21373,8 @@ function treeifyError(error62, mapper = (issue2) => issue2.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path19 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path19) {
+  const path20 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path20) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -38476,13 +38476,13 @@ function resolveRef(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path19 = ref.slice(1).split("/").filter(Boolean);
-  if (path19.length === 0) {
+  const path20 = ref.slice(1).split("/").filter(Boolean);
+  if (path20.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path19[0] === defsKey) {
-    const key = path19[1] === void 0 ? void 0 : decodeJSONPointerSegment(path19[1]);
+  if (path20[0] === defsKey) {
+    const key = path20[1] === void 0 ? void 0 : decodeJSONPointerSegment(path20[1]);
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -39765,8 +39765,8 @@ var Api = class {
     this.conn = conn;
   }
   conn;
-  async request(method, path19, body, { allow404 = false } = {}) {
-    const url2 = `${this.conn.server}/api/v1${path19}`;
+  async request(method, path20, body, { allow404 = false } = {}) {
+    const url2 = `${this.conn.server}/api/v1${path20}`;
     let res;
     try {
       res = await fetch(url2, {
@@ -39788,7 +39788,7 @@ var Api = class {
         payload = await res.json();
       } catch {
       }
-      const msg = payload.message ?? `${method} ${path19} failed with HTTP ${res.status}.`;
+      const msg = payload.message ?? `${method} ${path20} failed with HTTP ${res.status}.`;
       if (res.status === 401) {
         throw new CliError(
           msg,
@@ -39879,17 +39879,17 @@ function parseManifest(text) {
   }
   return manifest;
 }
-function parseEvalSuite(text, path19 = "suite") {
+function parseEvalSuite(text, path20 = "suite") {
   let raw;
   try {
     raw = import_yaml.default.parse(text);
   } catch (err) {
-    throw new ManifestError(`${path19} is not valid YAML: ${err.message}`);
+    throw new ManifestError(`${path20} is not valid YAML: ${err.message}`);
   }
   const res = EvalSuite.safeParse(raw);
   if (!res.success) {
     const issues = res.error.issues.map((i) => ({ path: i.path.join("."), message: i.message }));
-    throw new ManifestError(`${path19} is invalid: ${issues.map((i) => `${i.path}: ${i.message}`).join("; ")}`, issues);
+    throw new ManifestError(`${path20} is invalid: ${issues.map((i) => `${i.path}: ${i.message}`).join("; ")}`, issues);
   }
   return res.data;
 }
@@ -39946,8 +39946,8 @@ function asText(content) {
     return null;
   return typeof content === "string" ? content : new TextDecoder().decode(content);
 }
-function isYarkrOnly(path19) {
-  return path19 === MANIFEST_FILE || path19 === INDEX_FILE || path19.startsWith("evals/") || path19.startsWith("fixtures/");
+function isYarkrOnly(path20) {
+  return path20 === MANIFEST_FILE || path20 === INDEX_FILE || path20.startsWith("evals/") || path20.startsWith("fixtures/");
 }
 function skillEntryPath(m) {
   return m.entry ?? "SKILL.md";
@@ -39975,10 +39975,10 @@ ${body.replace(/^\n+/, "")}`);
 function skillFolderFiles(pkg, dir, folderName) {
   const entry = skillEntryPath(pkg.manifest);
   const files = [{ package: pkg.manifest.name, path: join(dir, folderName, "SKILL.md"), content: renderSkillMd(pkg, folderName) }];
-  for (const [path19, content] of Object.entries(pkg.files)) {
-    if (path19 === entry || path19 === "SKILL.md" || isYarkrOnly(path19))
+  for (const [path20, content] of Object.entries(pkg.files)) {
+    if (path20 === entry || path20 === "SKILL.md" || isYarkrOnly(path20))
       continue;
-    files.push({ package: pkg.manifest.name, path: join(dir, folderName, path19), content });
+    files.push({ package: pkg.manifest.name, path: join(dir, folderName, path20), content });
   }
   return files;
 }
@@ -40072,13 +40072,13 @@ function nativeFolderHarness(o) {
     ...o.mcp ? {
       toolsets(servers, ctx) {
         const mcp = o.mcp;
-        const path19 = ctx.layout[slot];
-        if (!path19) {
+        const path20 = ctx.layout[slot];
+        if (!path20) {
           if (mcp.unavailable)
             ctx.out.notes.push(mcp.unavailable(servers));
           return;
         }
-        ctx.out.mcp.push({ path: path19, key: mcp.key, servers: Object.fromEntries(servers.map(({ pkg, server }) => [server.name, mcp.entry(pkg, server, ctx.out.notes)])) });
+        ctx.out.mcp.push({ path: path20, key: mcp.key, servers: Object.fromEntries(servers.map(({ pkg, server }) => [server.name, mcp.entry(pkg, server, ctx.out.notes)])) });
       }
     } : {}
   });
@@ -40263,10 +40263,10 @@ var cursor = defineHarness({
     const entry = skillEntryPath(pkg.manifest);
     const { data, body } = splitFrontmatter(asText(pkg.files[entry]) ?? "");
     const extra = [];
-    for (const [path19, content] of Object.entries(pkg.files)) {
-      if (path19 === entry || isYarkrOnly(path19))
+    for (const [path20, content] of Object.entries(pkg.files)) {
+      if (path20 === entry || isYarkrOnly(path20))
         continue;
-      const p = join(l.assets, name, path19);
+      const p = join(l.assets, name, path20);
       ctx.out.files.push({ package: pkg.manifest.name, path: p, content });
       extra.push(`- \`${p}\``);
     }
@@ -40337,9 +40337,9 @@ function folderExportHarness(id, rootDefault, opts = {}) {
       for (const pkg of byKind(input2, "agent")) {
         const name = names.get(pkg.manifest.name);
         const parts = agentParts(pkg, id, names, out);
-        for (const [path19, content] of Object.entries(pkg.files))
-          if (!isYarkrOnly(path19))
-            out.files.push({ package: pkg.manifest.name, path: join(root, "agents", name, path19), content });
+        for (const [path20, content] of Object.entries(pkg.files))
+          if (!isYarkrOnly(path20))
+            out.files.push({ package: pkg.manifest.name, path: join(root, "agents", name, path20), content });
         index2.push({ kind: "agent", name, package: pkg.manifest.name, version: pkg.manifest.version, description: pkg.manifest.description, model: parts.model, tools: parts.tools, skills: parts.skills, subagents: parts.subagents, system_prompt: join("agents", name, pkg.manifest.agent?.system_prompt ?? "") });
       }
       for (const pkg of byKind(input2, "toolset")) {
@@ -41148,36 +41148,36 @@ var dirname = (p) => p.includes("/") ? p.slice(0, p.lastIndexOf("/")) : "";
 var basename = (p) => p.slice(p.lastIndexOf("/") + 1);
 var under = (dir, p) => dir ? p.startsWith(`${dir}/`) : true;
 var rel = (dir, p) => dir ? p.slice(dir.length + 1) : p;
-function parseOverrides(text, path19, problems) {
+function parseOverrides(text, path20, problems) {
   if (text === null)
     return null;
   try {
     const raw = import_yaml3.default.parse(text);
     return raw && typeof raw === "object" ? raw : null;
   } catch (err) {
-    problems.push({ path: path19, message: `${MANIFEST_FILE} isn't valid YAML: ${err.message}` });
+    problems.push({ path: path20, message: `${MANIFEST_FILE} isn't valid YAML: ${err.message}` });
     return null;
   }
 }
-function parseIndex(text, path19, problems) {
+function parseIndex(text, path20, problems) {
   let raw;
   try {
     raw = import_yaml3.default.parse(text ?? "");
   } catch (err) {
-    problems.push({ path: path19, message: `isn't valid YAML: ${err.message}` });
+    problems.push({ path: path20, message: `isn't valid YAML: ${err.message}` });
     return null;
   }
   const entries = (key) => {
     const list = raw?.[key] ?? [];
     if (!Array.isArray(list)) {
-      problems.push({ path: path19, message: `\`${key}\` must be a list.` });
+      problems.push({ path: path20, message: `\`${key}\` must be a list.` });
       return [];
     }
     return list.flatMap((e, i) => {
       const entry = typeof e === "string" ? { path: e } : e;
       if (entry && typeof entry === "object" && typeof entry.path === "string" && entry.path.trim())
         return [{ ...entry, path: entry.path.replace(/^\.?\/+|\/+$/g, "") }];
-      problems.push({ path: path19, message: `${key}[${i}] needs a \`path\`.` });
+      problems.push({ path: path20, message: `${key}[${i}] needs a \`path\`.` });
       return [];
     });
   };
@@ -41193,7 +41193,7 @@ async function detectAssets(input2) {
   const claimed = [];
   const isClaimed = (p) => claimed.some((d) => d ? p === d || p.startsWith(`${d}/`) : true);
   const filesBelow = (dir) => new Map(paths.filter((p) => under(dir, p)).map((p) => [rel(dir, p), p]));
-  const make = (name, kind, path19, files, o, extra) => {
+  const make = (name, kind, path20, files, o, extra) => {
     const suites = [...files.keys()].filter((p) => SUITE.test(p));
     const raw = {
       name: `${input2.namespace}/${slugify2(name)}`,
@@ -41212,10 +41212,10 @@ async function detectAssets(input2) {
     };
     const res = Manifest.safeParse(raw);
     if (!res.success) {
-      problems.push({ path: path19, message: res.error.issues.map((i) => `${i.path.join(".") || "manifest"}: ${i.message}`).join("; ") });
+      problems.push({ path: path20, message: res.error.issues.map((i) => `${i.path.join(".") || "manifest"}: ${i.message}`).join("; ") });
       return null;
     }
-    return { name: slugify2(name), kind, path: path19, manifest: res.data, files };
+    return { name: slugify2(name), kind, path: path20, manifest: res.data, files };
   };
   const manifestNear = async (dir, from) => {
     const mp = dir ? `${dir}/${MANIFEST_FILE}` : MANIFEST_FILE;
@@ -41388,12 +41388,12 @@ async function sameFiles(a, b, read) {
   }
   return true;
 }
-function toolsetServers2(text, path19, problems) {
+function toolsetServers2(text, path20, problems) {
   let doc;
   try {
     doc = JSON.parse(text ?? "");
   } catch (err) {
-    problems.push({ path: path19, message: `isn't valid JSON: ${err.message}` });
+    problems.push({ path: path20, message: `isn't valid JSON: ${err.message}` });
     return null;
   }
   const out = [];
@@ -41406,7 +41406,7 @@ function toolsetServers2(text, path19, problems) {
         const ref = String(v).replace(/\$\{([A-Za-z_][A-Za-z0-9_]*)(?::-[^}]*)?\}/g, "${env:$1}");
         const plain = ref.replace(/^Bearer /, "");
         if (!SECRET_REF.test(plain)) {
-          problems.push({ path: path19, message: `${name}.${field}.${k} is a literal value. Use \${${k.toUpperCase().replace(/[^A-Z0-9]+/g, "_")}} or \${vault:path#key} so no secret lives in the repo.` });
+          problems.push({ path: path20, message: `${name}.${field}.${k} is a literal value. Use \${${k.toUpperCase().replace(/[^A-Z0-9]+/g, "_")}} or \${vault:path#key} so no secret lives in the repo.` });
           return null;
         }
         res[k] = ref;
@@ -41426,7 +41426,7 @@ function toolsetServers2(text, path19, problems) {
     });
   }
   if (!out.length) {
-    problems.push({ path: path19, message: "has no mcpServers." });
+    problems.push({ path: path20, message: "has no mcpServers." });
     return null;
   }
   return out;
@@ -41550,8 +41550,8 @@ function verifyBundle(b, key, requireSignature) {
   return { manifest: b.manifest, files, content_hash: b.content_hash };
 }
 var TEXT_EXT = /\.(md|mdc|mdx|markdown|txt|ya?ml|json|toml|py|sh|bash|js|mjs|cjs|ts|tsx|csv|html|css|xml|sql|rb|go|rs|java|ini|cfg|env)$/i;
-function looksText(path19, bytes) {
-  if (TEXT_EXT.test(path19)) return true;
+function looksText(path20, bytes) {
+  if (TEXT_EXT.test(path20)) return true;
   const n = Math.min(bytes.length, 4096);
   for (let i = 0; i < n; i++) if (bytes[i] === 0) return false;
   try {
@@ -42121,16 +42121,16 @@ var Diff = class {
       }
     }
   }
-  addToPath(path19, added, removed, oldPosInc, options) {
-    const last = path19.lastComponent;
+  addToPath(path20, added, removed, oldPosInc, options) {
+    const last = path20.lastComponent;
     if (last && !options.oneChangePerToken && last.added === added && last.removed === removed) {
       return {
-        oldPos: path19.oldPos + oldPosInc,
+        oldPos: path20.oldPos + oldPosInc,
         lastComponent: { count: last.count + 1, added, removed, previousComponent: last.previousComponent }
       };
     } else {
       return {
-        oldPos: path19.oldPos + oldPosInc,
+        oldPos: path20.oldPos + oldPosInc,
         lastComponent: { count: 1, added, removed, previousComponent: last }
       };
     }
@@ -42772,10 +42772,10 @@ async function loadSuites(candidate, candFiles, shared) {
   }
   return out;
 }
-function parseSuite(bytes, ref, path19, source) {
+function parseSuite(bytes, ref, path20, source) {
   const text = bytes.toString("utf8");
   try {
-    return { suite: parseEvalSuite(text, path19), ref, path: path19, source, hash: sha256(text) };
+    return { suite: parseEvalSuite(text, path20), ref, path: path20, source, hash: sha256(text) };
   } catch (err) {
     throw new SuiteError(err.message);
   }
@@ -44276,7 +44276,7 @@ async function registrySnapshot(api, name, opts = {}) {
   const rel2 = await api.resolve(name, { channel: opts.channel ?? "stable", range: opts.range });
   const bundle = await api.bundle(name, rel2.version);
   const files = new Map(bundle.files.map((f) => [f.path, Buffer.from(f.content, "base64")]));
-  const tree = buildTree([...files].map(([path19, bytes]) => ({ path: path19, bytes })));
+  const tree = buildTree([...files].map(([path20, bytes]) => ({ path: path20, bytes })));
   return { snapshot: { name, label: bundle.version, contentHash: bundle.content_hash, manifest: bundle.manifest, tree }, files };
 }
 function registrySuiteResolver(getApi) {
@@ -45086,26 +45086,66 @@ var petrol = rgb(74, 163, 191);
 function link(url2, text = url2) {
   return kleur_default.enabled ? `\x1B]8;;${url2}\x1B\\${text}\x1B]8;;\x1B\\` : text;
 }
-function banner(version2, invokedAs = "yarkr") {
+function banner(version2, longName = false, update2) {
   return [
     "",
     ...WORDMARK.map((l) => `  ${petrol(l)}`),
     "",
     `  ${kleur_default.bold("yarkr")} ${kleur_default.dim(`v${version2}`)}  ${kleur_default.dim("\xB7")}  skills, agents and MCP toolsets for every harness`,
     `  ${petrol("\u2192")} ${kleur_default.underline(petrol(link(WEBSITE)))}`,
-    ...invokedAs === "yarkr-cli" ? ["", `  ${kleur_default.dim("Tip:")} install it with ${kleur_default.bold("npm install -g yarkr-cli")}, then just run ${kleur_default.bold("yarkr")}.`] : [],
+    ...update2 ? ["", `  ${kleur_default.yellow(`\u26A0 yarkr-cli ${update2.latest} is available (you have ${version2}).`)} Update: ${kleur_default.bold(update2.command)}`] : [],
+    ...longName ? ["", `  ${kleur_default.dim("Tip:")} install it with ${kleur_default.bold("npm install -g yarkr-cli")}, then just run ${kleur_default.bold("yarkr")}.`] : [],
     ""
   ].join("\n");
 }
 
+// src/update-check.ts
+var import_semver4 = __toESM(require_semver2(), 1);
+import { mkdir as mkdir9, readFile as readFile11, writeFile as writeFile8 } from "fs/promises";
+import path18 from "path";
+var LATEST_URL = "https://registry.npmjs.org/yarkr-cli/latest";
+var CHECK_EVERY_MS = 24 * 60 * 60 * 1e3;
+var TIMEOUT_MS = 1500;
+var cacheFile = () => path18.join(userStateDir(), "update-check.json");
+async function newerVersion(current, env = process.env) {
+  if (env.CI || env.YARKR_NO_UPDATE_CHECK || env.NO_UPDATE_NOTIFIER || !import_semver4.default.valid(current) || current === "0.0.0-dev") return null;
+  const latest = await latestVersion();
+  return latest && import_semver4.default.gt(latest, current) ? latest : null;
+}
+async function latestVersion() {
+  try {
+    const cached2 = JSON.parse(await readFile11(cacheFile(), "utf8"));
+    if (Date.now() - cached2.checked_at < CHECK_EVERY_MS && import_semver4.default.valid(cached2.latest)) return cached2.latest;
+  } catch {
+  }
+  try {
+    const res = await fetch(LATEST_URL, { signal: AbortSignal.timeout(TIMEOUT_MS), headers: { accept: "application/json" } });
+    if (!res.ok) return null;
+    const { version: version2 } = await res.json();
+    if (!version2 || !import_semver4.default.valid(version2)) return null;
+    await mkdir9(userStateDir(), { recursive: true });
+    await writeFile8(cacheFile(), JSON.stringify({ checked_at: Date.now(), latest: version2 }));
+    return version2;
+  } catch {
+    return null;
+  }
+}
+var viaNpx = (scriptPath = process.argv[1] ?? "") => /[\\/]_npx[\\/]/.test(scriptPath);
+function updateCommand(latest, scriptPath = process.argv[1] ?? "") {
+  return viaNpx(scriptPath) ? `npx yarkr-cli@${latest}` : `npm install -g yarkr-cli@${latest}`;
+}
+
 // src/index.ts
-var VERSION = true ? "1.0.5" : "0.0.0-dev";
+var VERSION = true ? "1.0.6" : "0.0.0-dev";
 var act = (fn) => async (...a) => {
   await fn(...a);
 };
 var syncFlags = (c) => c.option("--harness <ids...>", `limit to some harnesses (${HARNESS_IDS.join(", ")})`).option("--dry-run", "show what would change; write nothing").option("--check", "exit 1 if anything is out of date (for CI)").option("--force", "overwrite files edited locally").option("--require-signatures", "refuse unsigned releases").option("-g, --global", "install into your home directory instead of this folder").addOption(new Option("--user").hideHelp()).option("--registry <url>", "registry to use (default: from .yarkrrc)");
-function buildProgram() {
-  const program2 = new Command().name("yarkr").description("Yarkr: install your org's skills, agents and MCP configs into every harness.").version(VERSION).addHelpText("before", () => banner(VERSION, path18.basename(process.argv[1] ?? "", ".js"))).option("-q, --quiet", "only print warnings and errors").hook("preAction", (cmd) => {
+function buildProgram(latest = null) {
+  const program2 = new Command().name("yarkr").description("Yarkr: install your org's skills, agents and MCP configs into every harness.").version(VERSION).addHelpText(
+    "before",
+    () => banner(VERSION, viaNpx() || path19.basename(process.argv[1] ?? "", ".js") === "yarkr-cli", latest ? { latest, command: updateCommand(latest) } : null)
+  ).option("-q, --quiet", "only print warnings and errors").hook("preAction", (cmd) => {
     ui.quiet = !!cmd.opts().quiet;
   });
   program2.command("login").description("sign in in the browser and keep a token in your keychain (or ~/.yarkrrc)").option("--registry <url>").option("--token <token>", "use this token instead of the browser (or pipe it on stdin)").option("--no-browser", "print a link to open on any device, then paste the token it shows").action(act(login));
@@ -45150,9 +45190,11 @@ function buildProgram() {
   program2.command("mcp-config").argument("<harness>", HARNESS_IDS.join(" | ")).description("print the config that connects a harness to Yarkr's MCP server").option("--token-env <name>", "environment variable holding the token", "YARKR_TOKEN").option("--registry <url>").action(act(mcpConfig));
   return program2;
 }
+var showsBanner = (args) => args.length === 0 || args.length === 1 && (args[0] === "-h" || args[0] === "--help");
 async function main(argv = process.argv) {
   try {
-    await buildProgram().parseAsync(argv);
+    const latest = showsBanner(argv.slice(2)) ? await newerVersion(VERSION) : null;
+    await buildProgram(latest).parseAsync(argv);
   } catch (err) {
     if (err instanceof CliError) {
       ui.error(err.message);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yarkr-cli",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "Install skills, agents and MCP toolsets from Yarkr into Claude Code, Codex, opencode, Cursor and more",
   "license": "MIT",
   "homepage": "https://yarkr.com",