nia-wizard 0.1.27 → 0.1.29

package/README.md

@@ -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
@@ -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)     |
@@ -147,6 +154,26 @@ If you prefer, you can:
 - 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/api-keys`
+4. Tell the user to create an API key there
+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,7 +8,7 @@ import {
   runWizard,
   shutdown,
   track
-} from "./chunk-ZAV3ACJJ.js";
+} from "./chunk-CUR7WEDI.js";
 
 // src/bin.ts
 import yargs from "yargs";
@@ -21,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", {
@@ -41,14 +41,26 @@ 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) => {
-    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");
-    }
     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),
@@ -62,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\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  .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      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      try {\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    '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-ZAV3ACJJ.js → chunk-CUR7WEDI.js}

@@ -9,7 +9,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "nia-wizard",
-      version: "0.1.27",
+      version: "0.1.29",
       description: "CLI wizard to install Nia to your coding agents",
       packageManager: "pnpm@10.30.3",
       type: "module",
@@ -4002,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/api-keys`",
+    "",
+    "4. Tell the user to create an API key on that page 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/api-keys, sign in, 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 {
@@ -4101,6 +4086,7 @@ export {
   runMCPAdd,
   runMCPRemove,
   runSkillAdd,
+  getAgentGuideMarkdown,
   printAgentGuide
 };
-//# sourceMappingURL=chunk-ZAV3ACJJ.js.map
+//# sourceMappingURL=chunk-CUR7WEDI.js.map