@tryhermes/cli 0.1.0 → 0.1.2

package/dist/index.js

@@ -215,9 +215,9 @@ var require_help = __commonJS({
        * @param {Command} cmd
        * @returns {Command[]}
        */
-      visibleCommands(cmd) {
-        const visibleCommands = cmd.commands.filter((cmd2) => !cmd2._hidden);
-        const helpCommand = cmd._getHelpCommand();
+      visibleCommands(cmd2) {
+        const visibleCommands = cmd2.commands.filter((cmd3) => !cmd3._hidden);
+        const helpCommand = cmd2._getHelpCommand();
         if (helpCommand && !helpCommand._hidden) {
           visibleCommands.push(helpCommand);
         }
@@ -247,21 +247,21 @@ var require_help = __commonJS({
        * @param {Command} cmd
        * @returns {Option[]}
        */
-      visibleOptions(cmd) {
-        const visibleOptions = cmd.options.filter((option) => !option.hidden);
-        const helpOption = cmd._getHelpOption();
+      visibleOptions(cmd2) {
+        const visibleOptions = cmd2.options.filter((option) => !option.hidden);
+        const helpOption = cmd2._getHelpOption();
         if (helpOption && !helpOption.hidden) {
-          const removeShort = helpOption.short && cmd._findOption(helpOption.short);
-          const removeLong = helpOption.long && cmd._findOption(helpOption.long);
+          const removeShort = helpOption.short && cmd2._findOption(helpOption.short);
+          const removeLong = helpOption.long && cmd2._findOption(helpOption.long);
           if (!removeShort && !removeLong) {
             visibleOptions.push(helpOption);
           } else if (helpOption.long && !removeLong) {
             visibleOptions.push(
-              cmd.createOption(helpOption.long, helpOption.description)
+              cmd2.createOption(helpOption.long, helpOption.description)
             );
           } else if (helpOption.short && !removeShort) {
             visibleOptions.push(
-              cmd.createOption(helpOption.short, helpOption.description)
+              cmd2.createOption(helpOption.short, helpOption.description)
             );
           }
         }
@@ -276,10 +276,10 @@ var require_help = __commonJS({
        * @param {Command} cmd
        * @returns {Option[]}
        */
-      visibleGlobalOptions(cmd) {
+      visibleGlobalOptions(cmd2) {
         if (!this.showGlobalOptions) return [];
         const globalOptions = [];
-        for (let ancestorCmd = cmd.parent; ancestorCmd; ancestorCmd = ancestorCmd.parent) {
+        for (let ancestorCmd = cmd2.parent; ancestorCmd; ancestorCmd = ancestorCmd.parent) {
           const visibleOptions = ancestorCmd.options.filter(
             (option) => !option.hidden
           );
@@ -296,14 +296,14 @@ var require_help = __commonJS({
        * @param {Command} cmd
        * @returns {Argument[]}
        */
-      visibleArguments(cmd) {
-        if (cmd._argsDescription) {
-          cmd.registeredArguments.forEach((argument) => {
-            argument.description = argument.description || cmd._argsDescription[argument.name()] || "";
+      visibleArguments(cmd2) {
+        if (cmd2._argsDescription) {
+          cmd2.registeredArguments.forEach((argument) => {
+            argument.description = argument.description || cmd2._argsDescription[argument.name()] || "";
           });
         }
-        if (cmd.registeredArguments.find((argument) => argument.description)) {
-          return cmd.registeredArguments;
+        if (cmd2.registeredArguments.find((argument) => argument.description)) {
+          return cmd2.registeredArguments;
         }
         return [];
       }
@@ -313,9 +313,9 @@ var require_help = __commonJS({
        * @param {Command} cmd
        * @returns {string}
        */
-      subcommandTerm(cmd) {
-        const args = cmd.registeredArguments.map((arg) => humanReadableArgName(arg)).join(" ");
-        return cmd._name + (cmd._aliases[0] ? "|" + cmd._aliases[0] : "") + (cmd.options.length ? " [options]" : "") + // simplistic check for non-help option
+      subcommandTerm(cmd2) {
+        const args = cmd2.registeredArguments.map((arg) => humanReadableArgName(arg)).join(" ");
+        return cmd2._name + (cmd2._aliases[0] ? "|" + cmd2._aliases[0] : "") + (cmd2.options.length ? " [options]" : "") + // simplistic check for non-help option
         (args ? " " + args : "");
       }
       /**
@@ -343,8 +343,8 @@ var require_help = __commonJS({
        * @param {Help} helper
        * @returns {number}
        */
-      longestSubcommandTermLength(cmd, helper) {
-        return helper.visibleCommands(cmd).reduce((max, command) => {
+      longestSubcommandTermLength(cmd2, helper) {
+        return helper.visibleCommands(cmd2).reduce((max, command) => {
           return Math.max(max, helper.subcommandTerm(command).length);
         }, 0);
       }
@@ -355,8 +355,8 @@ var require_help = __commonJS({
        * @param {Help} helper
        * @returns {number}
        */
-      longestOptionTermLength(cmd, helper) {
-        return helper.visibleOptions(cmd).reduce((max, option) => {
+      longestOptionTermLength(cmd2, helper) {
+        return helper.visibleOptions(cmd2).reduce((max, option) => {
           return Math.max(max, helper.optionTerm(option).length);
         }, 0);
       }
@@ -367,8 +367,8 @@ var require_help = __commonJS({
        * @param {Help} helper
        * @returns {number}
        */
-      longestGlobalOptionTermLength(cmd, helper) {
-        return helper.visibleGlobalOptions(cmd).reduce((max, option) => {
+      longestGlobalOptionTermLength(cmd2, helper) {
+        return helper.visibleGlobalOptions(cmd2).reduce((max, option) => {
           return Math.max(max, helper.optionTerm(option).length);
         }, 0);
       }
@@ -379,8 +379,8 @@ var require_help = __commonJS({
        * @param {Help} helper
        * @returns {number}
        */
-      longestArgumentTermLength(cmd, helper) {
-        return helper.visibleArguments(cmd).reduce((max, argument) => {
+      longestArgumentTermLength(cmd2, helper) {
+        return helper.visibleArguments(cmd2).reduce((max, argument) => {
           return Math.max(max, helper.argumentTerm(argument).length);
         }, 0);
       }
@@ -390,16 +390,16 @@ var require_help = __commonJS({
        * @param {Command} cmd
        * @returns {string}
        */
-      commandUsage(cmd) {
-        let cmdName = cmd._name;
-        if (cmd._aliases[0]) {
-          cmdName = cmdName + "|" + cmd._aliases[0];
+      commandUsage(cmd2) {
+        let cmdName = cmd2._name;
+        if (cmd2._aliases[0]) {
+          cmdName = cmdName + "|" + cmd2._aliases[0];
         }
         let ancestorCmdNames = "";
-        for (let ancestorCmd = cmd.parent; ancestorCmd; ancestorCmd = ancestorCmd.parent) {
+        for (let ancestorCmd = cmd2.parent; ancestorCmd; ancestorCmd = ancestorCmd.parent) {
           ancestorCmdNames = ancestorCmd.name() + " " + ancestorCmdNames;
         }
-        return ancestorCmdNames + cmdName + " " + cmd.usage();
+        return ancestorCmdNames + cmdName + " " + cmd2.usage();
       }
       /**
        * Get the description for the command.
@@ -407,8 +407,8 @@ var require_help = __commonJS({
        * @param {Command} cmd
        * @returns {string}
        */
-      commandDescription(cmd) {
-        return cmd.description();
+      commandDescription(cmd2) {
+        return cmd2.description();
       }
       /**
        * Get the subcommand summary to show in the list of subcommands.
@@ -417,8 +417,8 @@ var require_help = __commonJS({
        * @param {Command} cmd
        * @returns {string}
        */
-      subcommandDescription(cmd) {
-        return cmd.summary() || cmd.description();
+      subcommandDescription(cmd2) {
+        return cmd2.summary() || cmd2.description();
       }
       /**
        * Get the option description to show in the list of options.
@@ -488,8 +488,8 @@ var require_help = __commonJS({
        * @param {Help} helper
        * @returns {string}
        */
-      formatHelp(cmd, helper) {
-        const termWidth = helper.padWidth(cmd, helper);
+      formatHelp(cmd2, helper) {
+        const termWidth = helper.padWidth(cmd2, helper);
         const helpWidth = helper.helpWidth || 80;
         const itemIndentWidth = 2;
         const itemSeparatorWidth = 2;
@@ -507,15 +507,15 @@ var require_help = __commonJS({
         function formatList(textArray) {
           return textArray.join("\n").replace(/^/gm, " ".repeat(itemIndentWidth));
         }
-        let output = [`Usage: ${helper.commandUsage(cmd)}`, ""];
-        const commandDescription = helper.commandDescription(cmd);
+        let output = [`Usage: ${helper.commandUsage(cmd2)}`, ""];
+        const commandDescription = helper.commandDescription(cmd2);
         if (commandDescription.length > 0) {
           output = output.concat([
             helper.wrap(commandDescription, helpWidth, 0),
             ""
           ]);
         }
-        const argumentList = helper.visibleArguments(cmd).map((argument) => {
+        const argumentList = helper.visibleArguments(cmd2).map((argument) => {
           return formatItem(
             helper.argumentTerm(argument),
             helper.argumentDescription(argument)
@@ -524,7 +524,7 @@ var require_help = __commonJS({
         if (argumentList.length > 0) {
           output = output.concat(["Arguments:", formatList(argumentList), ""]);
         }
-        const optionList = helper.visibleOptions(cmd).map((option) => {
+        const optionList = helper.visibleOptions(cmd2).map((option) => {
           return formatItem(
             helper.optionTerm(option),
             helper.optionDescription(option)
@@ -534,7 +534,7 @@ var require_help = __commonJS({
           output = output.concat(["Options:", formatList(optionList), ""]);
         }
         if (this.showGlobalOptions) {
-          const globalOptionList = helper.visibleGlobalOptions(cmd).map((option) => {
+          const globalOptionList = helper.visibleGlobalOptions(cmd2).map((option) => {
             return formatItem(
               helper.optionTerm(option),
               helper.optionDescription(option)
@@ -548,10 +548,10 @@ var require_help = __commonJS({
             ]);
           }
         }
-        const commandList = helper.visibleCommands(cmd).map((cmd2) => {
+        const commandList = helper.visibleCommands(cmd2).map((cmd3) => {
           return formatItem(
-            helper.subcommandTerm(cmd2),
-            helper.subcommandDescription(cmd2)
+            helper.subcommandTerm(cmd3),
+            helper.subcommandDescription(cmd3)
           );
         });
         if (commandList.length > 0) {
@@ -566,12 +566,12 @@ var require_help = __commonJS({
        * @param {Help} helper
        * @returns {number}
        */
-      padWidth(cmd, helper) {
+      padWidth(cmd2, helper) {
         return Math.max(
-          helper.longestOptionTermLength(cmd, helper),
-          helper.longestGlobalOptionTermLength(cmd, helper),
-          helper.longestSubcommandTermLength(cmd, helper),
-          helper.longestArgumentTermLength(cmd, helper)
+          helper.longestOptionTermLength(cmd2, helper),
+          helper.longestGlobalOptionTermLength(cmd2, helper),
+          helper.longestSubcommandTermLength(cmd2, helper),
+          helper.longestArgumentTermLength(cmd2, helper)
         );
       }
       /**
@@ -1098,20 +1098,20 @@ var require_command = __commonJS({
         }
         opts = opts || {};
         const [, name, args] = nameAndArgs.match(/([^ ]+) *(.*)/);
-        const cmd = this.createCommand(name);
+        const cmd2 = this.createCommand(name);
         if (desc) {
-          cmd.description(desc);
-          cmd._executableHandler = true;
-        }
-        if (opts.isDefault) this._defaultCommandName = cmd._name;
-        cmd._hidden = !!(opts.noHelp || opts.hidden);
-        cmd._executableFile = opts.executableFile || null;
-        if (args) cmd.arguments(args);
-        this._registerCommand(cmd);
-        cmd.parent = this;
-        cmd.copyInheritedSettings(this);
+          cmd2.description(desc);
+          cmd2._executableHandler = true;
+        }
+        if (opts.isDefault) this._defaultCommandName = cmd2._name;
+        cmd2._hidden = !!(opts.noHelp || opts.hidden);
+        cmd2._executableFile = opts.executableFile || null;
+        if (args) cmd2.arguments(args);
+        this._registerCommand(cmd2);
+        cmd2.parent = this;
+        cmd2.copyInheritedSettings(this);
         if (desc) return this;
-        return cmd;
+        return cmd2;
       }
       /**
        * Factory routine to create a new unattached command.
@@ -1199,17 +1199,17 @@ var require_command = __commonJS({
        * @param {object} [opts] - configuration options
        * @return {Command} `this` command for chaining
        */
-      addCommand(cmd, opts) {
-        if (!cmd._name) {
+      addCommand(cmd2, opts) {
+        if (!cmd2._name) {
           throw new Error(`Command passed to .addCommand() must have a name
 - specify the name in Command constructor or using .name()`);
         }
         opts = opts || {};
-        if (opts.isDefault) this._defaultCommandName = cmd._name;
-        if (opts.noHelp || opts.hidden) cmd._hidden = true;
-        this._registerCommand(cmd);
-        cmd.parent = this;
-        cmd._checkForBrokenPassThrough();
+        if (opts.isDefault) this._defaultCommandName = cmd2._name;
+        if (opts.noHelp || opts.hidden) cmd2._hidden = true;
+        this._registerCommand(cmd2);
+        cmd2.parent = this;
+        cmd2._checkForBrokenPassThrough();
         return this;
       }
       /**
@@ -1490,8 +1490,8 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @private
        */
       _registerCommand(command) {
-        const knownBy = (cmd) => {
-          return [cmd.name()].concat(cmd.aliases());
+        const knownBy = (cmd2) => {
+          return [cmd2.name()].concat(cmd2.aliases());
         };
         const alreadyUsed = knownBy(command).find(
           (name) => this._findCommand(name)
@@ -1781,9 +1781,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        */
       getOptionValueSourceWithGlobals(key) {
         let source;
-        this._getCommandAndAncestors().forEach((cmd) => {
-          if (cmd.getOptionValueSource(key) !== void 0) {
-            source = cmd.getOptionValueSource(key);
+        this._getCommandAndAncestors().forEach((cmd2) => {
+          if (cmd2.getOptionValueSource(key) !== void 0) {
+            source = cmd2.getOptionValueSource(key);
           }
         });
         return source;
@@ -2138,7 +2138,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
       _chainOrCallHooks(promise, event) {
         let result = promise;
         const hooks = [];
-        this._getCommandAndAncestors().reverse().filter((cmd) => cmd._lifeCycleHooks[event] !== void 0).forEach((hookedCommand) => {
+        this._getCommandAndAncestors().reverse().filter((cmd2) => cmd2._lifeCycleHooks[event] !== void 0).forEach((hookedCommand) => {
           hookedCommand._lifeCycleHooks[event].forEach((callback) => {
             hooks.push({ hookedCommand, callback });
           });
@@ -2261,7 +2261,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
       _findCommand(name) {
         if (!name) return void 0;
         return this.commands.find(
-          (cmd) => cmd._name === name || cmd._aliases.includes(name)
+          (cmd2) => cmd2._name === name || cmd2._aliases.includes(name)
         );
       }
       /**
@@ -2281,10 +2281,10 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @private
        */
       _checkForMissingMandatoryOptions() {
-        this._getCommandAndAncestors().forEach((cmd) => {
-          cmd.options.forEach((anOption) => {
-            if (anOption.mandatory && cmd.getOptionValue(anOption.attributeName()) === void 0) {
-              cmd.missingMandatoryOptionValue(anOption);
+        this._getCommandAndAncestors().forEach((cmd2) => {
+          cmd2.options.forEach((anOption) => {
+            if (anOption.mandatory && cmd2.getOptionValue(anOption.attributeName()) === void 0) {
+              cmd2.missingMandatoryOptionValue(anOption);
             }
           });
         });
@@ -2321,8 +2321,8 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @private
        */
       _checkForConflictingOptions() {
-        this._getCommandAndAncestors().forEach((cmd) => {
-          cmd._checkForConflictingLocalOptions();
+        this._getCommandAndAncestors().forEach((cmd2) => {
+          cmd2._checkForConflictingLocalOptions();
         });
       }
       /**
@@ -2452,7 +2452,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        */
       optsWithGlobals() {
         return this._getCommandAndAncestors().reduce(
-          (combinedOptions, cmd) => Object.assign(combinedOptions, cmd.opts()),
+          (combinedOptions, cmd2) => Object.assign(combinedOptions, cmd2.opts()),
           {}
         );
       }
@@ -6508,6 +6508,19 @@ var init_spinner = __esm({
   }
 });
 
+// src/lib/invocation.ts
+function invocation() {
+  return process.env.npm_config_user_agent ? "npx -y @tryhermes/cli@latest" : "hermes";
+}
+function cmd(sub) {
+  return `${invocation()} ${sub}`;
+}
+var init_invocation = __esm({
+  "src/lib/invocation.ts"() {
+    "use strict";
+  }
+});
+
 // src/lib/api-client.ts
 async function apiFetch(path, opts = {}) {
   const cfg = await loadConfig();
@@ -6517,7 +6530,7 @@ async function apiFetch(path, opts = {}) {
     throw new CliApiError(401, {
       code: "NOT_AUTHENTICATED",
       message: "Not signed in.",
-      hint: "Run `hermes auth login` (interactive) or `hermes auth login --key hk_\u2026` (CI)."
+      hint: `Run \`${cmd("auth login")}\` (interactive) or \`${cmd("auth login --key hk_\u2026")}\` (CI).`
     });
   }
   const url = new URL(path.startsWith("/") ? path : `/${path}`, apiUrl).toString();
@@ -6575,6 +6588,7 @@ var init_api_client = __esm({
     "use strict";
     init_config();
     init_spinner();
+    init_invocation();
     CliApiError = class extends Error {
       status;
       code;
@@ -6714,11 +6728,14 @@ async function runDeviceFlow() {
     method: "POST",
     skipAuth: true
   });
+  const { api_url } = await loadConfig();
+  const completeUrl = new URL(init.verification_uri_complete, api_url).toString();
+  const visitUrl = new URL(init.verification_uri, api_url).toString();
   console.log("");
   console.log("To authorize this CLI, open:");
-  console.log(`  ${init.verification_uri_complete}`);
+  console.log(`  ${completeUrl}`);
   console.log("");
-  console.log(`Or visit ${init.verification_uri} and enter the code:`);
+  console.log(`Or visit ${visitUrl} and enter the code:`);
   console.log(`  ${formatUserCode(init.user_code)}`);
   console.log("");
   console.log(`Waiting for approval (expires in ${Math.floor(init.expires_in / 60)} min)...`);
@@ -6738,18 +6755,18 @@ async function runDeviceFlow() {
       return;
     }
     if (poll.status === "expired") {
-      throw new Error("Code expired before approval. Re-run `hermes auth login`.");
+      throw new Error(`Code expired before approval. Re-run \`${cmd("auth login")}\`.`);
     }
     if (poll.status === "already_consumed") {
       throw new Error(
-        "This code was already used. Re-run `hermes auth login` to start fresh."
+        `This code was already used. Re-run \`${cmd("auth login")}\` to start fresh.`
       );
     }
     if (poll.status === "unknown") {
       throw new Error("Server didn't recognize the device code \u2014 start a new flow.");
     }
   }
-  throw new Error("Approval timeout \u2014 re-run `hermes auth login` and try again.");
+  throw new Error(`Approval timeout \u2014 re-run \`${cmd("auth login")}\` and try again.`);
 }
 async function maybeWhoami() {
   try {
@@ -6791,7 +6808,7 @@ function registerAuthCommand(program3) {
         console.log(`Logged in as ${me.user_email ?? me.user_id} (org "${me.org_slug}").`);
       } else {
         console.log(
-          "Next: `hermes orgs list` to see your orgs, then `hermes link --org <slug>`."
+          `Next: \`${cmd("orgs list")}\` to see your orgs, then \`${cmd("link --org <slug>")}\`.`
         );
       }
       process.exit(0);
@@ -6845,6 +6862,7 @@ var init_auth = __esm({
     "use strict";
     init_api_client();
     init_emit_error();
+    init_invocation();
     init_config();
   }
 });
@@ -6899,7 +6917,7 @@ function indent(text, prefix = "    ") {
 }
 function renderSchema(s) {
   const example = typeof s.example_query === "string" ? s.example_query : JSON.stringify(s.example_query, null, 2);
-  const snapshot = s.snapshot ? JSON.stringify(s.snapshot, null, 2) : "(no schema sampled yet \u2014 run `hermes connections inspect-schema`)";
+  const snapshot = s.snapshot ? JSON.stringify(s.snapshot, null, 2) : `(no schema sampled yet \u2014 run \`${cmd("connections inspect-schema")}\`)`;
   return [
     `Connection:   ${s.connection_id}`,
     `Source:       ${s.source_type}`,
@@ -6930,7 +6948,7 @@ async function resolveConnectionId(explicit) {
     throw new CliApiError(404, {
       code: "NOT_FOUND",
       message: "No connection in this org.",
-      hint: "Run `hermes connections add --postgres-url ...` (or another source flag) first."
+      hint: `Run \`${cmd("connections add --postgres-url ...")}\` (or another source flag) first.`
     });
   }
   return list.connections[0].id;
@@ -7027,7 +7045,7 @@ function registerConnectionsCommand(program3) {
         console.log(renderConnectionDetail(conn));
         console.log("");
         console.log(
-          "Next: run `hermes connections schema` to see the dialect + cached schema before writing a detection_query."
+          `Next: run \`${cmd("connections schema")}\` to see the dialect + cached schema before writing a detection_query.`
         );
       }
       process.exit(0);
@@ -7167,6 +7185,7 @@ var init_connections = __esm({
     init_api_client();
     init_api_client();
     init_emit_error();
+    init_invocation();
   }
 });
 
@@ -7284,7 +7303,7 @@ function registerDomainsCommand(program3) {
         console.log(renderDomainDetail(result));
         console.log("");
         console.log(
-          "Next: set the records above at your DNS provider, then run `hermes domains verify " + result.domain + "`."
+          `Next: set the records above at your DNS provider, then run \`${cmd("domains verify " + result.domain)}\`.`
         );
       }
       process.exit(0);
@@ -7332,6 +7351,7 @@ var init_domains = __esm({
     "use strict";
     init_api_client();
     init_emit_error();
+    init_invocation();
   }
 });
 
@@ -7585,7 +7605,7 @@ function registerLinkCommand(program3) {
       const match = list.orgs.find((o) => o.slug === requested);
       if (!match) {
         console.error(`Error: org "${requested}" not found or not accessible.`);
-        console.error("Run `hermes orgs list` to see what's available.");
+        console.error(`Run \`${cmd("orgs list")}\` to see what's available.`);
         process.exit(1);
       }
       await writeLinkedProject({ org_slug: match.slug, org_id: match.id });
@@ -7639,6 +7659,7 @@ var init_link = __esm({
     "use strict";
     init_api_client();
     init_emit_error();
+    init_invocation();
     init_config();
   }
 });
@@ -7691,7 +7712,7 @@ function renderOrgDetail(o, counts) {
 }
 function formatOrgsTable(items) {
   if (items.length === 0) {
-    return 'No orgs. Run `hermes orgs create --name "My Org"` to make one.';
+    return `No orgs. Run \`${cmd('orgs create --name "My Org"')}\` to make one.`;
   }
   const rows = items.map((o) => ({
     slug: o.slug,
@@ -7727,7 +7748,7 @@ function registerOrgsCommand(program3) {
       emitApiError(err, Boolean(opts.json));
     }
   });
-  const brandOptions = (cmd) => cmd.option("--logo-url <url>", "\u2192 logo_url").option("--description <text>", "\u2192 description").option("--from-name <name>", "\u2192 from_name (org-default From display name)").option("--reply-to <addr>", "\u2192 reply_to (org-default Reply-To)").option("--email-footer <text>", "\u2192 email_footer (org-default footer)").option("--company-md <path-or-text>", "\u2192 company_md (agent context; @file reads a file)");
+  const brandOptions = (cmd2) => cmd2.option("--logo-url <url>", "\u2192 logo_url").option("--description <text>", "\u2192 description").option("--from-name <name>", "\u2192 from_name (org-default From display name)").option("--reply-to <addr>", "\u2192 reply_to (org-default Reply-To)").option("--email-footer <text>", "\u2192 email_footer (org-default footer)").option("--company-md <path-or-text>", "\u2192 company_md (agent context; @file reads a file)");
   brandOptions(
     orgs.command("create").description("Create a new org (account-level auth only \u2014 API keys are org-scoped)").requiredOption("--name <name>", "human-readable org name").option("--slug <slug>", "explicit slug (otherwise derived from --name)")
   ).action(async function() {
@@ -7756,7 +7777,7 @@ function registerOrgsCommand(program3) {
     const opts = this.optsWithGlobals();
     const slug = await resolveOrgSlug(opts.org);
     if (!slug) {
-      console.error("Error: no org. Run `hermes link --org <slug>` or pass `--org <slug>`.");
+      console.error(`Error: no org. Run \`${cmd("link --org <slug>")}\` or pass \`--org <slug>\`.`);
       process.exit(1);
     }
     try {
@@ -7807,7 +7828,7 @@ function registerOrgsCommand(program3) {
     const opts = this.optsWithGlobals();
     const slug = await resolveOrgSlug(opts.org);
     if (!slug) {
-      console.error("Error: no org. Run `hermes link --org <slug>` or pass `--org <slug>`.");
+      console.error(`Error: no org. Run \`${cmd("link --org <slug>")}\` or pass \`--org <slug>\`.`);
       process.exit(1);
     }
     try {
@@ -7818,7 +7839,7 @@ function registerOrgsCommand(program3) {
       if (opts.json) {
         console.log(JSON.stringify(result, null, 2));
       } else {
-        console.log(`Deleted org ${result.slug} (${result.id}). Run \`hermes unlink\` to clear the local link.`);
+        console.log(`Deleted org ${result.slug} (${result.id}). Run \`${cmd("unlink")}\` to clear the local link.`);
       }
       process.exit(0);
     } catch (err) {
@@ -7833,6 +7854,7 @@ var init_orgs = __esm({
     import_promises2 = require("fs/promises");
     init_api_client();
     init_emit_error();
+    init_invocation();
     init_config();
   }
 });
@@ -7939,7 +7961,7 @@ function registerSendersCommand(program3) {
         console.log(renderSenderDetail(sender));
         console.log("");
         console.log(
-          "Next: attach to a trigger with `hermes triggers update <trigger-id> --sender " + sender.id + "`."
+          `Next: attach to a trigger with \`${cmd("triggers update <trigger-id> --sender " + sender.id)}\`.`
         );
       }
       process.exit(0);
@@ -8004,6 +8026,7 @@ var init_senders = __esm({
     "use strict";
     init_api_client();
     init_emit_error();
+    init_invocation();
   }
 });
 
@@ -8405,7 +8428,7 @@ var init_program = __esm({
     ).version("0.0.1").option("--org <slug>", "operate on this org (overrides ./.hermes/project.json)").option("--json", "emit structured JSON instead of human-readable output").option("--no-wait", "for async ops, return job_id immediately instead of polling").showHelpAfterError("(run with --help for usage)").action(() => program2.help());
     program2.addHelpText(
       "afterAll",
-      "\nDocs:  https://docs.tryhermes.dev\nRun:   npx -y @tryhermes/cli@latest <command>   (always uses the latest version)"
+      "\nDocs:   https://docs.tryhermes.dev\nSkill:  npx skills add tryhermes/skill   (teach your agent to drive this CLI)\nRun:    npx -y @tryhermes/cli@latest <command>   (always latest)"
     );
     program2.hook("preAction", (_thisCommand, actionCommand) => {
       setGlobalOrgOverride(actionCommand.optsWithGlobals().org);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tryhermes/cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Hermes CLI — drive the agentic email platform (connections, triggers, drafts, sends) from the terminal.",
   "license": "MIT",
   "main": "dist/index.js",
@@ -22,8 +22,8 @@
     "tsup": "^8.5.1",
     "tsx": "^4.19.2",
     "typescript": "^5.6.3",
-    "@workspace/eslint-config": "0.0.0",
     "@workspace/api-types": "0.0.1",
+    "@workspace/eslint-config": "0.0.0",
     "@workspace/typescript-config": "0.0.0"
   },
   "scripts": {