Auto-build wizard so local wizard command always has the freshest code

Author: daniloc

README.md

@@ -116,36 +116,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:

bin.ts

@@ -78,6 +78,12 @@ yargs(hideBin(process.argv))
         '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'],
@@ -143,6 +149,7 @@ yargs(hideBin(process.argv))
         default: finalArgs.default ?? false,
         signup: finalArgs.signup ?? false,
         forceInstall: false,
+        localMcp: finalArgs.localMcp ?? false,
       };
 
       void runEventSetupWizard(wizardOptions);

package.json

@@ -107,6 +107,7 @@
     "test:e2e": "pnpm build && ./e2e-tests/run.sh",
     "test:e2e-record": "export RECORD_FIXTURES=true && pnpm build && ./e2e-tests/run.sh",
     "try": "tsx bin.ts",
+    "dev": "pnpm build && pnpm link --global && pnpm build:watch",
     "test:watch": "jest --watch",
     "prepare": "husky"
   },

src/lib/agent-runner.ts

@@ -104,10 +104,16 @@ export async function runAgentWizard(
 
   // Initialize and run agent
   const spinner = clack.spinner();
+
+  // Determine MCP URL: CLI flag > env var > production default
+  const mcpUrl = options.localMcp
+    ? 'http://localhost:8787/mcp'
+    : process.env.MCP_URL || 'https://mcp.posthog.com/mcp';
+
   const agent = await initializeAgent(
     {
       workingDirectory: options.installDir,
-      posthogMcpUrl: 'https://mcp.posthog.com/mcp',
+      posthogMcpUrl: mcpUrl,
       posthogApiKey: accessToken,
       debug: false,
     },

src/run.ts

@@ -35,6 +35,7 @@ type Args = {
   region?: CloudRegion;
   default?: boolean;
   signup?: boolean;
+  localMcp?: boolean;
 };
 
 export async function runWizard(argv: Args) {
@@ -61,6 +62,7 @@ export async function runWizard(argv: Args) {
     cloudRegion: finalArgs.region ?? undefined,
     default: finalArgs.default ?? false,
     signup: finalArgs.signup ?? false,
+    localMcp: finalArgs.localMcp ?? false,
   };
 
   clack.intro(`Welcome to the PostHog setup wizard ✨`);

src/utils/types.ts

@@ -40,6 +40,11 @@ export type WizardOptions = {
    * Whether to create a new PostHog account during setup.
    */
   signup: boolean;
+
+  /**
+   * Whether to use the local MCP server at http://localhost:8787/mcp
+   */
+  localMcp: boolean;
 };
 
 export interface Feature {