@posthog/wizard 1.20.0 → 1.21.1

package/README.md

@@ -3,8 +3,7 @@
 </p>
 
 > **⚠️ Experimental:** This wizard is still in an experimental phase. If you
-> have any feedback, please drop an email to **joshua** [at] **posthog** [dot] >
-> **com**.
+> have any feedback, please drop an email to **[wizard@posthog.com](mailto:wizard@posthog.com)**.
 
 <h1>PostHog wizard ✨</h1>
 <h4>The PostHog wizard helps you quickly add PostHog to your project using AI.</h4>
@@ -116,36 +115,27 @@ users of the wizard, no training delays or other ambiguity.
 
 ## Running locally
 
-Run:
+### Quick test without linking
 
 ```bash
 pnpm try --install-dir=[a path]
 ```
 
-To build and use the tool locally:
+### Development with auto-rebuild
 
 ```bash
-bin/build
+pnpm run dev
 ```
 
-This compiles the TypeScript code and prepares the `dist` directory. Run this
-command any time you make changes to the wizard's source code.
+This builds, links globally, and watches for changes. Leave it running - any `.ts` file changes will auto-rebuild. Then from any project:
 
 ```bash
-pnpm link --global
-```
-
-This command makes your local version of the wizard available system-wide. You
-generally only need to do this once.
-
-Then:
+wizard --integration=nextjs
 
-```bash
-wizard [options]
+# Or use local MCP server:
+wizard --integration=nextjs --local-mcp
 ```
 
-The wizard will execute your last build.
-
 ## Testing
 
 To run unit tests, run:

package/dist/bin.js

@@ -66,6 +66,11 @@ if (process.env.NODE_ENV === 'test') {
         describe: 'Create a new PostHog account during setup\nenv: POSTHOG_WIZARD_SIGNUP',
         type: 'boolean',
     },
