nia-wizard 0.1.26 → 0.1.28

package/README.md

@@ -1,4 +1,4 @@
-# @nia/wizard
+# nia-wizard
 
 CLI wizard to install Nia to your coding agents via Nia CLI, Skills, or direct agent setup.
 
@@ -26,6 +26,12 @@ npx nia-wizard
 
 Press Enter to continue with the recommended default setup, which signs you in and installs or updates `nia-cli` to the latest version, or use the arrow keys to choose advanced or manual setup.
 
+Print the agent-specific onboarding prompt:
+
+```bash
+npx nia-wizard --agent
+```
+
 ### With API Key
 
 ```bash
@@ -41,20 +47,20 @@ npx nia-wizard nk_your_api_key
 If you already have an API key:
 
 ```bash
-npx @nia/wizard nk_your_api_key_here
+npx nia-wizard nk_your_api_key_here
 ```
 
 ### MCP Commands
 
 ```bash
 # Add Nia MCP server
-npx @nia/wizard mcp add
+npx nia-wizard mcp add
 
 # Add with API key and local mode
-npx @nia/wizard mcp add --api-key nk_xxx --local
+npx nia-wizard mcp add --api-key nk_xxx --local
 
 # Remove Nia MCP server
-npx @nia/wizard mcp remove
+npx nia-wizard mcp remove
 ```
 
 ### Skills Installation
@@ -102,10 +108,10 @@ npx nia-wizard skill add \
   --ci
 ```
 
-Print the headless onboarding guide for agents:
+Print the agent-facing onboarding prompt:
 
 ```bash
-npx nia-wizard agent-guide
+npx nia-wizard --agent
 ```
 
 ## Options
@@ -116,6 +122,7 @@ npx nia-wizard agent-guide
 | `--remote`          | Use remote mode (connects to Nia cloud)                        |
 | `--debug`           | Enable debug logging                                           |
 | `--ci`              | CI mode (skip prompts, use defaults)                           |
+| `--agent`           | Print agent-facing Nia CLI onboarding prompt (root command)   |
 | `--api-key`, `-k`   | Nia API key                                                    |
 | `--non-interactive` | Fail fast instead of waiting for prompts (skill command)       |
 | `--target`          | Target coding agent for skill installation (skill command)     |
