yarkr-cli 1.0.3 → 1.0.5

package/README.md

@@ -1,41 +1,44 @@
-# yarkr
+# yarkr-cli
 
 Install skills, agents and MCP toolsets from [Yarkr](https://yarkr.com) into the native layout of every harness you use:
 Claude Code, Codex, opencode, Cursor and more.
 
 ```sh
-npm install -g yarkr-cli                                 # Node 22 or newer; or run any command with `npx yarkr-cli …`
-yarkr add posterus-ltd/code-review-checklist            # a public package, no account needed
-yarkr add posterus-ltd/github --harness codex           # pick the harnesses to write
+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
 ```
 
+With `npx`, the command is always `npx yarkr-cli …`. Installed globally (`npm install -g yarkr-cli`), it answers to
+both `yarkr-cli` and the shorter `yarkr`, so `yarkr sync` works the same as `yarkr-cli sync`.
+
 ## Sync an ark to your machine
 
-An ark is a curated set of skills, agents and toolsets hosted in the registry. `yarkr sync` writes each one into the
-harness's own layout (`~/.claude/skills/…`, `~/.agents/…`, MCP configs and so on):
+An ark is a curated set of skills, agents and toolsets hosted in the registry. `npx yarkr-cli sync` writes each one into
+the harness's own layout (`~/.claude/skills/…`, `~/.agents/…`, MCP configs and so on):
 
 ```sh
-yarkr arks                                    # list public arks
-yarkr sync acme/starter                       # install one into this folder
-yarkr sync acme/starter -g                    # …or into your home directory
-yarkr sync acme/starter --harness claude-code # only write Claude Code's files
-yarkr ark                                     # what your arks give you, and which version
+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
 ```
 
-Signed in, a bare `yarkr sync` installs every ark you're a member of, plus your personal ark. Run it again to pick up
-whatever an admin added or removed; `yarkr sync --check` exits 1 when you're behind.
+Signed in, a bare `npx yarkr-cli sync` installs every ark you're a member of, plus your personal ark. Run it again to
+pick up whatever an admin added or removed; `npx yarkr-cli sync --check` exits 1 when you're behind.
 
 ## Set up an existing repo
 
-In a project, `yarkr init` creates `yarkr.json` (and `.yarkrrc`), detecting the harnesses already used there.
-`yarkr add` and `yarkr sync` then pin every package in `yarkr.lock`, so teammates and CI get the same releases:
+In a project, `npx yarkr-cli init` creates `yarkr.json` (and `.yarkrrc`), detecting the harnesses already used there.
+`npx yarkr-cli add` and `npx yarkr-cli sync` then pin every package in `yarkr.lock`, so teammates and CI get the same
+releases:
 
 ```sh
 cd my-repo
-yarkr init --ark acme/engineering            # optional: install a team's ark into this project
-yarkr add posterus-ltd/playwright-test-authoring
+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
 git add yarkr.json yarkr.lock .yarkrrc .claude AGENTS.md && git commit
-yarkr sync --check                           # in CI: exit 1 when anything is out of date
+npx yarkr-cli sync --check                           # in CI: exit 1 when anything is out of date
 ```
 
 To publish from the repo instead, there's nothing to init: Yarkr finds `SKILL.md` folders, `agents/*.md` and
@@ -43,9 +46,9 @@ To publish from the repo instead, there's nothing to init: Yarkr finds `SKILL.md
 SKILL.md) goes in one `yarkr.index.yaml` at the root, and nothing has to move. Lint it before you push:
 
 ```sh
-yarkr lint                                               # what will be published, and what the hub would refuse
-yarkr lint --strict                                      # in CI: fail on warnings too
-yarkr guide index-repo -o ~/.claude/skills/index-repo/   # a skill your agent uses to write the index
+npx yarkr-cli lint                                               # what will be published, and what the hub would refuse
+npx yarkr-cli lint --strict                                      # in CI: fail on warnings too
+npx yarkr-cli guide index-repo -o ~/.claude/skills/index-repo/   # a skill your agent uses to write the index
 ```
 
 ## Sign in for private packages