+    'local-mcp': {
+        default: false,
+        describe: 'Use local MCP server at http://localhost:8787/mcp\nenv: POSTHOG_WIZARD_LOCAL_MCP',
+        type: 'boolean',
+    },
 })
     .command(['$0'], 'Run the PostHog setup wizard', (yargs) => {
     return yargs.options({
@@ -119,6 +124,7 @@ if (process.env.NODE_ENV === 'test') {
         default: finalArgs.default ?? false,
         signup: finalArgs.signup ?? false,
         forceInstall: false,
+        localMcp: finalArgs.localMcp ?? false,
     };
     void (0, event_setup_1.runEventSetupWizard)(wizardOptions);
 })

package/dist/bin.js.map

@@ -1 +1 @@
-{"version":3,"file":"bin.js","sourceRoot":"","sources":["../bin.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\nimport { satisfies } from 'semver';\nimport { red } from './src/utils/logging';\n\nimport yargs from 'yargs';\nimport { hideBin } from 'yargs/helpers';\nimport chalk from 'chalk';\n\nconst NODE_VERSION_RANGE = '>=18.17.0';\n\n// Have to run this above the other imports because they are importing clack that\n// has the problematic imports.\nif (!satisfies(process.version, NODE_VERSION_RANGE)) {\n  red(\n    `PostHog wizard requires Node.js ${NODE_VERSION_RANGE}. You are using Node.js ${process.version}. Please upgrade your Node.js version.`,\n  );\n  process.exit(1);\n}\n\nimport { runMCPInstall, runMCPRemove } from './src/mcp';\nimport type { CloudRegion, WizardOptions } from './src/utils/types';\nimport { runWizard } from './src/run';\nimport { runEventSetupWizard } from './src/nextjs/event-setup';\nimport {\n  readEnvironment,\n  isNonInteractiveEnvironment,\n} from './src/utils/environment';\nimport path from 'path';\nimport clack from './src/utils/clack';\n\nif (isNonInteractiveEnvironment()) {\n  clack.intro(chalk.inverse(`PostHog Wizard`));\n\n  clack.log.error(\n    'This installer requires an interactive terminal (TTY) to run.\\n' +\n      'It appears you are running in a non-interactive environment.\\n' +\n      'Please run the wizard in an interactive terminal.',\n  );\n  process.exit(1);\n}\n\nif (process.env.NODE_ENV === 'test') {\n  void (async () => {\n    try {\n      const { server } = await import('./e2e-tests/mocks/server.js');\n      server.listen({\n        onUnhandledRequest: 'bypass',\n      });\n    } catch (error) {\n      // Mock server import failed - this can happen during non-E2E tests\n    }\n  })();\n}\n\nyargs(hideBin(process.argv))\n  .env('POSTHOG_WIZARD')\n  // global options\n  .options({\n    debug: {\n      default: false,\n      describe: 'Enable verbose logging\\nenv: POSTHOG_WIZARD_DEBUG',\n      type: 'boolean',\n    },\n    region: {\n      describe: 'PostHog cloud region\\nenv: POSTHOG_WIZARD_REGION',\n      choices: ['us', 'eu'],\n      type: 'string',\n    },\n    default: {\n      default: true,\n      describe:\n        'Use default options for all prompts\\nenv: POSTHOG_WIZARD_DEFAULT',\n      type: 'boolean',\n    },\n    signup: {\n      default: false,\n      describe:\n        'Create a new PostHog account during setup\\nenv: POSTHOG_WIZARD_SIGNUP',\n      type: 'boolean',\n    },\n  })\n  .command(\n    ['$0'],\n    'Run the PostHog setup wizard',\n    (yargs) => {\n      return yargs.options({\n        'force-install': {\n          default: false,\n          describe:\n            'Force install packages even if peer dependency checks fail\\nenv: POSTHOG_WIZARD_FORCE_INSTALL',\n          type: 'boolean',\n        },\n        'install-dir': {\n          describe:\n            'Directory to install PostHog in\\nenv: POSTHOG_WIZARD_INSTALL_DIR',\n          type: 'string',\n        },\n        integration: {\n          describe: 'Integration to set up',\n          choices: ['nextjs', 'astro', 'react', 'svelte', 'react-native'],\n          type: 'string',\n        },\n      });\n    },\n    (argv) => {\n      const options = { ...argv };\n      void runWizard(options as unknown as WizardOptions);\n    },\n  )\n  .command(\n    'event-setup',\n    'Run the event setup wizard',\n    (yargs) => {\n      return yargs.options({\n        'install-dir': {\n          describe:\n            'Directory to run the wizard in\\nenv: POSTHOG_WIZARD_INSTALL_DIR',\n          type: 'string',\n        },\n      });\n    },\n    (argv) => {\n      const finalArgs = {\n        ...argv,\n        ...readEnvironment(),\n      } as any;\n\n      let resolvedInstallDir: string;\n      if (finalArgs.installDir) {\n        if (path.isAbsolute(finalArgs.installDir)) {\n          resolvedInstallDir = finalArgs.installDir;\n        } else {\n          resolvedInstallDir = path.join(process.cwd(), finalArgs.installDir);\n        }\n      } else {\n        resolvedInstallDir = process.cwd();\n      }\n\n      const wizardOptions: WizardOptions = {\n        debug: finalArgs.debug ?? false,\n        installDir: resolvedInstallDir,\n        cloudRegion: finalArgs.region as CloudRegion | undefined,\n        default: finalArgs.default ?? false,\n        signup: finalArgs.signup ?? false,\n        forceInstall: false,\n      };\n\n      void runEventSetupWizard(wizardOptions);\n    },\n  )\n  .command('mcp <command>', 'MCP server management commands', (yargs) => {\n    return yargs\n      .command(\n        'add',\n        'Install PostHog MCP server to supported clients',\n        (yargs) => {\n          return yargs.options({\n            local: {\n              default: false,\n              describe:\n                'Add local development MCP server (http://localhost:8787)',\n              type: 'boolean',\n            },\n          });\n        },\n        (argv) => {\n          const options = { ...argv };\n          void runMCPInstall(\n            options as unknown as {\n              signup: boolean;\n              region?: CloudRegion;\n              local?: boolean;\n              debug?: boolean;\n            },\n          );\n        },\n      )\n      .command(\n        'remove',\n        'Remove PostHog MCP server from supported clients',\n        (yargs) => {\n          return yargs.options({\n            local: {\n              default: false,\n              describe:\n                'Remove local development MCP server (http://localhost:8787)',\n              type: 'boolean',\n            },\n          });\n        },\n        (argv) => {\n          const options = { ...argv };\n          void runMCPRemove(options as { local?: boolean });\n        },\n      )\n      .demandCommand(1, 'You must specify a subcommand (add or remove)')\n      .help();\n  })\n  .help()\n  .alias('help', 'h')\n  .version()\n  .alias('version', 'v')\n  .wrap(process.stdout.isTTY ? yargs.terminalWidth() : 80).argv;\n"]}
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../bin.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\nimport { satisfies } from 'semver';\nimport { red } from './src/utils/logging';\n\nimport yargs from 'yargs';\nimport { hideBin } from 'yargs/helpers';\nimport chalk from 'chalk';\n\nconst NODE_VERSION_RANGE = '>=18.17.0';\n\n// Have to run this above the other imports because they are importing clack that\n// has the problematic imports.\nif (!satisfies(process.version, NODE_VERSION_RANGE)) {\n  red(\n    `PostHog wizard requires Node.js ${NODE_VERSION_RANGE}. You are using Node.js ${process.version}. Please upgrade your Node.js version.`,\n  );\n  process.exit(1);\n}\n\nimport { runMCPInstall, runMCPRemove } from './src/mcp';\nimport type { CloudRegion, WizardOptions } from './src/utils/types';\nimport { runWizard } from './src/run';\nimport { runEventSetupWizard } from './src/nextjs/event-setup';\nimport {\n  readEnvironment,\n  isNonInteractiveEnvironment,\n} from './src/utils/environment';\nimport path from 'path';\nimport clack from './src/utils/clack';\n\nif (isNonInteractiveEnvironment()) {\n  clack.intro(chalk.inverse(`PostHog Wizard`));\n\n  clack.log.error(\n    'This installer requires an interactive terminal (TTY) to run.\\n' +\n      'It appears you are running in a non-interactive environment.\\n' +\n      'Please run the wizard in an interactive terminal.',\n  );\n  process.exit(1);\n}\n\nif (process.env.NODE_ENV === 'test') {\n  void (async () => {\n    try {\n      const { server } = await import('./e2e-tests/mocks/server.js');\n      server.listen({\n        onUnhandledRequest: 'bypass',\n      });\n    } catch (error) {\n      // Mock server import failed - this can happen during non-E2E tests\n    }\n  })();\n}\n\nyargs(hideBin(process.argv))\n  .env('POSTHOG_WIZARD')\n  // global options\n  .options({\n    debug: {\n      default: false,\n      describe: 'Enable verbose logging\\nenv: POSTHOG_WIZARD_DEBUG',\n      type: 'boolean',\n    },\n    region: {\n      describe: 'PostHog cloud region\\nenv: POSTHOG_WIZARD_REGION',\n      choices: ['us', 'eu'],\n      type: 'string',\n    },\n    default: {\n      default: true,\n      describe:\n        'Use default options for all prompts\\nenv: POSTHOG_WIZARD_DEFAULT',\n      type: 'boolean',\n    },\n    signup: {\n      default: false,\n      describe:\n        'Create a new PostHog account during setup\\nenv: POSTHOG_WIZARD_SIGNUP',\n      type: 'boolean',\n    },\n    'local-mcp': {\n      default: false,\n      describe:\n        'Use local MCP server at http://localhost:8787/mcp\\nenv: POSTHOG_WIZARD_LOCAL_MCP',\n      type: 'boolean',\n    },\n  })\n  .command(\n    ['$0'],\n    'Run the PostHog setup wizard',\n    (yargs) => {\n      return yargs.options({\n        'force-install': {\n          default: false,\n          describe:\n            'Force install packages even if peer dependency checks fail\\nenv: POSTHOG_WIZARD_FORCE_INSTALL',\n          type: 'boolean',\n        },\n        'install-dir': {\n          describe:\n            'Directory to install PostHog in\\nenv: POSTHOG_WIZARD_INSTALL_DIR',\n          type: 'string',\n        },\n        integration: {\n          describe: 'Integration to set up',\n          choices: ['nextjs', 'astro', 'react', 'svelte', 'react-native'],\n          type: 'string',\n        },\n      });\n    },\n    (argv) => {\n      const options = { ...argv };\n      void runWizard(options as unknown as WizardOptions);\n    },\n  )\n  .command(\n    'event-setup',\n    'Run the event setup wizard',\n    (yargs) => {\n      return yargs.options({\n        'install-dir': {\n          describe:\n            'Directory to run the wizard in\\nenv: POSTHOG_WIZARD_INSTALL_DIR',\n          type: 'string',\n        },\n      });\n    },\n    (argv) => {\n      const finalArgs = {\n        ...argv,\n        ...readEnvironment(),\n      } as any;\n\n      let resolvedInstallDir: string;\n      if (finalArgs.installDir) {\n        if (path.isAbsolute(finalArgs.installDir)) {\n          resolvedInstallDir = finalArgs.installDir;\n        } else {\n          resolvedInstallDir = path.join(process.cwd(), finalArgs.installDir);\n        }\n      } else {\n        resolvedInstallDir = process.cwd();\n      }\n\n      const wizardOptions: WizardOptions = {\n        debug: finalArgs.debug ?? false,\n        installDir: resolvedInstallDir,\n        cloudRegion: finalArgs.region as CloudRegion | undefined,\n        default: finalArgs.default ?? false,\n        signup: finalArgs.signup ?? false,\n        forceInstall: false,\n        localMcp: finalArgs.localMcp ?? false,\n      };\n\n      void runEventSetupWizard(wizardOptions);\n    },\n  )\n  .command('mcp <command>', 'MCP server management commands', (yargs) => {\n    return yargs\n      .command(\n        'add',\n        'Install PostHog MCP server to supported clients',\n        (yargs) => {\n          return yargs.options({\n            local: {\n              default: false,\n              describe:\n                'Add local development MCP server (http://localhost:8787)',\n              type: 'boolean',\n            },\n          });\n        },\n        (argv) => {\n          const options = { ...argv };\n          void runMCPInstall(\n            options as unknown as {\n              signup: boolean;\n              region?: CloudRegion;\n              local?: boolean;\n              debug?: boolean;\n            },\n          );\n        },\n      )\n      .command(\n        'remove',\n        'Remove PostHog MCP server from supported clients',\n        (yargs) => {\n          return yargs.options({\n            local: {\n              default: false,\n              describe:\n                'Remove local development MCP server (http://localhost:8787)',\n              type: 'boolean',\n            },\n          });\n        },\n        (argv) => {\n          const options = { ...argv };\n          void runMCPRemove(options as { local?: boolean });\n        },\n      )\n      .demandCommand(1, 'You must specify a subcommand (add or remove)')\n      .help();\n  })\n  .help()\n  .alias('help', 'h')\n  .version()\n  .alias('version', 'v')\n  .wrap(process.stdout.isTTY ? yargs.terminalWidth() : 80).argv;\n"]}

package/dist/src/lib/agent-interface.d.ts

@@ -1,10 +1,10 @@
 /**
  * Shared agent interface for PostHog wizards
- * Provides common agent initialization and event handling
+ * Uses Claude Agent SDK directly with PostHog LLM gateway
  */
 import clack from '../utils/clack';
 import type { WizardOptions } from '../utils/types';
-type Agent = any;
+type McpServersConfig = any;
 export declare const AgentSignals: {
     /** Signal emitted when the agent reports progress to the user */
     readonly STATUS: "[STATUS]";
@@ -28,31 +28,42 @@ export type AgentConfig = {
     workingDirectory: string;
     posthogMcpUrl: string;
     posthogApiKey: string;
-    debug?: boolean;
+    posthogApiHost: string;
+    posthogProjectId: number;
 };
 /**
- * Permission hook that allows only safe package manager commands.
- * This prevents the agent from running arbitrary shell commands.
+ * Internal configuration object returned by initializeAgent
  */
-export declare function wizardCanUseTool(toolName: string, input: {
-    command?: string;
-}): {
+type AgentRunConfig = {
+    workingDirectory: string;
+    mcpServers: McpServersConfig;
+    model: string;
+};
+/**
+ * Permission hook that allows only safe commands.
+ * - Package manager install commands
+ * - Build/typecheck/lint commands for verification
+ * - Piping to tail/head for output limiting is allowed
+ * - Stderr redirection (2>&1) is allowed
+ */
+export declare function wizardCanUseTool(toolName: string, input: Record<string, unknown>): {
     behavior: 'allow';
+    updatedInput: Record<string, unknown>;
 } | {
     behavior: 'deny';
     message: string;
 };
 /**
- * Initialize a PostHog Agent instance with the provided configuration
+ * Initialize agent configuration for the LLM gateway
  */
-export declare function initializeAgent(config: AgentConfig, options: WizardOptions, spinner: ReturnType<typeof clack.spinner>): Promise<Agent>;
+export declare function initializeAgent(config: AgentConfig, options: WizardOptions): AgentRunConfig;
 /**
  * Execute an agent with the provided prompt and options
  * Handles the full lifecycle: spinner, execution, error handling
  *
  * @returns An object containing any error detected in the agent's output
  */
-export declare function runAgent(agent: Agent, prompt: string, options: WizardOptions, spinner: ReturnType<typeof clack.spinner>, config?: {
+export declare function runAgent(agentConfig: AgentRunConfig, prompt: string, options: WizardOptions, spinner: ReturnType<typeof clack.spinner>, config?: {
     estimatedDurationMinutes?: number;
     spinnerMessage?: string;
     successMessage?: string;