@@ -144,9 +151,29 @@ This is the fastest way to get started - no manual copying required!
 If you prefer, you can:
 
 - Get your API key from [app.trynia.ai](https://app.trynia.ai)
-- Pass it directly: `npx @nia/wizard nk_xxx`
+- Pass it directly: `npx nia-wizard nk_xxx`
 - Or select "Enter API key manually" when prompted
 
+## Agent Onboarding Prompt
+
+Use the root `--agent` flag when you want an external coding agent to perform the Nia CLI setup steps on the user's machine instead of launching the local interactive wizard.
+
+```bash
+npx nia-wizard --agent
+```
+
+This prints the canonical agent workflow:
+
+1. Run `bun --version`
+2. Install `@nozomioai/nia@latest` globally with Bun or npm
+3. Tell the user to open `https://app.trynia.ai`
+4. Tell the user to go to `Settings -> API Keys` and create an API key
+5. Ask the user to paste the `nk_...` key back to the agent
+6. Run `nia auth login --api-key <nk_api_key>`
+7. Run `nia skill --all`
+
+This is a prompt-only flow intended for external agents. The user retrieves the API key manually and sends it back to the agent to finish setup.
+
 ## Supported Coding Agents
 
 ### Full Support (Local + Remote)

package/dist/bin.js

@@ -8,11 +8,12 @@ import {
   runWizard,
   shutdown,
   track
-} from "./chunk-TOXYR2OK.js";
+} from "./chunk-5A4LUPM5.js";
 
 // src/bin.ts
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
+var isInteractive = Boolean(process.stdin.isTTY);
 function printCliError(error) {
   if (error instanceof Error) {
     console.error(`Error: ${error.message}`);
@@ -20,7 +21,7 @@ function printCliError(error) {
   }
   console.error("Error:", error);
 }
-var cli = yargs(hideBin(process.argv)).scriptName("nia-wizard").usage("$0 [api-key] [options]").usage("$0 mcp add [options]").usage("$0 mcp remove [options]").usage("$0 skill add [options]").usage("$0 agent-guide").command(
+var cli = yargs(hideBin(process.argv)).scriptName("nia-wizard").usage("$0 [api-key] [options]").usage("$0 mcp add [options]").usage("$0 mcp remove [options]").usage("$0 skill add [options]").command(
   "$0 [api-key]",
   "Install Nia to your coding agents",
   (yargs2) => yargs2.positional("api-key", {
@@ -40,14 +41,31 @@ var cli = yargs(hideBin(process.argv)).scriptName("nia-wizard").usage("$0 [api-k
     type: "boolean",
     default: false,
     description: "CI mode (skip prompts)"
+  }).option("agent", {
+    type: "boolean",
+    default: false,
+    description: "Print agent-facing Nia CLI onboarding prompt"
   }),
   async (argv) => {
     try {
+      if (argv.agent) {
+        printAgentGuide();
+        return;
+      }
+      const apiKeyArg = typeof argv["api-key"] === "string" ? argv["api-key"] : typeof argv.apiKey === "string" ? argv.apiKey : void 0;
+      if (apiKeyArg === "agent-guide") {
+        throw new Error("The `agent-guide` subcommand has been removed. Use `npx nia-wizard --agent`.");
+      }
+      const ci = argv.ci || !isInteractive;
+      if (!isInteractive && !argv.ci) {
+        console.log("Non-interactive terminal detected, running in CI mode.");
+        console.log("For the full interactive experience, run: npx nia-wizard\n");
+      }
       await runWizard({
         apiKey: argv["api-key"],
         local: argv.local ?? (argv.remote ? false : void 0),
         debug: argv.debug,
-        ci: argv.ci
+        ci
       });
     } catch (error) {
       track("cli_wizard_error", { error_type: "wizard", error_message: error instanceof Error ? error.message : String(error) });
@@ -56,14 +74,6 @@ var cli = yargs(hideBin(process.argv)).scriptName("nia-wizard").usage("$0 [api-k
       process.exit(1);
     }
   }
-).command(
-  "agent-guide",
-  "Print API-first agent onboarding guide in Markdown",
-  () => {
-  },
-  () => {
-    printAgentGuide();
-  }
 ).command(
   "skill <command>",
   "Manage skill installation",

package/dist/bin.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/bin.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport yargs from 'yargs';\nimport { hideBin } from 'yargs/helpers';\nimport { runWizard } from './run.js';\nimport { runMCPAdd, runMCPRemove } from './mcp.js';\nimport { runSkillAdd } from './skill.js';\nimport { printAgentGuide } from './agent-guide.js';\nimport { track, shutdown } from './utils/analytics.js';\n\nfunction printCliError(error: unknown): void {\n  if (error instanceof Error) {\n    console.error(`Error: ${error.message}`);\n    return;\n  }\n\n  console.error('Error:', error);\n}\n\nconst cli = yargs(hideBin(process.argv))\n  .scriptName('nia-wizard')\n  .usage('$0 [api-key] [options]')\n  .usage('$0 mcp add [options]')\n  .usage('$0 mcp remove [options]')\n  .usage('$0 skill add [options]')\n  .usage('$0 agent-guide')\n  .command(\n    '$0 [api-key]',\n    'Install Nia to your coding agents',\n    (yargs) =>\n      yargs\n        .positional('api-key', {\n          type: 'string',\n          description: 'Nia API key (nk_xxx)',\n        })\n        .option('local', {\n          type: 'boolean',\n          description: 'Use local mode (requires pipx)',\n        })\n        .option('remote', {\n          type: 'boolean',\n          description: 'Use remote mode (cloud)',\n        })\n        .option('debug', {\n          type: 'boolean',\n          default: false,\n          description: 'Enable debug logging',\n        })\n        .option('ci', {\n          type: 'boolean',\n          default: false,\n          description: 'CI mode (skip prompts)',\n        }),\n    async (argv) => {\n      try {\n        await runWizard({\n          apiKey: argv['api-key'],\n          local: argv.local ?? (argv.remote ? false : undefined),\n          debug: argv.debug,\n          ci: argv.ci,\n        });\n      } catch (error) {\n        track('cli_wizard_error', { error_type: 'wizard', error_message: error instanceof Error ? error.message : String(error) });\n        await shutdown();\n        printCliError(error);\n        process.exit(1);\n      }\n    },\n  )\n  .command(\n    'agent-guide',\n    'Print API-first agent onboarding guide in Markdown',\n    () => {},\n    () => {\n      printAgentGuide();\n    },\n  )\n  .command(\n    'skill <command>',\n    'Manage skill installation',\n    (yargs) =>\n      yargs\n        .command(\n          'add',\n          'Add Nia skill',\n          (yargs) =>\n            yargs\n              .option('api-key', {\n                type: 'string',\n                alias: 'k',\n                description: 'Nia API key (nk_xxx)',\n              })\n              .option('source', {\n                type: 'string',\n                default: 'nozomio-labs/nia-skill',\n                description: 'Skill source to install',\n              })\n              .option('target', {\n                type: 'string',\n                description: 'Target coding agent for skill installation',\n              })\n              .option('all-agents', {\n                type: 'boolean',\n                default: false,\n                description: 'Install to all detected agents (non-interactive)',\n              })\n              .option('global', {\n                type: 'boolean',\n                description: 'Install to global user skills directories',\n              })\n              .option('yes', {\n                type: 'boolean',\n                default: false,\n                description: 'Auto-confirm prompts when supported by the skills CLI',\n              })\n              .option('non-interactive', {\n                type: 'boolean',\n                default: false,\n                description: 'Fail fast instead of waiting for prompts',\n              })\n              .option('json', {\n                type: 'boolean',\n                default: false,\n                description: 'Print machine-readable install result',\n              })\n              .option('debug', {\n                type: 'boolean',\n                default: false,\n                description: 'Enable debug logging',\n              })\n              .option('ci', {\n                type: 'boolean',\n                default: false,\n                description: 'CI mode (implies non-interactive behavior)',\n              }),\n          async (argv) => {\n            try {\n              await runSkillAdd({\n                apiKey: argv['api-key'],\n                source: argv.source,\n                target: argv.target,\n                allAgents: argv['all-agents'],\n                global: argv.global,\n                yes: argv.yes,\n                nonInteractive: argv['non-interactive'],\n                json: argv.json,\n                debug: argv.debug,\n                ci: argv.ci,\n              });\n            } catch (error) {\n              printCliError(error);\n              process.exit(1);\n            }\n          },\n        )\n        .demandCommand(1, 'You need to specify a command (add)'),\n    () => {},\n  )\n  .command(\n    'mcp <command>',\n    'Manage direct agent setup',\n    (yargs) =>\n      yargs\n        .command(\n          'add',\n          'Add Nia to coding agents',\n          (yargs) =>\n            yargs\n              .option('api-key', {\n                type: 'string',\n                alias: 'k',\n                description: 'Nia API key (nk_xxx)',\n              })\n              .option('local', {\n                type: 'boolean',\n                description: 'Use local mode',\n              })\n              .option('remote', {\n                type: 'boolean',\n                description: 'Use remote mode',\n              })\n              .option('debug', {\n                type: 'boolean',\n                default: false,\n                description: 'Enable debug logging',\n              })\n              .option('ci', {\n                type: 'boolean',\n                default: false,\n                description: 'CI mode (skip prompts)',\n              }),\n          async (argv) => {\n            try {\n              await runMCPAdd({\n                apiKey: argv['api-key'],\n                local: argv.local ?? (argv.remote ? false : undefined),\n                debug: argv.debug,\n                ci: argv.ci,\n              });\n            } catch (error) {\n              printCliError(error);\n              process.exit(1);\n            }\n          },\n        )\n        .command(\n          'remove',\n          'Remove Nia from coding agents',\n          (yargs) =>\n            yargs.option('debug', {\n              type: 'boolean',\n              default: false,\n              description: 'Enable debug logging',\n            }),\n          async (argv) => {\n            try {\n              await runMCPRemove({ debug: argv.debug });\n            } catch (error) {\n              printCliError(error);\n              process.exit(1);\n            }\n          },\n        )\n        .demandCommand(1, 'You need to specify a command (add or remove)'),\n    () => {},\n  )\n  .help()\n  .version()\n  .strict();\n\ncli.parse();\n"],"mappings":"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","names":["yargs"]}
+{"version":3,"sources":["../src/bin.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport yargs from 'yargs';\nimport { hideBin } from 'yargs/helpers';\nimport { runWizard } from './run.js';\nimport { runMCPAdd, runMCPRemove } from './mcp.js';\nimport { runSkillAdd } from './skill.js';\nimport { printAgentGuide } from './agent-guide.js';\nimport { track, shutdown } from './utils/analytics.js';\n\nconst isInteractive = Boolean(process.stdin.isTTY);\n\nfunction printCliError(error: unknown): void {\n  if (error instanceof Error) {\n    console.error(`Error: ${error.message}`);\n    return;\n  }\n\n  console.error('Error:', error);\n}\n\nconst cli = yargs(hideBin(process.argv))\n  .scriptName('nia-wizard')\n  .usage('$0 [api-key] [options]')\n  .usage('$0 mcp add [options]')\n  .usage('$0 mcp remove [options]')\n  .usage('$0 skill add [options]')\n  .command(\n    '$0 [api-key]',\n    'Install Nia to your coding agents',\n    (yargs) =>\n      yargs\n        .positional('api-key', {\n          type: 'string',\n          description: 'Nia API key (nk_xxx)',\n        })\n        .option('local', {\n          type: 'boolean',\n          description: 'Use local mode (requires pipx)',\n        })\n        .option('remote', {\n          type: 'boolean',\n          description: 'Use remote mode (cloud)',\n        })\n        .option('debug', {\n          type: 'boolean',\n          default: false,\n          description: 'Enable debug logging',\n        })\n        .option('ci', {\n          type: 'boolean',\n          default: false,\n          description: 'CI mode (skip prompts)',\n        })\n        .option('agent', {\n          type: 'boolean',\n          default: false,\n          description: 'Print agent-facing Nia CLI onboarding prompt',\n        }),\n    async (argv) => {\n      try {\n        if (argv.agent) {\n          printAgentGuide();\n          return;\n        }\n\n        const apiKeyArg = typeof argv['api-key'] === 'string'\n          ? argv['api-key']\n          : typeof argv.apiKey === 'string'\n            ? argv.apiKey\n            : undefined;\n\n        if (apiKeyArg === 'agent-guide') {\n          throw new Error('The `agent-guide` subcommand has been removed. Use `npx nia-wizard --agent`.');\n        }\n\n        const ci = argv.ci || !isInteractive;\n        if (!isInteractive && !argv.ci) {\n          console.log('Non-interactive terminal detected, running in CI mode.');\n          console.log('For the full interactive experience, run: npx nia-wizard\\n');\n        }\n\n        await runWizard({\n          apiKey: argv['api-key'],\n          local: argv.local ?? (argv.remote ? false : undefined),\n          debug: argv.debug,\n          ci,\n        });\n      } catch (error) {\n        track('cli_wizard_error', { error_type: 'wizard', error_message: error instanceof Error ? error.message : String(error) });\n        await shutdown();\n        printCliError(error);\n        process.exit(1);\n      }\n    },\n  )\n  .command(\n    'skill <command>',\n    'Manage skill installation',\n    (yargs) =>\n      yargs\n        .command(\n          'add',\n          'Add Nia skill',\n          (yargs) =>\n            yargs\n              .option('api-key', {\n                type: 'string',\n                alias: 'k',\n                description: 'Nia API key (nk_xxx)',\n              })\n              .option('source', {\n                type: 'string',\n                default: 'nozomio-labs/nia-skill',\n                description: 'Skill source to install',\n              })\n              .option('target', {\n                type: 'string',\n                description: 'Target coding agent for skill installation',\n              })\n              .option('all-agents', {\n                type: 'boolean',\n                default: false,\n                description: 'Install to all detected agents (non-interactive)',\n              })\n              .option('global', {\n                type: 'boolean',\n                description: 'Install to global user skills directories',\n              })\n              .option('yes', {\n                type: 'boolean',\n                default: false,\n                description: 'Auto-confirm prompts when supported by the skills CLI',\n              })\n              .option('non-interactive', {\n                type: 'boolean',\n                default: false,\n                description: 'Fail fast instead of waiting for prompts',\n              })\n              .option('json', {\n                type: 'boolean',\n                default: false,\n                description: 'Print machine-readable install result',\n              })\n              .option('debug', {\n                type: 'boolean',\n                default: false,\n                description: 'Enable debug logging',\n              })\n              .option('ci', {\n                type: 'boolean',\n                default: false,\n                description: 'CI mode (implies non-interactive behavior)',\n              }),\n          async (argv) => {\n            try {\n              await runSkillAdd({\n                apiKey: argv['api-key'],\n                source: argv.source,\n                target: argv.target,\n                allAgents: argv['all-agents'],\n                global: argv.global,\n                yes: argv.yes,\n                nonInteractive: argv['non-interactive'],\n                json: argv.json,\n                debug: argv.debug,\n                ci: argv.ci,\n              });\n            } catch (error) {\n              printCliError(error);\n              process.exit(1);\n            }\n          },\n        )\n        .demandCommand(1, 'You need to specify a command (add)'),\n    () => {},\n  )\n  .command(\n    'mcp <command>',\n    'Manage direct agent setup',\n    (yargs) =>\n      yargs\n        .command(\n          'add',\n          'Add Nia to coding agents',\n          (yargs) =>\n            yargs\n              .option('api-key', {\n                type: 'string',\n                alias: 'k',\n                description: 'Nia API key (nk_xxx)',\n              })\n              .option('local', {\n                type: 'boolean',\n                description: 'Use local mode',\n              })\n              .option('remote', {\n                type: 'boolean',\n                description: 'Use remote mode',\n              })\n              .option('debug', {\n                type: 'boolean',\n                default: false,\n                description: 'Enable debug logging',\n              })\n              .option('ci', {\n                type: 'boolean',\n                default: false,\n                description: 'CI mode (skip prompts)',\n              }),\n          async (argv) => {\n            try {\n              await runMCPAdd({\n                apiKey: argv['api-key'],\n                local: argv.local ?? (argv.remote ? false : undefined),\n                debug: argv.debug,\n                ci: argv.ci,\n              });\n            } catch (error) {\n              printCliError(error);\n              process.exit(1);\n            }\n          },\n        )\n        .command(\n          'remove',\n          'Remove Nia from coding agents',\n          (yargs) =>\n            yargs.option('debug', {\n              type: 'boolean',\n              default: false,\n              description: 'Enable debug logging',\n            }),\n          async (argv) => {\n            try {\n              await runMCPRemove({ debug: argv.debug });\n            } catch (error) {\n              printCliError(error);\n              process.exit(1);\n            }\n          },\n        )\n        .demandCommand(1, 'You need to specify a command (add or remove)'),\n    () => {},\n  )\n  .help()\n  .version()\n  .strict();\n\ncli.parse();\n"],"mappings":"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","names":["yargs"]}

package/dist/{chunk-TOXYR2OK.js → chunk-5A4LUPM5.js}

@@ -9,8 +9,9 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "nia-wizard",
-      version: "0.1.26",
+      version: "0.1.28",
       description: "CLI wizard to install Nia to your coding agents",
+      packageManager: "pnpm@10.30.3",
       type: "module",
       main: "dist/index.js",
       bin: {
@@ -18,10 +19,13 @@ var require_package = __commonJS({
       },
       scripts: {
         build: "tsup",
+        changeset: "changeset",
         dev: "tsup --watch",
         start: "node dist/bin.js",
         try: "pnpm build && node dist/bin.js",
         typecheck: "tsc --noEmit",
+        "version-packages": "changeset version",
+        release: "pnpm build && changeset publish",
         lint: "eslint src --ext .ts",
         prepublishOnly: "pnpm build"
       },
@@ -43,7 +47,11 @@ var require_package = __commonJS({
       license: "MIT",
       repository: {
         type: "git",
-        url: "https://github.com/nozomio/nia-wizard"
+        url: "git+https://github.com/nozomio-labs/nia-wizard.git"
+      },
+      homepage: "https://github.com/nozomio-labs/nia-wizard",
+      bugs: {
+        url: "https://github.com/nozomio-labs/nia-wizard/issues"
       },
       dependencies: {
         "@clack/prompts": "^0.9.1",
@@ -55,6 +63,7 @@ var require_package = __commonJS({
         zod: "^3.24.0"
       },
       devDependencies: {
+        "@changesets/cli": "^2.30.0",
         "@types/node": "^22.10.0",
         "@types/yargs": "^17.0.33",
         tsup: "^8.3.5",
@@ -483,6 +492,18 @@ async function getApiKey(providedKey, options = {}) {
   track("cli_auth_completed", { auth_method: authMethod, duration_ms: Date.now() - authStartTime });
   return apiKey;
 }
+function printManualOnboardingFallback() {
+  console.log("");
+  clack_default.note(
+    `${chalk.bold("Finish setup at:")}
+
+    ${chalk.cyan(NIA_APP_URL)}
+
+Once signed in, go to ${chalk.bold("Settings \u2192 API Keys")} to create a key.
+Then re-run: ${chalk.yellow("npx nia-wizard <your-api-key>")}`,
+    "Manual Setup"
+  );
+}
 async function runDeviceFlow() {
   const spinner = clack_default.spinner();
   spinner.start("Connecting to Nia...");
@@ -499,6 +520,7 @@ async function runDeviceFlow() {
       clack_default.log.error("Failed to connect to Nia servers. Check your internet connection.");
       debug(`Device flow error: ${error}`);
     }
+    printManualOnboardingFallback();
     clack_default.log.info("Falling back to manual API key entry.");
     return await promptForManualApiKey();
   }
@@ -544,7 +566,8 @@ async function waitForAuthorizationAndExchange(session) {
   while (true) {
     if (!isSessionValid(session)) {
       spinner.stop("Session expired");
-      clack_default.log.error("Session has expired. Please start over.");
+      clack_default.log.error("Authorization session expired before completing.");
+      printManualOnboardingFallback();
       return abort("Session expired", 1);
     }
     try {
@@ -560,8 +583,8 @@ async function waitForAuthorizationAndExchange(session) {
             break;
           case "expired":
             spinner.stop("Session expired");
-            clack_default.log.error("Session has expired.");
-            clack_default.log.info("Please run the wizard again to start a new session.");
+            clack_default.log.error("Authorization session expired.");
+            printManualOnboardingFallback();
             return abort("Session expired", 1);
           case "consumed":
             spinner.stop("Session already used");
@@ -571,21 +594,21 @@ async function waitForAuthorizationAndExchange(session) {
           case "invalid":
             spinner.stop("Invalid session");
             clack_default.log.error(error.message);
-            clack_default.log.info("Please run the wizard again to start a new session.");
+            printManualOnboardingFallback();
             return abort("Invalid session", 1);
           case "network":
             consecutiveNetworkErrors++;
             if (consecutiveNetworkErrors >= MAX_NETWORK_ERRORS) {
               spinner.stop("Connection failed");
               clack_default.log.error(`Failed to reach Nia servers after ${MAX_NETWORK_ERRORS} attempts.`);
-              clack_default.log.info("Falling back to manual API key entry.");
+              printManualOnboardingFallback();
               return await promptForManualApiKey();
             }
             break;
           default:
             spinner.stop("Error");
             clack_default.log.error(error.message);
-            clack_default.log.info("Falling back to manual API key entry.");
+            printManualOnboardingFallback();
             return await promptForManualApiKey();
         }
       } else {
@@ -594,7 +617,7 @@ async function waitForAuthorizationAndExchange(session) {
           spinner.stop("Connection failed");
           clack_default.log.error("Lost connection to Nia servers.");
           debug(`Exchange error: ${error}`);
-          clack_default.log.info("Falling back to manual API key entry.");
+          printManualOnboardingFallback();
           return await promptForManualApiKey();
         }
       }
@@ -604,6 +627,10 @@ async function waitForAuthorizationAndExchange(session) {
   }
 }
 async function promptForManualApiKey() {
+  if (!process.stdin.isTTY) {
+    printManualOnboardingFallback();
+    return abort("No interactive terminal available. Please re-run with an API key.", 1);
+  }
   const shouldOpen = await abortIfCancelled(
     clack_default.confirm({
       message: `Open ${chalk.cyan(NIA_APP_URL)} to get your API key?`,
@@ -3409,7 +3436,7 @@ async function runAddMcpInstall(apiKey) {
   const result = spawnSync6(
     "npx",
     [
-      "add-mcp",
+      "add-mcp@latest",
       REMOTE_MCP_URL,
       "--header",
       `"Authorization: Bearer ${apiKey}"`,
@@ -3426,7 +3453,7 @@ async function runAddMcpInstall(apiKey) {
 }
 async function runSkillsInstall() {
   clack_default.log.info("Launching Nia skill installer...\n");
-  const result = spawnSync6("npx", ["skills", "add", "nozomio-labs/nia-skill"], {
+  const result = spawnSync6("npx", ["skills@latest", "add", "nozomio-labs/nia-skill"], {
     stdio: "inherit",
     shell: true
   });
@@ -3975,86 +4002,71 @@ function runSkillsInstall2(params) {
 }
 
 // src/agent-guide.ts
-var AGENT_GUIDE_MARKDOWN = [
-  "# Nia Agent Onboarding (Headless)",
-  "",
-  "Use this flow when an agent cannot complete browser-based setup.",
-  "",
-  "## Base URL",
-  "",
-  "`https://apigcp.trynia.ai/v2`",
-  "",
-  "## New Account",
-  "",
-  "1. Create account + bootstrap token:",
-  "",
-  "```bash",
-  'curl -sS -X POST "https://apigcp.trynia.ai/v2/auth/signup" \\',
-  '  -H "Content-Type: application/json" \\',
-  `  -d '{"email":"agent@example.com","password":"strong-password-123","organization_name":"Agent Org"}'`,
-  "```",
-  "",
-  "2. Exchange bootstrap token for API key:",
-  "",
-  "```bash",
-  'curl -sS -X POST "https://apigcp.trynia.ai/v2/auth/bootstrap-key" \\',
-  '  -H "Content-Type: application/json" \\',
-  `  -d '{"bootstrap_token":"<bootstrap-token>"}'`,
-  "```",
-  "",
-  "## Existing Account",
-  "",
-  "Create API key directly with email/password:",
-  "",
-  "```bash",
-  'curl -sS -X POST "https://apigcp.trynia.ai/v2/auth/login-key" \\',
-  '  -H "Content-Type: application/json" \\',
-  `  -d '{"email":"agent@example.com","password":"strong-password-123"}'`,
-  "```",
-  "",
-  "## Install Nia Skill (Non-Interactive)",
-  "",
-  "Install for all detected agents:",
-  "",
-  "```bash",
-  "npx nia-wizard skill add \\",
-  '  --api-key "<nk_api_key>" \\',
-  "  --source nozomio-labs/nia-skill \\",
-  "  --all-agents \\",
-  "  --non-interactive \\",
-  "  --ci",
-  "```",
-  "",
-  "Install for one target agent:",
-  "",
-  "```bash",
-  "npx nia-wizard skill add \\",
-  '  --api-key "<nk_api_key>" \\',
-  "  --source nozomio-labs/nia-skill \\",
-  "  --non-interactive \\",
-  "  --ci",
-  "```",
-  "",
-  "Target pinning example:",
-  "",
-  "```bash",
-  'npx nia-wizard skill add --api-key "<nk_api_key>" --target codex --non-interactive --ci',
-  "```",
-  "",
-  "Supported `--target` values:",
-  "",
-  "`amp`, `kimi-cli`, `replit`, `universal`, `antigravity`, `augment`, `claude-code`, `openclaw`, `cline`, `codebuddy`, `codex`, `command-code`, `continue`, `cortex`, `crush`, `cursor`, `droid`, `gemini-cli`, `github-copilot`, `goose`, `junie`, `iflow-cli`, `kilo`, `kiro-cli`, `kode`, `mcpjam`, `mistral-vibe`, `mux`, `opencode`, `openhands`, `pi`, `qoder`, `qwen-code`, `roo`, `trae`, `trae-cn`, `windsurf`, `zencoder`, `neovate`, `pochi`, `adal`",
-  "",
-  "## Command",
-  "",
-  "Print this guide any time:",
-  "",
-  "```bash",
-  "npx nia-wizard agent-guide",
-  "```"
-].join("\n");
+function getAgentGuideMarkdown() {
+  return [
+    "# Nia Agent Onboarding Prompt",
+    "",
+    "Run this workflow when you are setting up Nia for the user from an external coding agent session.",
+    "",
+    "## Goal",
+    "",
+    "Install the Nia CLI, direct the user to retrieve their API key manually, ask them to paste the key back to you, then finish CLI authentication and skill setup.",
+    "",
+    "## Steps",
+    "",
+    "1. Check whether Bun is installed:",
+    "",
+    "```bash",
+    "bun --version",
+    "```",
+    "",
+    "2. Install `@nozomioai/nia@latest` globally:",
+    "",
+    "- If `bun --version` succeeds, run:",
+    "",
+    "```bash",
+    "bun add -g @nozomioai/nia@latest",
+    "```",
+    "",
+    "- If `bun --version` fails, run:",
+    "",
+    "```bash",
+    "npm install -g @nozomioai/nia@latest",
+    "```",
+    "",
+    "3. Tell the user to open this URL and sign in:",
+    "",
+    "`https://app.trynia.ai`",
+    "",
+    "4. Tell the user to go to `Settings -> API Keys`, create a key, and copy the `nk_...` token.",
+    "",
+    "5. Ask the user to paste the API key back into the agent chat or session.",
+    "",
+    "6. After the user provides the key, configure the CLI:",
+    "",
+    "```bash",
+    "nia auth login --api-key <nk_api_key>",
+    "```",
+    "",
+    "7. Configure Nia skills:",
+    "",
+    "```bash",
+    "nia skill --all",
+    "```",
+    "",
+    "## Agent Message Template",
+    "",
+    "Send the user a message like this:",
+    "",
+    "> I need your Nia API key to finish setup. Please open https://app.trynia.ai, sign in, go to Settings -> API Keys, create a key, and paste the `nk_...` value here. Once you send it, I will finish the setup for you.",
+    "",
+    "## Expected Result",
+    "",
+    "`nia` is installed, authenticated with the user-provided API key, and `nia skill --all` has completed."
+  ].join("\n");
+}
 function printAgentGuide() {
-  console.log(AGENT_GUIDE_MARKDOWN);
+  console.log(getAgentGuideMarkdown());
 }
 
 export {
@@ -4074,6 +4086,7 @@ export {
   runMCPAdd,
   runMCPRemove,
   runSkillAdd,
+  getAgentGuideMarkdown,
   printAgentGuide
 };
-//# sourceMappingURL=chunk-TOXYR2OK.js.map
+//# sourceMappingURL=chunk-5A4LUPM5.js.map