@@ -53,12 +56,12 @@ yarkr guide index-repo -o ~/.claude/skills/index-repo/   # a skill your agent us
 Public packages and public arks work signed out. Your org's private packages and arks need a token:
 
 ```sh
-yarkr login                  # signs in in the browser; the token goes to your keychain (or ~/.yarkrrc)
-yarkr login --no-browser     # over SSH: open the printed link anywhere, then paste the token
-yarkr whoami                 # check who you're signed in as
+npx yarkr-cli login                  # signs in in the browser; the token goes to your keychain (or ~/.yarkrrc)
+npx yarkr-cli login --no-browser     # over SSH: open the printed link anywhere, then paste the token
+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`. `yarkr` uses the public hub at `https://yarkr.com`
-unless you point it at your own instance with `yarkr login --registry <url>`.
+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

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 path18 = __require("path");
+    var path19 = __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 = path18.resolve(baseDir, baseName);
+          const localBin = path19.resolve(baseDir, baseName);
           if (fs.existsSync(localBin)) return localBin;
-          if (sourceExt.includes(path18.extname(baseName))) return void 0;
+          if (sourceExt.includes(path19.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 = path18.resolve(
-            path18.dirname(resolvedScriptPath),
+          executableDir = path19.resolve(
+            path19.dirname(resolvedScriptPath),
             executableDir
           );
         }
         if (executableDir) {
           let localFile = findFile(executableDir, executableFile);
           if (!localFile && !subcommand._executableFile && this._scriptPath) {
-            const legacyName = path18.basename(
+            const legacyName = path19.basename(
               this._scriptPath,
-              path18.extname(this._scriptPath)
+              path19.extname(this._scriptPath)
             );
             if (legacyName !== this._name) {
               localFile = findFile(
@@ -2260,7 +2260,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
           }
           executableFile = localFile || executableFile;
         }
-        launchWithNode = sourceExt.includes(path18.extname(executableFile));
+        launchWithNode = sourceExt.includes(path19.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 = path18.basename(filename, path18.extname(filename));
+        this._name = path19.basename(filename, path19.extname(filename));
         return this;
       }
       /**
@@ -3189,9 +3189,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [path]
        * @return {(string|null|Command)}
        */
-      executableDir(path19) {
-        if (path19 === void 0) return this._executableDir;
-        this._executableDir = path19;
+      executableDir(path20) {
+        if (path20 === void 0) return this._executableDir;
+        this._executableDir = path20;
         return this;
       }
       /**
@@ -3547,17 +3547,17 @@ var require_visit = __commonJS({
     visit2.BREAK = BREAK;
     visit2.SKIP = SKIP2;
     visit2.REMOVE = REMOVE;
-    function visit_(key, node2, visitor, path18) {
-      const ctrl = callVisitor(key, node2, visitor, path18);
+    function visit_(key, node2, visitor, path19) {
+      const ctrl = callVisitor(key, node2, visitor, path19);
       if (identity.isNode(ctrl) || identity.isPair(ctrl)) {
-        replaceNode(key, path18, ctrl);
-        return visit_(key, ctrl, visitor, path18);
+        replaceNode(key, path19, ctrl);
+        return visit_(key, ctrl, visitor, path19);
       }
       if (typeof ctrl !== "symbol") {
         if (identity.isCollection(node2)) {
-          path18 = Object.freeze(path18.concat(node2));
+          path19 = Object.freeze(path19.concat(node2));
           for (let i = 0; i < node2.items.length; ++i) {
-            const ci = visit_(i, node2.items[i], visitor, path18);
+            const ci = visit_(i, node2.items[i], visitor, path19);
             if (typeof ci === "number")
               i = ci - 1;
             else if (ci === BREAK)
@@ -3568,13 +3568,13 @@ var require_visit = __commonJS({
             }
           }
         } else if (identity.isPair(node2)) {
-          path18 = Object.freeze(path18.concat(node2));
-          const ck = visit_("key", node2.key, visitor, path18);
+          path19 = Object.freeze(path19.concat(node2));
+          const ck = visit_("key", node2.key, visitor, path19);
           if (ck === BREAK)
             return BREAK;
           else if (ck === REMOVE)
             node2.key = null;
-          const cv = visit_("value", node2.value, visitor, path18);
+          const cv = visit_("value", node2.value, visitor, path19);
           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, path18) {
-      const ctrl = await callVisitor(key, node2, visitor, path18);
+    async function visitAsync_(key, node2, visitor, path19) {
+      const ctrl = await callVisitor(key, node2, visitor, path19);
       if (identity.isNode(ctrl) || identity.isPair(ctrl)) {
-        replaceNode(key, path18, ctrl);
-        return visitAsync_(key, ctrl, visitor, path18);
+        replaceNode(key, path19, ctrl);
+        return visitAsync_(key, ctrl, visitor, path19);
       }
       if (typeof ctrl !== "symbol") {
         if (identity.isCollection(node2)) {
-          path18 = Object.freeze(path18.concat(node2));
+          path19 = Object.freeze(path19.concat(node2));
           for (let i = 0; i < node2.items.length; ++i) {
-            const ci = await visitAsync_(i, node2.items[i], visitor, path18);
+            const ci = await visitAsync_(i, node2.items[i], visitor, path19);
             if (typeof ci === "number")
               i = ci - 1;
             else if (ci === BREAK)
@@ -3616,13 +3616,13 @@ var require_visit = __commonJS({
             }
           }
         } else if (identity.isPair(node2)) {
-          path18 = Object.freeze(path18.concat(node2));
-          const ck = await visitAsync_("key", node2.key, visitor, path18);
+          path19 = Object.freeze(path19.concat(node2));
+          const ck = await visitAsync_("key", node2.key, visitor, path19);
           if (ck === BREAK)
             return BREAK;
           else if (ck === REMOVE)
             node2.key = null;
-          const cv = await visitAsync_("value", node2.value, visitor, path18);
+          const cv = await visitAsync_("value", node2.value, visitor, path19);
           if (cv === BREAK)
             return BREAK;
           else if (cv === REMOVE)
@@ -3649,23 +3649,23 @@ var require_visit = __commonJS({
       }
       return visitor;
     }
-    function callVisitor(key, node2, visitor, path18) {
+    function callVisitor(key, node2, visitor, path19) {
       if (typeof visitor === "function")
-        return visitor(key, node2, path18);
+        return visitor(key, node2, path19);
       if (identity.isMap(node2))
-        return visitor.Map?.(key, node2, path18);
+        return visitor.Map?.(key, node2, path19);
       if (identity.isSeq(node2))
-        return visitor.Seq?.(key, node2, path18);
+        return visitor.Seq?.(key, node2, path19);
       if (identity.isPair(node2))
-        return visitor.Pair?.(key, node2, path18);
+        return visitor.Pair?.(key, node2, path19);
       if (identity.isScalar(node2))
-        return visitor.Scalar?.(key, node2, path18);
+        return visitor.Scalar?.(key, node2, path19);
       if (identity.isAlias(node2))
-        return visitor.Alias?.(key, node2, path18);
+        return visitor.Alias?.(key, node2, path19);
       return void 0;
     }
-    function replaceNode(key, path18, node2) {
-      const parent = path18[path18.length - 1];
+    function replaceNode(key, path19, node2) {
+      const parent = path19[path19.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, path18, value) {
+    function collectionFromPath(schema, path19, value) {
       let v = value;
-      for (let i = path18.length - 1; i >= 0; --i) {
-        const k = path18[i];
+      for (let i = path19.length - 1; i >= 0; --i) {
+        const k = path19[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 = (path18) => path18 == null || typeof path18 === "object" && !!path18[Symbol.iterator]().next().done;
+    var isEmptyPath = (path19) => path19 == null || typeof path19 === "object" && !!path19[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(path18, value) {
-        if (isEmptyPath(path18))
+      addIn(path19, value) {
+        if (isEmptyPath(path19))
           this.add(value);
         else {
-          const [key, ...rest] = path18;
+          const [key, ...rest] = path19;
           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(path18) {
-        const [key, ...rest] = path18;
+      deleteIn(path19) {
+        const [key, ...rest] = path19;
         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(path18, keepScalar) {
-        const [key, ...rest] = path18;
+      getIn(path19, keepScalar) {
+        const [key, ...rest] = path19;
         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(path18) {
-        const [key, ...rest] = path18;
+      hasIn(path19) {
+        const [key, ...rest] = path19;
         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(path18, value) {
-        const [key, ...rest] = path18;
+      setIn(path19, value) {
+        const [key, ...rest] = path19;
         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(path18, value) {
+      addIn(path19, value) {
         if (assertCollection(this.contents))
-          this.contents.addIn(path18, value);
+          this.contents.addIn(path19, 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(path18) {
-        if (Collection.isEmptyPath(path18)) {
+      deleteIn(path19) {
+        if (Collection.isEmptyPath(path19)) {
           if (this.contents == null)
             return false;
           this.contents = null;
           return true;
         }
-        return assertCollection(this.contents) ? this.contents.deleteIn(path18) : false;
+        return assertCollection(this.contents) ? this.contents.deleteIn(path19) : 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(path18, keepScalar) {
-        if (Collection.isEmptyPath(path18))
+      getIn(path19, keepScalar) {
+        if (Collection.isEmptyPath(path19))
           return !keepScalar && identity.isScalar(this.contents) ? this.contents.value : this.contents;
-        return identity.isCollection(this.contents) ? this.contents.getIn(path18, keepScalar) : void 0;
+        return identity.isCollection(this.contents) ? this.contents.getIn(path19, 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(path18) {
-        if (Collection.isEmptyPath(path18))
+      hasIn(path19) {
+        if (Collection.isEmptyPath(path19))
           return this.contents !== void 0;
-        return identity.isCollection(this.contents) ? this.contents.hasIn(path18) : false;
+        return identity.isCollection(this.contents) ? this.contents.hasIn(path19) : 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(path18, value) {
-        if (Collection.isEmptyPath(path18)) {
+      setIn(path19, value) {
+        if (Collection.isEmptyPath(path19)) {
           this.contents = value;
         } else if (this.contents == null) {
-          this.contents = Collection.collectionFromPath(this.schema, Array.from(path18), value);
+          this.contents = Collection.collectionFromPath(this.schema, Array.from(path19), value);
         } else if (assertCollection(this.contents)) {
-          this.contents.setIn(path18, value);
+          this.contents.setIn(path19, value);
         }
       }
       /**
@@ -9008,9 +9008,9 @@ var require_cst_visit = __commonJS({
     visit2.BREAK = BREAK;
     visit2.SKIP = SKIP2;
     visit2.REMOVE = REMOVE;
-    visit2.itemAtPath = (cst, path18) => {
+    visit2.itemAtPath = (cst, path19) => {
       let item = cst;
-      for (const [field, index2] of path18) {
+      for (const [field, index2] of path19) {
         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, path18) => {
-      const parent = visit2.itemAtPath(cst, path18.slice(0, -1));
-      const field = path18[path18.length - 1][0];
+    visit2.parentCollection = (cst, path19) => {
+      const parent = visit2.itemAtPath(cst, path19.slice(0, -1));
+      const field = path19[path19.length - 1][0];
       const coll = parent?.[field];
       if (coll && "items" in coll)
         return coll;
       throw new Error("Parent collection not found");
     };
-    function _visit(path18, item, visitor) {
-      let ctrl = visitor(item, path18);
+    function _visit(path19, item, visitor) {
+      let ctrl = visitor(item, path19);
       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(path18.concat([[field, i]])), token.items[i], visitor);
+            const ci = _visit(Object.freeze(path19.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, path18);
+            ctrl = ctrl(item, path19);
         }
       }
-      return typeof ctrl === "function" ? ctrl(item, path18) : ctrl;
+      return typeof ctrl === "function" ? ctrl(item, path19) : ctrl;
     }
     exports.visit = visit2;
   }
@@ -16023,8 +16023,8 @@ var require_utils = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path18) {
-      let input2 = path18;
+    function removeDotSegments(path19) {
+      let input2 = path19;
       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 path18 = queryIndex === -1 ? wsComponent.resourceName : wsComponent.resourceName.slice(0, queryIndex);
-        wsComponent.path = path18 && path18 !== "/" ? path18 : void 0;
+        const path19 = queryIndex === -1 ? wsComponent.resourceName : wsComponent.resourceName.slice(0, queryIndex);
+        wsComponent.path = path19 && path19 !== "/" ? path19 : void 0;
         wsComponent.query = queryIndex === -1 ? void 0 : wsComponent.resourceName.slice(queryIndex + 1);
         wsComponent.resourceName = void 0;
       }
@@ -19643,6 +19643,9 @@ var require_ajv = __commonJS({
   }
 });
 
+// src/index.ts
+import path18 from "path";
+
 // ../../node_modules/.pnpm/commander@14.0.3/node_modules/commander/esm.mjs
 var import_index = __toESM(require_commander(), 1);
 var {
@@ -20476,10 +20479,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path18) {
-  if (!path18)
+function getElementAtPath(obj, path19) {
+  if (!path19)
     return obj;
-  return path18.reduce((acc, key) => acc?.[key], obj);
+  return path19.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -20819,11 +20822,11 @@ function explicitlyAborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path18, issues) {
+function prefixIssues(path19, issues) {
   return issues.map((iss) => {
     var _a3;
     (_a3 = iss).path ?? (_a3.path = []);
-    iss.path.unshift(path18);
+    iss.path.unshift(path19);
     return iss;
   });
 }
@@ -21273,16 +21276,16 @@ function flattenError(error62, mapper = (issue2) => issue2.message) {
 }
 function formatError(error62, mapper = (issue2) => issue2.message) {
   const fieldErrors = { _errors: [] };
-  const processError = (error63, path18 = []) => {
+  const processError = (error63, path19 = []) => {
     for (const issue2 of error63.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path18, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path19, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path18, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path19, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path18, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path19, ...issue2.path]);
       } else {
-        const fullpath = [...path18, ...issue2.path];
+        const fullpath = [...path19, ...issue2.path];
         if (fullpath.length === 0) {
           fieldErrors._errors.push(mapper(issue2));
         } else {
@@ -21321,17 +21324,17 @@ function formatError(error62, mapper = (issue2) => issue2.message) {
 }
 function treeifyError(error62, mapper = (issue2) => issue2.message) {
   const result = { errors: [] };
-  const processError = (error63, path18 = []) => {
+  const processError = (error63, path19 = []) => {
     var _a3;
     for (const issue2 of error63.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path18, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path19, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path18, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path19, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path18, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path19, ...issue2.path]);
       } else {
-        const fullpath = [...path18, ...issue2.path];
+        const fullpath = [...path19, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -21370,8 +21373,8 @@ function treeifyError(error62, mapper = (issue2) => issue2.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path18 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path18) {
+  const path19 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path19) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -38473,13 +38476,13 @@ function resolveRef(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path18 = ref.slice(1).split("/").filter(Boolean);
-  if (path18.length === 0) {
+  const path19 = ref.slice(1).split("/").filter(Boolean);
+  if (path19.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path18[0] === defsKey) {
-    const key = path18[1] === void 0 ? void 0 : decodeJSONPointerSegment(path18[1]);
+  if (path19[0] === defsKey) {
+    const key = path19[1] === void 0 ? void 0 : decodeJSONPointerSegment(path19[1]);
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -39762,8 +39765,8 @@ var Api = class {
     this.conn = conn;
   }
   conn;
-  async request(method, path18, body, { allow404 = false } = {}) {
-    const url2 = `${this.conn.server}/api/v1${path18}`;
+  async request(method, path19, body, { allow404 = false } = {}) {
+    const url2 = `${this.conn.server}/api/v1${path19}`;
     let res;
     try {
       res = await fetch(url2, {
@@ -39785,7 +39788,7 @@ var Api = class {
         payload = await res.json();
       } catch {
       }
-      const msg = payload.message ?? `${method} ${path18} failed with HTTP ${res.status}.`;
+      const msg = payload.message ?? `${method} ${path19} failed with HTTP ${res.status}.`;
       if (res.status === 401) {
         throw new CliError(
           msg,
@@ -39876,17 +39879,17 @@ function parseManifest(text) {
   }
   return manifest;
 }
-function parseEvalSuite(text, path18 = "suite") {
+function parseEvalSuite(text, path19 = "suite") {
   let raw;
   try {
     raw = import_yaml.default.parse(text);
   } catch (err) {
-    throw new ManifestError(`${path18} is not valid YAML: ${err.message}`);
+    throw new ManifestError(`${path19} 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(`${path18} is invalid: ${issues.map((i) => `${i.path}: ${i.message}`).join("; ")}`, issues);
+    throw new ManifestError(`${path19} is invalid: ${issues.map((i) => `${i.path}: ${i.message}`).join("; ")}`, issues);
   }
   return res.data;
 }
@@ -39943,8 +39946,8 @@ function asText(content) {
     return null;
   return typeof content === "string" ? content : new TextDecoder().decode(content);
 }
-function isYarkrOnly(path18) {
-  return path18 === MANIFEST_FILE || path18 === INDEX_FILE || path18.startsWith("evals/") || path18.startsWith("fixtures/");
+function isYarkrOnly(path19) {
+  return path19 === MANIFEST_FILE || path19 === INDEX_FILE || path19.startsWith("evals/") || path19.startsWith("fixtures/");
 }
 function skillEntryPath(m) {
   return m.entry ?? "SKILL.md";
@@ -39972,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 [path18, content] of Object.entries(pkg.files)) {
-    if (path18 === entry || path18 === "SKILL.md" || isYarkrOnly(path18))
+  for (const [path19, content] of Object.entries(pkg.files)) {
+    if (path19 === entry || path19 === "SKILL.md" || isYarkrOnly(path19))
       continue;
-    files.push({ package: pkg.manifest.name, path: join(dir, folderName, path18), content });
+    files.push({ package: pkg.manifest.name, path: join(dir, folderName, path19), content });
   }
   return files;
 }
@@ -40069,13 +40072,13 @@ function nativeFolderHarness(o) {
     ...o.mcp ? {
       toolsets(servers, ctx) {
         const mcp = o.mcp;
-        const path18 = ctx.layout[slot];
-        if (!path18) {
+        const path19 = ctx.layout[slot];
+        if (!path19) {
           if (mcp.unavailable)
             ctx.out.notes.push(mcp.unavailable(servers));
           return;
         }
-        ctx.out.mcp.push({ path: path18, key: mcp.key, servers: Object.fromEntries(servers.map(({ pkg, server }) => [server.name, mcp.entry(pkg, server, ctx.out.notes)])) });
+        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)])) });
       }
     } : {}
   });
@@ -40260,10 +40263,10 @@ var cursor = defineHarness({
     const entry = skillEntryPath(pkg.manifest);
     const { data, body } = splitFrontmatter(asText(pkg.files[entry]) ?? "");
     const extra = [];
-    for (const [path18, content] of Object.entries(pkg.files)) {
-      if (path18 === entry || isYarkrOnly(path18))
+    for (const [path19, content] of Object.entries(pkg.files)) {
+      if (path19 === entry || isYarkrOnly(path19))
         continue;
-      const p = join(l.assets, name, path18);
+      const p = join(l.assets, name, path19);
       ctx.out.files.push({ package: pkg.manifest.name, path: p, content });
       extra.push(`- \`${p}\``);
     }
@@ -40334,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 [path18, content] of Object.entries(pkg.files))
-          if (!isYarkrOnly(path18))
-            out.files.push({ package: pkg.manifest.name, path: join(root, "agents", name, path18), content });
+        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 });
         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")) {
@@ -41145,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, path18, problems) {
+function parseOverrides(text, path19, 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: path18, message: `${MANIFEST_FILE} isn't valid YAML: ${err.message}` });
+    problems.push({ path: path19, message: `${MANIFEST_FILE} isn't valid YAML: ${err.message}` });
     return null;
   }
 }
-function parseIndex(text, path18, problems) {
+function parseIndex(text, path19, problems) {
   let raw;
   try {
     raw = import_yaml3.default.parse(text ?? "");
   } catch (err) {
-    problems.push({ path: path18, message: `isn't valid YAML: ${err.message}` });
+    problems.push({ path: path19, message: `isn't valid YAML: ${err.message}` });
     return null;
   }
   const entries = (key) => {
     const list = raw?.[key] ?? [];
     if (!Array.isArray(list)) {
-      problems.push({ path: path18, message: `\`${key}\` must be a list.` });
+      problems.push({ path: path19, 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: path18, message: `${key}[${i}] needs a \`path\`.` });
+      problems.push({ path: path19, message: `${key}[${i}] needs a \`path\`.` });
       return [];
     });
   };
@@ -41190,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, path18, files, o, extra) => {
+  const make = (name, kind, path19, files, o, extra) => {
     const suites = [...files.keys()].filter((p) => SUITE.test(p));
     const raw = {
       name: `${input2.namespace}/${slugify2(name)}`,
@@ -41209,10 +41212,10 @@ async function detectAssets(input2) {
     };
     const res = Manifest.safeParse(raw);
     if (!res.success) {
-      problems.push({ path: path18, message: res.error.issues.map((i) => `${i.path.join(".") || "manifest"}: ${i.message}`).join("; ") });
+      problems.push({ path: path19, message: res.error.issues.map((i) => `${i.path.join(".") || "manifest"}: ${i.message}`).join("; ") });
       return null;
     }
-    return { name: slugify2(name), kind, path: path18, manifest: res.data, files };
+    return { name: slugify2(name), kind, path: path19, manifest: res.data, files };
   };
   const manifestNear = async (dir, from) => {
     const mp = dir ? `${dir}/${MANIFEST_FILE}` : MANIFEST_FILE;
@@ -41385,12 +41388,12 @@ async function sameFiles(a, b, read) {
   }
   return true;
 }
-function toolsetServers2(text, path18, problems) {
+function toolsetServers2(text, path19, problems) {
   let doc;
   try {
     doc = JSON.parse(text ?? "");
   } catch (err) {
-    problems.push({ path: path18, message: `isn't valid JSON: ${err.message}` });
+    problems.push({ path: path19, message: `isn't valid JSON: ${err.message}` });
     return null;
   }
   const out = [];
@@ -41403,7 +41406,7 @@ function toolsetServers2(text, path18, 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: path18, 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: 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.` });
           return null;
         }
         res[k] = ref;
@@ -41423,7 +41426,7 @@ function toolsetServers2(text, path18, problems) {
     });
   }
   if (!out.length) {
-    problems.push({ path: path18, message: "has no mcpServers." });
+    problems.push({ path: path19, message: "has no mcpServers." });
     return null;
   }
   return out;
@@ -41547,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(path18, bytes) {
-  if (TEXT_EXT.test(path18)) return true;
+function looksText(path19, bytes) {
+  if (TEXT_EXT.test(path19)) return true;
   const n = Math.min(bytes.length, 4096);
   for (let i = 0; i < n; i++) if (bytes[i] === 0) return false;
   try {
@@ -42118,16 +42121,16 @@ var Diff = class {
       }
     }
   }
-  addToPath(path18, added, removed, oldPosInc, options) {
-    const last = path18.lastComponent;
+  addToPath(path19, added, removed, oldPosInc, options) {
+    const last = path19.lastComponent;
     if (last && !options.oneChangePerToken && last.added === added && last.removed === removed) {
       return {
-        oldPos: path18.oldPos + oldPosInc,
+        oldPos: path19.oldPos + oldPosInc,
         lastComponent: { count: last.count + 1, added, removed, previousComponent: last.previousComponent }
       };
     } else {
       return {
-        oldPos: path18.oldPos + oldPosInc,
+        oldPos: path19.oldPos + oldPosInc,
         lastComponent: { count: 1, added, removed, previousComponent: last }
       };
     }
@@ -42769,10 +42772,10 @@ async function loadSuites(candidate, candFiles, shared) {
   }
   return out;
 }
-function parseSuite(bytes, ref, path18, source) {
+function parseSuite(bytes, ref, path19, source) {
   const text = bytes.toString("utf8");
   try {
-    return { suite: parseEvalSuite(text, path18), ref, path: path18, source, hash: sha256(text) };
+    return { suite: parseEvalSuite(text, path19), ref, path: path19, source, hash: sha256(text) };
   } catch (err) {
     throw new SuiteError(err.message);
   }
@@ -44273,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(([path18, bytes]) => ({ path: path18, bytes })));
+  const tree = buildTree([...files].map(([path19, bytes]) => ({ path: path19, bytes })));
   return { snapshot: { name, label: bundle.version, contentHash: bundle.content_hash, manifest: bundle.manifest, tree }, files };
 }
 function registrySuiteResolver(getApi) {
@@ -45083,25 +45086,26 @@ 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) {
+function banner(version2, invokedAs = "yarkr") {
   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")}.`] : [],
     ""
   ].join("\n");
 }
 
 // src/index.ts
-var VERSION = true ? "1.0.3" : "0.0.0-dev";
+var VERSION = true ? "1.0.5" : "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)).option("-q, --quiet", "only print warnings and errors").hook("preAction", (cmd) => {
+  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) => {
     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));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yarkr-cli",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Install skills, agents and MCP toolsets from Yarkr into Claude Code, Codex, opencode, Cursor and more",
   "license": "MIT",
   "homepage": "https://yarkr.com",
@@ -27,7 +27,8 @@
     "node": ">=22"
   },
   "bin": {
-    "yarkr": "./dist/yarkr.js"
+    "yarkr": "./dist/yarkr.js",
+    "yarkr-cli": "./dist/yarkr.js"
   },
   "files": [
     "dist/yarkr.js",