@posthog/wizard 2.24.1 → 2.26.0

package/dist/bin.js

@@ -1,16 +1,16 @@
 #!/usr/bin/env node
-import { $ as VERSION, P as POSTHOG_DOCS_URL, Q as getSkillsBaseUrl, Y as WIZARD_USER_AGENT, _ as SIGNUP_WIZARD_READINESS_CONFIG, a as getLogFilePath, h as LoggingUI, m as setUI, p as getUI, s as logToFile, v as evaluateWizardReadiness, y as getBlockingServiceKeys } from "./debug-DxA_f5QT.js";
-import { t as analytics } from "./analytics-CUr82BDl.js";
-import { r as setEntryCommand } from "./telemetry-ycqCpNPr.js";
-import { n as isUsingTypeScript } from "./setup-utils-0U-_Md2G.js";
-import { a as getUiHostFromHost, n as getCloudUrlFromRegion } from "./urls-C8aJWvgh.js";
-import { o as handleApiError } from "./api-CI3Z74NG.js";
+import { $ as getSkillsBaseUrl, P as POSTHOG_DOCS_URL, X as WIZARD_USER_AGENT, _ as SIGNUP_WIZARD_READINESS_CONFIG, a as getLogFilePath, et as VERSION, h as LoggingUI, m as setUI, p as getUI, r as debug, s as logToFile, v as evaluateWizardReadiness, y as getBlockingServiceKeys } from "./debug-BizeRFR0.js";
+import { t as analytics } from "./analytics-BX3LKPch.js";
+import { r as setEntryCommand } from "./telemetry-BH-MgWPT.js";
+import { n as isUsingTypeScript } from "./setup-utils-CNWIMZ-d.js";
+import { a as getUiHostFromHost, n as getCloudUrlFromRegion } from "./urls-BuEABcmF.js";
+import { o as handleApiError } from "./api-DCHci5SD.js";
 import "./wizard-session-G3VWD6hv.js";
-import { r as runCleanups } from "./wizard-abort-C6gRLxUE.js";
-import { n as isNonInteractiveEnvironment } from "./environment-CyS37cmM.js";
-import { _ as AUDIT_CHECKS_KEY, f as WIZARD_TOOL_NAMES, g as AUDIT_CHECKS_FILE, l as AgentSignals, m as fetchSkillMenu, s as recoverOrphanedSettingsBackups, v as AUDIT_REPORT_FILE } from "./agent-interface-D1vtN6Wn.js";
-import { i as SPINNER_MESSAGE } from "./registry-CO7JVZyE.js";
-import { a as PRODUCT_SUITE_BLOCK, f as Colors, i as LINE_CHART_BLOCK, l as isClearBlock, m as HEALTH_CHECK_STEP, n as posthogIntegrationConfig, o as StatusPeekTrigger, p as Icons, r as FUNNEL_BLOCK } from "./posthog-integration-DexZ2uHU.js";
+import { r as runCleanups } from "./wizard-abort-Dl2MJOP9.js";
+import { n as isNonInteractiveEnvironment } from "./environment-DS5Pq9Wm.js";
+import { S as AUDIT_REPORT_FILE, b as AUDIT_CHECKS_FILE, c as recoverOrphanedSettingsBackups, h as fetchSkillMenu, p as WIZARD_TOOL_NAMES, u as AgentSignals, x as AUDIT_CHECKS_KEY } from "./agent-interface-Dq_4h2eN.js";
+import { i as SPINNER_MESSAGE } from "./registry-C3wcDM3X.js";
+import { a as PRODUCT_SUITE_BLOCK, f as Colors, i as LINE_CHART_BLOCK, l as isClearBlock, m as HEALTH_CHECK_STEP, n as posthogIntegrationConfig, o as StatusPeekTrigger, p as Icons, r as FUNNEL_BLOCK } from "./posthog-integration-CAYZdk0r.js";
 import { t as IGNORED_DIRS } from "./file-utils-VAXoyXVA.js";
 import { n as readApiKeyFromEnv } from "./env-api-key-MlzJYAvt.js";
 import { satisfies } from "semver";
@@ -18,11 +18,17 @@ import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
 import fs, { existsSync, readFileSync, readdirSync, statSync } from "fs";
 import path, { join, relative } from "path";
+import * as os from "node:os";
+import * as path$1 from "node:path";
+import { spawnSync } from "node:child_process";
+import * as fs$1 from "node:fs";
 import axios from "axios";
 import { z } from "zod";
 import { Box, Text, render, useInput } from "ink";
 import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { access, rm } from "node:fs/promises";
+import * as readline from "node:readline/promises";
 //#region src/commands/command.ts
 /** Extract the bare command word(s) from a yargs name spec, dropping positionals and aliases' arg syntax. */
 function commandKeys(name) {
@@ -184,7 +190,7 @@ function runProvision(argv) {
 }
 async function provision({ email, region, name, jsonMode }) {
 	try {
-		const { provisionNewAccount } = await import("./provisioning-9c-AQbsa.js").then((n) => n.n);
+		const { provisionNewAccount } = await import("./provisioning-BmL4ro-o.js").then((n) => n.n);
 		if (!jsonMode) getUI().log.info(`Provisioning account for ${email} in ${region}...`);
 		emitResult(await provisionNewAccount(email, name, region), jsonMode);
 		process.exit(0);
@@ -249,18 +255,18 @@ const basicIntegrationCommand = {
 		setEntryCommand("integrate");
 		(async () => {
 			if (argv.ci) {
-				const { runCIInstall } = await import("./ci-install-D_kxNmbJ.js");
+				const { runCIInstall } = await import("./ci-install-CHIbwXio.js");
 				return runCIInstall(argv);
 			}
 			if (isNonInteractiveEnvironment()) {
-				const { failNonInteractive } = await import("./non-interactive-DWtHX3ZR.js");
+				const { failNonInteractive } = await import("./non-interactive-DNah9u3t.js");
 				return failNonInteractive();
 			}
 			if (argv.playground) {
-				const { runPlayground } = await import("./playground-D7AhMMF5.js");
+				const { runPlayground } = await import("./playground-Cwe0Q9HW.js");
 				return runPlayground();
 			}
-			const { runInteractive } = await import("./interactive-CG6FFqSw.js");
+			const { runInteractive } = await import("./interactive-DE3WDjk7.js");
 			runInteractive(argv);
 		})();
 	}
@@ -841,7 +847,7 @@ const EVENTS_AUDIT_SEED_CHECKS = [
 //#endregion
 //#region src/lib/programs/events-audit/index.ts
 const SETUP_REPORT_FILE = "posthog-events-audit-report.md";
-const DOCS_URL$2 = "https://posthog.com/docs/product-analytics/best-practices";
+const DOCS_URL$3 = "https://posthog.com/docs/product-analytics/best-practices";
 const eventsAuditConfig = {
 	command: "events-audit",
 	description: "Audit PostHog event tracking in this project",
@@ -863,7 +869,7 @@ const eventsAuditConfig = {
 			successMessage: "Events audit complete! You can view the report at ./posthog-events-audit-report.md",
 			estimatedDurationMinutes: 5,
 			reportFile: SETUP_REPORT_FILE,
-			docsUrl: DOCS_URL$2,
+			docsUrl: DOCS_URL$3,
 			errorMessage: "Events audit failed",
 			additionalFeatureQueue: session.additionalFeatureQueue,
 			customPrompt: (ctx) => `Audit PostHog event capture in this project. Do not modify any project files — produce a read-only report only.
@@ -881,7 +887,7 @@ Project context:
 					message: "Your events audit was successful",
 					reportFile: SETUP_REPORT_FILE,
 					changes: [],
-					docsUrl: DOCS_URL$2,
+					docsUrl: DOCS_URL$3,
 					continueUrl: sess.signup && cloudUrl ? `${cloudUrl}/products?source=wizard` : void 0,
 					dashboardUrl: sess.dashboardUrl ?? (cloudUrl ? `${cloudUrl}/dashboard` : void 0),
 					notebookUrl: sess.notebookUrl ?? void 0
@@ -2410,15 +2416,15 @@ const getContentBlocks = (store) => pace([
 ]);
 //#endregion
 //#region src/lib/programs/error-tracking-upload-source-maps/index.ts
-const REPORT_FILE = "posthog-source-maps-report.md";
-const DOCS_URL = "https://posthog.com/docs/error-tracking/upload-source-maps";
+const REPORT_FILE$1 = "posthog-source-maps-report.md";
+const DOCS_URL$1 = "https://posthog.com/docs/error-tracking/upload-source-maps";
 const errorTrackingUploadSourceMapsConfig = {
 	command: "upload-source-maps",
 	description: "Upload source maps to PostHog Error Tracking",
 	id: "error-tracking-upload-source-maps",
 	requiresAi: true,
 	steps: ERROR_TRACKING_UPLOAD_SOURCE_MAPS_PROGRAM,
-	reportFile: REPORT_FILE,
+	reportFile: REPORT_FILE$1,
 	getContentBlocks,
 	requires: ["posthog-integration"],
 	run: (session) => {
@@ -2428,8 +2434,8 @@ const errorTrackingUploadSourceMapsConfig = {
 		return Promise.resolve({
 			integrationLabel: "error-tracking-upload-source-maps",
 			successMessage: "Source maps wired up!",
-			reportFile: REPORT_FILE,
-			docsUrl: DOCS_URL,
+			reportFile: REPORT_FILE$1,
+			docsUrl: DOCS_URL$1,
 			spinnerMessage: "Wiring up source maps...",
 			estimatedDurationMinutes: 3,
 			abortCases: SOURCE_MAPS_ABORT_CASES,
@@ -2455,14 +2461,363 @@ const errorTrackingUploadSourceMapsConfig = {
 				return {
 					kind: "success",
 					message: "Source maps wired up!",
-					reportFile: REPORT_FILE,
-					docsUrl: DOCS_URL
+					reportFile: REPORT_FILE$1,
+					docsUrl: DOCS_URL$1
 				};
 			}
 		});
 	}
 };
 //#endregion
+//#region src/lib/programs/self-driving/detect.ts
+/**
+* Self-driving prerequisite detection + abort vocabulary.
+*
+* The only thing worth verifying before auth is local and cheap: that
+* `session.installDir` is a real, readable directory. We deliberately do
+* NOT require the base posthog-integration report to be present — it is a
+* report many users never commit, and `requires: ['posthog-integration']`
+* is metadata, not a hard runtime gate. Real readiness (integration state
+* + beta access) is established by the agent's STEP 1 Signals API probe at
+* the start of the run. The beta gates (the `product-autonomy` access flag
+* and `signals-scout` enrollment — PostHog-side flag names, unchanged by
+* the wizard-side "self-driving" rename) are PostHog-internal flags with no
+* customer-facing read API, which is why that probe lives in the run and
+* emits a structured `[ABORT]` when the product is not available.
+*/
+/**
+* `[ABORT] <reason>` cases the self-driving skill can emit. The
+* reason strings are part of the skill contract — the context-mill
+* `self-driving-setup` skill emits these exact strings.
+*/
+const SELF_DRIVING_ABORT_CASES = [
+	{
+		match: /^self-driving is not available for this project$/i,
+		message: "PostHog Self-driving is not available for this project",
+		body: "Self-driving is in beta and is enabled per team by PostHog. This project does not appear to have access yet. Reach out to your PostHog contact (or wizard@posthog.com) to join the beta, then run the wizard again."
+	},
+	{
+		match: /^github connection declined$/i,
+		message: "GitHub connection required",
+		body: "Self-driving needs GitHub access to research issues in your code and open fixes, so setup cannot finish without it. Nothing was left half-configured. When you are ready to install the PostHog GitHub App, run the wizard again."
+	},
+	{
+		match: /^requires-interactive-mode$/i,
+		message: "Interactive terminal required",
+		body: "Self-driving setup asks questions along the way (GitHub and issue trackers), so it needs an interactive terminal. Run the wizard outside CI / non-interactive mode."
+	},
+	{
+		match: /^requirements-incomplete$/i,
+		message: "Setup needs your input",
+		body: "The wizard could not collect the answers this setup needs (the environment was non-interactive, or the question budget ran out). Nothing was left half-configured. Run the wizard again in an interactive terminal."
+	}
+];
+/**
+* Verify `session.installDir` is a readable directory. Writes a
+* `SelfDrivingDetectError` to frameworkContext on failure — the intro
+* screen renders it and blocks.
+*/
+function detectSelfDrivingPrerequisites(session, setFrameworkContext) {
+	const fail = (error) => setFrameworkContext("detectError", error);
+	const installDir = session.installDir;
+	if (!existsSync(installDir)) {
+		fail({
+			kind: "bad-directory",
+			path: installDir,
+			reason: "missing"
+		});
+		return;
+	}
+	try {
+		if (!statSync(installDir).isDirectory()) {
+			fail({
+				kind: "bad-directory",
+				path: installDir,
+				reason: "not-dir"
+			});
+			return;
+		}
+	} catch {
+		fail({
+			kind: "bad-directory",
+			path: installDir,
+			reason: "unreadable"
+		});
+		return;
+	}
+}
+//#endregion
+//#region src/lib/programs/self-driving/steps.ts
+const SELF_DRIVING_PROGRAM = [
+	{
+		id: "detect",
+		label: "Detecting prerequisites",
+		onReady: (ctx) => detectSelfDrivingPrerequisites(ctx.session, ctx.setFrameworkContext)
+	},
+	{
+		id: "intro",
+		label: "Welcome",
+		screenId: "self-driving-intro",
+		gate: (session) => session.setupConfirmed
+	},
+	HEALTH_CHECK_STEP,
+	{
+		id: "auth",
+		label: "Authentication",
+		screenId: "auth",
+		isComplete: (session) => session.credentials !== null
+	},
+	{
+		id: "run",
+		label: "Self-driving",
+		screenId: "run",
+		isComplete: (session) => session.runPhase === "completed" || session.runPhase === "error"
+	},
+	{
+		id: "outro",
+		label: "Done",
+		screenId: "outro",
+		isComplete: (session) => session.outroDismissed
+	}
+];
+//#endregion
+//#region src/lib/programs/self-driving/prompt.ts
+/**
+* Build the self-driving run prompt. The installed
+* `self-driving-setup` skill is the source of truth for the HOW of
+* every step (which MCP tools to call, which sources/scouts apply, how
+* to verify); this prompt carries the order, the wizard-specific
+* mechanics (wizard_ask, abort signals), and the project URLs.
+*/
+function buildSelfDrivingPrompt(ctx) {
+	const uiHost = getUiHostFromHost(ctx.host).replace(/\/$/, "");
+	const projectBase = `${uiHost}/project/${ctx.projectId}`;
+	const integrationsSettingsUrl = `${projectBase}/settings/environment-integrations`;
+	const orgAiSettingsUrl = `${uiHost}/settings/organization#organization-ai-consent`;
+	const newWarehouseSourceUrl = `${projectBase}/pipeline/new/source`;
+	const inboxUrl = `${projectBase}/inbox`;
+	const optIn = (value) => value === true ? "ON" : value === false ? "OFF" : "unknown";
+	const optIns = ctx.teamProductOptIns;
+	return `You are setting up PostHog Self-driving for this project: you will enable the right signal sources, make sure GitHub is connected, tune the scout fleet, design custom scouts for what this product uniquely needs, and hand the user a configured inbox.
+
+Project URLs:
+- Integrations settings (GitHub App install): ${integrationsSettingsUrl}
+- Organization AI settings: ${orgAiSettingsUrl}
+- New data warehouse source (Linear / Zendesk / GitHub issues / pganalyze): ${newWarehouseSourceUrl}
+- Self-driving inbox: ${inboxUrl}
+
+Project state read at auth time (PostHog project settings — authoritative
+for whether a product is enabled, regardless of what this repo
+instruments; products are often instrumented from other repos or the
+snippet, so repo evidence may rule a product IN but never OUT):
+- Session replay recording: ${optIn(optIns?.sessionReplay)}
+- Exception autocapture (error tracking): ${optIn(optIns?.exceptionAutocapture)}
+- Surveys: ${optIn(optIns?.surveys)}
+
+The installed skill is the source of truth for the HOW of every step:
+which MCP tools to call, which sources and scouts apply to this product,
+and how to verify each change. The STEPS below give the order and the
+wizard-specific mechanics — read the matching skill reference before
+doing the work, and do not invent steps the skill doesn't describe.
+
+Before doing any work, create your FULL task list in a single TaskCreate
+call so the user can follow your progress in the TUI. Use exactly these
+tasks, in this order:
+  1. Check Self-driving access
+  2. Read project and current Self-driving state
+  3. Connect GitHub (required)
+  4. Enable signal sources
+  5. Offer issue-tracker integrations
+  6. Configure the scout fleet
+  7. Design custom scouts
+  8. Write report and hand off
+Drive the list with TaskUpdate — mark a task in_progress when you start
+it and completed when done. If a step turns out to be a no-op (e.g.
+GitHub is already connected), still mark its task completed.
+
+Wizard mechanics:
+- Ask the user things ONLY with the wizard_ask MCP tool, and batch
+  related questions (e.g. one multi-select for all issue trackers, not
+  one ask per tool). The per-run ask budget is limited.
+- If wizard_ask is unavailable (CI / non-interactive), emit
+  ${AgentSignals.ABORT} requires-interactive-mode and halt.
+- When a step requires the user to do something in the browser, give
+  them the exact URL inside the wizard_ask prompt text — do not try to
+  open a browser yourself.
+- Emit ${AgentSignals.STATUS} lines as you complete each step so the
+  user sees progress.
+
+Follow these steps IN ORDER. Do not skip or reorder.
+
+STEP 1 — Check Self-driving access. (skill: "Check access")
+   Probe the Signals API as the skill describes. If the API is not
+   available for this project (permission or not-found errors), emit
+   ${AgentSignals.ABORT} self-driving is not available for this project
+   and halt.
+
+STEP 2 — Read project and current Signals state. (skill: "Read context")
+   If ./posthog-setup-report.md exists, read it as a strong hint for what
+   THIS repo instruments — but it is often absent (users frequently don't
+   commit it), so do NOT depend on it. Combine whatever you find with the
+   project-state block above and the skill's server-side usage probes —
+   repo evidence rules products in, never out. Do a light scan ONLY for
+   what neither covers. List the currently enabled signal sources so every
+   later write is idempotent.
+
+STEP 3 — Connect GitHub. REQUIRED. (skill: "Connect GitHub")
+   Signals cannot research or fix issues without code access. Check for
+   an existing GitHub integration first; if absent, send the user to
+   ${integrationsSettingsUrl} via wizard_ask and verify the connection
+   after they confirm. If the user cannot connect now, emit
+   ${AgentSignals.ABORT} github connection declined
+   and halt — never finish setup without GitHub.
+
+STEP 4 — Enable signal sources. (skill: "Enable sources")
+   Enable the sources that match what this product actually uses, per
+   the skill. Never enable a source for a tool the user hasn't
+   confirmed they use.
+
+STEP 5 — Offer issue-tracker integrations. (skill: "Connected tools")
+   One batched multi-select wizard_ask for the external tools the skill
+   lists. The run auto-connects the ones it can (GitHub Issues, and
+   Linear via a one-click OAuth link), verifying each with a single
+   silent check — never nudge. It arms the rest as dormant responders to
+   finish later: for tools it can't auto-connect (Zendesk, pganalyze) it
+   never sends the user to paste credentials and never re-prompts. Enable
+   a source only for a tool the user picked.
+
+STEP 6 — Configure the scout fleet. (skill: "Scouts")
+   Materialize the fleet and disable the scouts whose product surface
+   this project lacks, per the skill.
+
+STEP 7 — Design custom scouts for this product. (skill: "Custom scouts")
+   You are the only actor that has read this repo — turn that into
+   coverage per the skill: a real gap analysis of the project's
+   watchable surfaces against what the canonical fleet already covers,
+   then custom scouts for the uncovered ones. Keep scout bodies
+   high-level: describe the behavior and signal conditions to watch,
+   referencing repo evidence by file/function name — never paste raw
+   source, secrets, env values, or customer data into a scout body.
+   Never edit canonical scout bodies. Propose all candidates in ONE
+   batched wizard_ask
+   before creating anything; the user declining everything (or finding
+   no gap at all) is a valid outcome, not an abort. Mark the task
+   completed either way.
+
+STEP 8 — Write the report and hand off. (skill: "Report")
+   Write the report per the skill, including follow-ups for anything
+   deferred. Tell the user findings will start appearing in their inbox
+   at ${inboxUrl} within about 30 minutes.`;
+}
+//#endregion
+//#region src/lib/programs/self-driving/content/tips.ts
+const SELF_DRIVING_TIPS = [
+	{
+		id: "what-is-a-signal-source",
+		title: "What's a signal source?",
+		description: "A signal source is a PostHog product or connected tool — errors, session replays, support, GitHub or Linear issues — that feeds findings into your Self-driving inbox."
+	},
+	{
+		id: "what-is-a-scout",
+		title: "What's a scout?",
+		description: "Scouts are scheduled checks that scan your data and flag issues — a spike in errors, a dropping funnel — straight to your inbox."
+	},
+	{
+		id: "findings-in-inbox",
+		title: "Findings land in your inbox",
+		description: "Once setup finishes, PostHog starts scanning within ~30 minutes and surfaces what it finds in your Self-driving inbox — grouped, researched, and ready to act on."
+	}
+];
+const getTips = () => SELF_DRIVING_TIPS;
+//#endregion
+//#region src/lib/programs/self-driving/index.ts
+const SELF_DRIVING_SKILL_ID = "self-driving-setup";
+const REPORT_FILE = "posthog-self-driving-report.md";
+const DOCS_URL = "https://posthog.com/docs";
+const SUCCESS_MESSAGE = "Self-driving is on! PostHog will start scanning within ~30 minutes and surface findings in your inbox.";
+const WIZARD_MARKER = ".posthog-wizard";
+/**
+* Remove the installed setup skill. It is transient orchestration
+* knowledge (unlike integration skills such as the Next.js one, which
+* are worth keeping for the user's coding agents), so the program
+* cleans it up instead of showing the keep-skills prompt. Marker-
+* guarded: only directories the wizard installed are touched.
+*/
+async function removeInstalledSkill(installDir) {
+	const skillDir = join(installDir, ".claude", "skills", SELF_DRIVING_SKILL_ID);
+	try {
+		await access(join(skillDir, WIZARD_MARKER));
+	} catch {
+		return;
+	}
+	await rm(skillDir, {
+		recursive: true,
+		force: true
+	}).catch(() => void 0);
+}
+const run = {
+	skillId: SELF_DRIVING_SKILL_ID,
+	integrationLabel: SELF_DRIVING_SKILL_ID,
+	customPrompt: buildSelfDrivingPrompt,
+	successMessage: SUCCESS_MESSAGE,
+	reportFile: REPORT_FILE,
+	docsUrl: DOCS_URL,
+	spinnerMessage: "Setting up PostHog Self-driving...",
+	estimatedDurationMinutes: 10,
+	abortCases: SELF_DRIVING_ABORT_CASES,
+	maxQuestions: 13,
+	richLinks: true,
+	askTimeoutMs: 1800 * 1e3,
+	postRun: async (session) => {
+		await removeInstalledSkill(session.installDir);
+	},
+	buildOutroData: (_session, credentials) => {
+		return {
+			kind: "success",
+			message: "Self-driving is on. PostHog is scanning your project — first findings hit your inbox within ~30 minutes.",
+			primaryLink: {
+				label: "Your Self-driving inbox",
+				url: `${getUiHostFromHost(credentials.host).replace(/\/$/, "")}/project/${credentials.projectId}/inbox`
+			},
+			nextSteps: {
+				heading: "In your inbox you can:",
+				items: [
+					"Review the findings PostHog surfaces",
+					"Triage what matters and dismiss the noise",
+					"Kick off fixes and open issues"
+				]
+			},
+			reportFile: REPORT_FILE
+		};
+	}
+};
+const selfDrivingConfig = {
+	...createSkillProgram({
+		skillId: SELF_DRIVING_SKILL_ID,
+		command: "self-driving",
+		id: "self-driving",
+		description: "Set up PostHog Self-driving for this project",
+		integrationLabel: SELF_DRIVING_SKILL_ID,
+		successMessage: SUCCESS_MESSAGE,
+		reportFile: REPORT_FILE,
+		docsUrl: DOCS_URL,
+		spinnerMessage: "Setting up PostHog Self-driving...",
+		estimatedDurationMinutes: 10,
+		requires: ["posthog-integration"],
+		abortCases: SELF_DRIVING_ABORT_CASES
+	}),
+	steps: SELF_DRIVING_PROGRAM,
+	run,
+	getTips,
+	getContentBlocks: (store) => {
+		const blocks = getContentBlocks$2(store);
+		return blocks.map((b, i) => i === blocks.length - 1 && typeof b === "object" ? {
+			...b,
+			pause: 5e3
+		} : b);
+	}
+};
+//#endregion
 //#region src/lib/programs/mcp/index.ts
 const mcpAddConfig = {
 	id: "mcp-add",
@@ -2584,6 +2939,7 @@ const PROGRAM_REGISTRY = [
 	posthogDoctorConfig,
 	webAnalyticsDoctorConfig,
 	migrationConfig,
+	selfDrivingConfig,
 	agentSkillConfig,
 	mcpAddConfig,
 	mcpRemoveConfig,
@@ -2604,6 +2960,7 @@ const Program = {
 	EventsAudit: eventsAuditConfig.id,
 	PosthogDoctor: posthogDoctorConfig.id,
 	WebAnalyticsDoctor: webAnalyticsDoctorConfig.id,
+	SelfDriving: selfDrivingConfig.id,
 	AgentSkill: agentSkillConfig.id,
 	McpAdd: mcpAddConfig.id,
 	McpRemove: mcpRemoveConfig.id,
@@ -2648,7 +3005,7 @@ function runMcpAdd(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-WNb3ET14.js");
+			const { startTUI } = await import("./start-tui-CS802Ww9.js");
 			const { buildSession } = await import("./wizard-session-wPJtNl4c.js");
 			const tui = startTUI(VERSION, Program.McpAdd);
 			tui.store.session = buildSession({
@@ -2660,7 +3017,7 @@ function runMcpAdd(argv) {
 		} catch (error) {
 			if (!isTUIUnavailable(error)) throw error;
 			setUI(new LoggingUI());
-			const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-CfwEQT_z.js").then((n) => n.r);
+			const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-C58l_KpV.js").then((n) => n.r);
 			await addMCPServerToClientsStep({
 				local: localMcp,
 				features,
@@ -2699,7 +3056,7 @@ function runMcpRemove(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-WNb3ET14.js");
+			const { startTUI } = await import("./start-tui-CS802Ww9.js");
 			const { buildSession } = await import("./wizard-session-wPJtNl4c.js");
 			const tui = startTUI(VERSION, Program.McpRemove);
 			tui.store.session = buildSession({
@@ -2708,7 +3065,7 @@ function runMcpRemove(argv) {
 			});
 		} catch {
 			setUI(new LoggingUI());
-			const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-CfwEQT_z.js").then((n) => n.r);
+			const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-C58l_KpV.js").then((n) => n.r);
 			await removeMCPServerFromClientsStep({ local: localMcp });
 		}
 	})();
@@ -2730,7 +3087,7 @@ function runMcpTutorial(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-WNb3ET14.js");
+			const { startTUI } = await import("./start-tui-CS802Ww9.js");
 			const { buildSession } = await import("./wizard-session-wPJtNl4c.js");
 			const tui = startTUI(VERSION, Program.McpTutorial);
 			tui.store.session = buildSession({
@@ -2785,9 +3142,9 @@ function runWizard(config, options) {
 	(async () => {
 		try {
 			const installDir = options.installDir || process.cwd();
-			const { startTUI } = await import("./start-tui-WNb3ET14.js");
+			const { startTUI } = await import("./start-tui-CS802Ww9.js");
 			const { buildSession, RunPhase } = await import("./wizard-session-wPJtNl4c.js");
-			const { TaskStreamPush } = await import("./task-stream-CZawuzlz.js");
+			const { TaskStreamPush } = await import("./task-stream-BQNSp0qR.js");
 			const { PostHogDestination } = await import("./posthog-Cr37rnla.js");
 			tui = startTUI(WIZARD_VERSION, config.id);
 			const activeTui = tui;
@@ -2841,7 +3198,7 @@ function runWizard(config, options) {
 			await activeTui.store.getGate("health-check");
 			const skipAgent = config.run == null;
 			if (skipAgent) {
-				const { getOrAskForProjectData } = await import("./setup-utils-0U-_Md2G.js").then((n) => n.r);
+				const { getOrAskForProjectData } = await import("./setup-utils-CNWIMZ-d.js").then((n) => n.r);
 				const { projectApiKey, host, accessToken, projectId } = await getOrAskForProjectData({
 					signup: session.signup,
 					ci: session.ci,
@@ -2856,7 +3213,7 @@ function runWizard(config, options) {
 					projectId
 				});
 			} else {
-				const { runAgent } = await import("./agent-runner-CBbkS0Ro.js");
+				const { runAgent } = await import("./agent-runner-BNGW3osc.js");
 				await runAgent(config, activeTui.store.session);
 			}
 			const isDone = () => skipAgent ? activeTui.store.session.outroDismissed : activeTui.store.session.skillsComplete;
@@ -2933,10 +3290,10 @@ function runWizardCI(config, options) {
 	(async () => {
 		const path = await import("path");
 		const { buildSession } = await import("./wizard-session-wPJtNl4c.js");
-		const { readEnvironment } = await import("./environment-CyS37cmM.js").then((n) => n.t);
+		const { readEnvironment } = await import("./environment-DS5Pq9Wm.js").then((n) => n.t);
 		const { readApiKeyFromEnv } = await import("./env-api-key-MlzJYAvt.js").then((n) => n.t);
-		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-zMvpNYb2.js");
-		const { wizardAbort, WizardError } = await import("./wizard-abort-DWXyJdws.js");
+		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-fg4BAKKA.js");
+		const { wizardAbort, WizardError } = await import("./wizard-abort-CR3w2Efg.js");
 		configureLogFileFromEnvironment();
 		const env = readEnvironment();
 		const apiKey = options.apiKey ?? readApiKeyFromEnv() ?? void 0;
@@ -2987,7 +3344,7 @@ function runWizardCI(config, options) {
 					})
 				});
 			}
-			const { runAgent } = await import("./agent-runner-CBbkS0Ro.js");
+			const { runAgent } = await import("./agent-runner-BNGW3osc.js");
 			await runAgent(config, session);
 		} catch (error) {
 			const errorMessage = error instanceof Error ? error.message : String(error);
@@ -3205,6 +3562,34 @@ const PromptLabel = ({ message }) => {
 	}) });
 };
 //#endregion
+//#region src/ui/tui/primitives/ConfirmButton.tsx
+/**
+* ConfirmButton — the confirm row used to submit a selection.
+*
+* Pure render. Multi-select menus (PickerMenu mode="multi", GroupedPickerMenu)
+* append this below their options as the final focusable row: the user toggles
+* options with enter, then arrows down onto this row and presses enter to
+* submit. This replaces the older "enter anywhere submits" pattern, which
+* confused people who expected enter to toggle the focused item.
+*
+* Renders flat, mirroring the option rows — a focus triangle and the label,
+* accent and bold when focused, dimmed otherwise — so it lines up under the
+* options instead of sitting in a separate boxed target.
+*/
+const ConfirmButton = ({ label = "Confirm", focused, count }) => {
+	const text = count && count > 0 ? `${label} (${count})` : label;
+	return /* @__PURE__ */ jsxs(Text, {
+		color: focused ? Colors.accent : void 0,
+		bold: focused,
+		dimColor: !focused,
+		children: [
+			focused ? Icons.triangleSmallRight : " ",
+			" ",
+			text
+		]
+	});
+};
+//#endregion
 //#region src/ui/tui/hooks/keyboard-hints-utils.ts
 /** Default priorities by key type. */
 const DEFAULT_PRIORITY = {
@@ -3340,8 +3725,10 @@ function useKeyBindings(id, bindings) {
 //#region src/ui/tui/primitives/PickerMenu.tsx
 /**
 * PickerMenu — Single and multi select.
-* Single mode: custom renderer with small triangle indicator.
-* Multi mode: checkbox glyphs with space to toggle.
+* Single mode: custom renderer with small triangle indicator; enter selects.
+* Multi mode: checkbox glyphs toggled with enter, plus a focusable
+*   Confirm button below the options. The cursor moves onto the button and
+*   enter submits — see MultiPickerMenu for the rationale.
 *
 * Key bindings are declared via useKeyBindings, which auto-registers
 * hints in the KeyboardHintsBar.
@@ -3367,6 +3754,12 @@ function firstEnabled(options) {
 	const idx = options.findIndex((o) => !o.disabled);
 	return idx === -1 ? 0 : idx;
 }
+/** Index of the last enabled option, for wrapping from the button onto
+*  the bottom of the grid. */
+function lastEnabled(options) {
+	for (let i = options.length - 1; i >= 0; i--) if (!options[i]?.disabled) return i;
+	return options.length - 1;
+}
 const PickerMenu = ({ message, options, mode = "single", centered = false, columns = 1, optionMarginBottom = 0, onSelect }) => {
 	if (mode === "multi") return /* @__PURE__ */ jsx(MultiPickerMenu, {
 		message,
@@ -3470,60 +3863,90 @@ const SinglePickerMenu = ({ message, options, centered = false, columns = 1, opt
 		})]
 	});
 };
-/** Custom multi-select with checkbox glyphs and accent highlight. */
+/**
+* Custom multi-select with checkbox glyphs and accent highlight.
+*
+* Interaction model (shared with GroupedPickerMenu):
+*   - \u2191\u2193 move the cursor through the options AND onto the Confirm button,
+*     which lives just past the last option.
+*   - enter toggles the focused option (no more "space toggles but enter
+*     advances" split that tripped people up). Space is kept as an
+*     undocumented alias, but the hints bar advertises only enter.
+*   - moving onto the Confirm button and pressing enter submits the
+*     current selection.
+*/
 const MultiPickerMenu = ({ message, options, centered = false, columns = 1, optionMarginBottom = 0, onSelect }) => {
 	const [focused, setFocused] = useState(() => firstEnabled(options));
+	const [onButton, setOnButton] = useState(false);
 	const [selected, setSelected] = useState(/* @__PURE__ */ new Set());
 	const rows = Math.ceil(options.length / columns);
 	useEffect(() => {
 		if (focused >= options.length || options[focused]?.disabled) setFocused(firstEnabled(options));
 	}, [options, focused]);
-	const bindings = [
-		{
-			match: ["upArrow", "downArrow"],
-			label: "↑↓",
-			action: "navigate",
-			handler: (_input, key) => {
-				if (key.upArrow) setFocused(stepEnabled(options, rows, focused, -1));
-				if (key.downArrow) setFocused(stepEnabled(options, rows, focused, 1));
+	const confirm = () => {
+		onSelect([...selected].sort((a, b) => a - b).map((i) => options[i].value));
+	};
+	const bindings = [{
+		match: ["upArrow", "downArrow"],
+		label: "↑↓",
+		action: "navigate",
+		handler: (_input, key) => {
+			if (key.upArrow) {
+				if (onButton) {
+					setOnButton(false);
+					setFocused(lastEnabled(options));
+					return;
+				}
+				const col = Math.floor(focused / rows);
+				let r = focused % rows - 1;
+				while (r >= 0 && options[col * rows + r]?.disabled) r--;
+				if (r >= 0) setFocused(col * rows + r);
+				else setOnButton(true);
 			}
-		},
-		{
-			match: "space",
-			label: "space",
-			action: "toggle",
-			handler: () => {
-				if (options[focused]?.disabled) return;
-				setSelected((prev) => {
-					const next = new Set(prev);
-					if (next.has(focused)) {
-						next.delete(focused);
-						return next;
-					}
-					if (options[focused]?.exclusive) return new Set([focused]);
-					for (const i of next) if (options[i]?.exclusive) next.delete(i);
-					next.add(focused);
-					return next;
-				});
+			if (key.downArrow) {
+				if (onButton) {
+					setOnButton(false);
+					setFocused(firstEnabled(options));
+					return;
+				}
+				const col = Math.floor(focused / rows);
+				const row = focused % rows;
+				const colLen = Math.min(rows, options.length - col * rows);
+				let r = row + 1;
+				while (r < colLen && options[col * rows + r]?.disabled) r++;
+				if (r < colLen) setFocused(col * rows + r);
+				else setOnButton(true);
 			}
-		},
-		{
-			match: "return",
-			label: "enter",
-			action: "confirm",
-			handler: () => {
-				if (selected.size === 0) {
-					const hovered = options[focused];
-					if (hovered && !hovered.disabled) onSelect(hovered.value);
-				} else onSelect([...selected].sort().map((i) => options[i].value));
+		}
+	}, {
+		match: ["space", "return"],
+		label: "enter",
+		action: "select",
+		handler: () => {
+			if (onButton) {
+				confirm();
+				return;
 			}
+			if (options[focused]?.disabled) return;
+			setSelected((prev) => {
+				const next = new Set(prev);
+				if (next.has(focused)) {
+					next.delete(focused);
+					return next;
+				}
+				if (options[focused]?.exclusive) return new Set([focused]);
+				for (const i of next) if (options[i]?.exclusive) next.delete(i);
+				next.add(focused);
+				return next;
+			});
 		}
-	];
+	}];
 	if (columns > 1) bindings.splice(1, 0, {
 		match: ["leftArrow", "rightArrow"],
 		label: "←→",
 		action: "navigate",
 		handler: (_input, key) => {
+			if (onButton) return;
 			const col = Math.floor(focused / rows);
 			const row = focused % rows;
 			let next = focused;
@@ -3545,43 +3968,65 @@ const MultiPickerMenu = ({ message, options, centered = false, columns = 1, opti
 	return /* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",
 		alignItems: centered ? "center" : void 0,
-		children: [/* @__PURE__ */ jsx(PromptLabel, { message }), /* @__PURE__ */ jsx(Box, {
-			flexDirection: "row",
-			gap: 4,
-			marginLeft: centered ? 0 : 2,
-			marginTop: 1,
-			children: columnArrays.map((colOpts, colIdx) => /* @__PURE__ */ jsx(Box, {
-				flexDirection: "column",
-				children: colOpts.map((opt, rowIdx) => {
-					const flatIdx = colIdx * rows + rowIdx;
-					const isFocused = flatIdx === focused;
-					const isSelected = selected.has(flatIdx);
-					const label = opt.hint ? `${opt.label} (${opt.hint})` : opt.label;
-					const checkbox = isSelected ? Icons.squareFilled : Icons.squareOpen;
-					return /* @__PURE__ */ jsxs(Box, {
-						gap: 1,
-						marginBottom: optionMarginBottom,
-						children: [
-							/* @__PURE__ */ jsx(Text, {
-								color: isSelected ? "white" : Colors.muted,
-								dimColor: !isFocused && !isSelected,
-								children: checkbox
-							}),
-							opt.icon && /* @__PURE__ */ jsx(Text, {
-								color: opt.icon.color,
-								children: opt.icon.glyph
-							}),
-							/* @__PURE__ */ jsx(Text, {
-								color: opt.disabled ? Colors.muted : isFocused ? Colors.accent : void 0,
-								bold: isFocused && !opt.disabled,
-								dimColor: !isFocused || opt.disabled,
-								children: label
-							})
-						]
-					}, flatIdx);
+		children: [
+			/* @__PURE__ */ jsx(PromptLabel, { message }),
+			/* @__PURE__ */ jsx(Box, {
+				flexDirection: "row",
+				gap: 4,
+				marginLeft: centered ? 0 : 2,
+				marginTop: 1,
+				children: columnArrays.map((colOpts, colIdx) => /* @__PURE__ */ jsx(Box, {
+					flexDirection: "column",
+					children: colOpts.map((opt, rowIdx) => {
+						const flatIdx = colIdx * rows + rowIdx;
+						const isFocused = !onButton && flatIdx === focused;
+						const isSelected = selected.has(flatIdx);
+						const label = opt.hint ? `${opt.label} (${opt.hint})` : opt.label;
+						const checkbox = isSelected ? Icons.squareFilled : Icons.squareOpen;
+						return /* @__PURE__ */ jsxs(Box, {
+							flexDirection: "column",
+							marginBottom: optionMarginBottom,
+							children: [/* @__PURE__ */ jsxs(Box, {
+								gap: 1,
+								children: [
+									/* @__PURE__ */ jsx(Text, {
+										color: isSelected ? "white" : Colors.muted,
+										dimColor: !isFocused && !isSelected,
+										children: checkbox
+									}),
+									opt.icon && /* @__PURE__ */ jsx(Text, {
+										color: opt.icon.color,
+										children: opt.icon.glyph
+									}),
+									/* @__PURE__ */ jsx(Text, {
+										color: opt.disabled ? Colors.muted : isFocused ? Colors.accent : void 0,
+										bold: isFocused && !opt.disabled,
+										dimColor: !isFocused || opt.disabled,
+										children: label
+									})
+								]
+							}), opt.description && /* @__PURE__ */ jsx(Box, {
+								marginLeft: 4,
+								width: 56,
+								children: /* @__PURE__ */ jsx(Text, {
+									dimColor: true,
+									wrap: "wrap",
+									children: opt.description
+								})
+							})]
+						}, flatIdx);
+					})
+				}, colIdx))
+			}),
+			/* @__PURE__ */ jsx(Box, {
+				marginTop: 1,
+				marginLeft: centered ? 0 : 2,
+				children: /* @__PURE__ */ jsx(ConfirmButton, {
+					focused: onButton,
+					count: selected.size
 				})
-			}, colIdx))
-		})]
+			})
+		]
 	});
 };
 //#endregion
@@ -3766,7 +4211,7 @@ async function runDoctorCI(options) {
 	getUI().intro("Welcome to the PostHog setup wizard");
 	getUI().log.info("Running posthog-doctor in CI mode");
 	try {
-		const { getOrAskForProjectData } = await import("./setup-utils-0U-_Md2G.js").then((n) => n.r);
+		const { getOrAskForProjectData } = await import("./setup-utils-CNWIMZ-d.js").then((n) => n.r);
 		const { host, accessToken, projectId } = await getOrAskForProjectData({
 			signup: false,
 			ci: true,
@@ -3783,7 +4228,7 @@ async function runDoctorCI(options) {
 		for (const issue of sorted) getUI().log.info(`  • [${issue.severity}] ${getKindMeta(issue.kind).title}`);
 		process.exit(1);
 	} catch (error) {
-		const { ApiError } = await import("./api-CI3Z74NG.js").then((n) => n.n);
+		const { ApiError } = await import("./api-DCHci5SD.js").then((n) => n.n);
 		const message = error instanceof ApiError && error.statusCode === 401 ? "Your PostHog API key is invalid or expired." : error instanceof Error ? error.message : String(error);
 		getUI().log.error(`Doctor failed: ${message}`);
 		process.exit(1);
@@ -3831,6 +4276,30 @@ const migrateCommand = nativeCommandFactory(migrationConfig);
 */
 const revenueCommand = nativeCommandFactory(revenueAnalyticsConfig);
 //#endregion
+//#region src/commands/self-driving.ts
+const selfDrivingCommand = {
+	name: "self-driving",
+	description: selfDrivingConfig.description,
+	options: {
+		...skillProgramOptions,
+		...selfDrivingConfig.cliOptions ?? {}
+	},
+	check: (argv) => {
+		if (argv.signup) throw new Error("`self-driving` cannot run with --signup. It builds on an existing PostHog integration — run the base `wizard` to create your account and set up PostHog first, then run `wizard self-driving`.");
+		if (argv.ci) throw new Error("`self-driving` cannot run in CI mode — it requires interactive steps (GitHub connect, issue-tracker selection, custom-scout approval).");
+		return true;
+	},
+	handler: (argv) => {
+		const extras = selfDrivingConfig.mapCliOptions?.(argv) ?? {};
+		const options = {
+			...argv,
+			...extras
+		};
+		if (options.ci) runWizardCI(selfDrivingConfig, options);
+		else runWizard(selfDrivingConfig, options);
+	}
+};
+//#endregion
 //#region src/commands/slack.ts
 const slackCommand = {
 	name: "slack",
@@ -3846,7 +4315,7 @@ function runSlackConnect(argv) {
 	(async () => {
 		const debug = argv.debug;
 		try {
-			const { startTUI } = await import("./start-tui-WNb3ET14.js");
+			const { startTUI } = await import("./start-tui-CS802Ww9.js");
 			const { buildSession } = await import("./wizard-session-wPJtNl4c.js");
 			const tui = startTUI(VERSION, Program.SlackConnect);
 			tui.store.session = buildSession({ debug });
@@ -3967,6 +4436,247 @@ const skillCommand = {
 	}
 };
 //#endregion
+//#region src/steps/install-cli-steering/index.ts
+const dirExists = (...segments) => {
+	try {
+		return fs$1.existsSync(path$1.join(os.homedir(), ...segments));
+	} catch {
+		return false;
+	}
+};
+const CLI_STEERING_TARGETS = [
+	{
+		id: "claude-code",
+		name: "Claude Code",
+		instructionsPath: () => path$1.join(os.homedir(), ".claude", "CLAUDE.md"),
+		isDetected: () => dirExists(".claude")
+	},
+	{
+		id: "codex",
+		name: "Codex",
+		instructionsPath: () => path$1.join(os.homedir(), ".codex", "AGENTS.md"),
+		isDetected: () => dirExists(".codex")
+	},
+	{
+		id: "gemini",
+		name: "Gemini CLI",
+		instructionsPath: () => path$1.join(os.homedir(), ".gemini", "GEMINI.md"),
+		isDetected: () => dirExists(".gemini")
+	}
+];
+function findTarget(id) {
+	return CLI_STEERING_TARGETS.find((target) => target.id === id);
+}
+function detectTargets() {
+	return CLI_STEERING_TARGETS.filter((target) => target.isDetected());
+}
+const spawnOptions = {
+	encoding: "utf-8",
+	shell: process.platform === "win32"
+};
+/**
+* Install or update the PostHog CLI in the user's environment. `npm install
+* --global @posthog/cli@latest` covers both first-time installs and upgrades
+* for existing npm-installed CLIs.
+*/
+function installOrUpdatePostHogCli() {
+	const args = [
+		"install",
+		"--global",
+		"@posthog/cli@latest"
+	];
+	debug(`Running npm ${args.join(" ")}`);
+	const result = spawnSync("npm", args, spawnOptions);
+	if (result.error) return {
+		success: false,
+		error: `Failed to run npm: ${result.error.message}. Is Node.js installed?`
+	};
+	if (result.status !== 0) return {
+		success: false,
+		error: (result.stderr || result.stdout || "").trim() || `npm install --global @posthog/cli@latest exited with status ${result.status ?? "unknown"}`
+	};
+	return { success: true };
+}
+/**
+* Delegate the actual write to the installed `posthog-cli api agents-md
+* install`. The steering snippet lives in the CLI (its single source of truth),
+* so the command should run only after `installOrUpdatePostHogCli` refreshes
+* the CLI to the latest release.
+*/
+function installSteeringSnippet(filePath) {
+	const args = [
+		"api",
+		"agents-md",
+		"install",
+		"--path",
+		filePath
+	];
+	debug(`Running posthog-cli ${args.join(" ")}`);
+	const result = spawnSync("posthog-cli", args, {
+		...spawnOptions,
+		env: {
+			...process.env,
+			POSTHOG_CLI_EXPERIMENTAL_API: "1"
+		}
+	});
+	if (result.error) return {
+		success: false,
+		filePath,
+		error: `Failed to run posthog-cli: ${result.error.message}. Make sure npm's global bin directory is on your PATH.`
+	};
+	if (result.status !== 0) return {
+		success: false,
+		filePath,
+		error: (result.stderr || result.stdout || "").trim() || `posthog-cli exited with status ${result.status ?? "unknown"}`
+	};
+	return {
+		success: true,
+		filePath
+	};
+}
+//#endregion
+//#region src/commands/cli/add.ts
+const cliAddCommand = {
+	name: "add",
+	description: "Install or update PostHog CLI and add steering instructions to your coding agent's global instructions file",
+	options: {
+		agent: {
+			describe: "Agent to install the instructions for",
+			choices: CLI_STEERING_TARGETS.map((target) => target.id),
+			type: "string"
+		},
+		path: {
+			describe: "Write to an explicit instructions file instead of a detected agent",
+			type: "string"
+		},
+		all: {
+			default: false,
+			describe: "Install for every detected agent without prompting",
+			type: "boolean"
+		}
+	},
+	examples: [
+		["wizard cli add", "Detect your coding agents and pick one"],
+		["wizard cli add --agent claude-code", "Install for Claude Code (~/.claude/CLAUDE.md)"],
+		["wizard cli add --all", "Install for every detected agent"],
+		["wizard cli add --path ./AGENTS.md", "Install into a specific instructions file"]
+	],
+	check: (argv) => {
+		if (argv.all && (argv.agent || argv.path)) throw new Error("--all cannot be combined with --agent or --path");
+		return true;
+	},
+	handler: (argv) => {
+		runCliAdd(argv);
+	}
+};
+async function runCliAdd(argv) {
+	setUI(new LoggingUI());
+	const ui = getUI();
+	ui.intro("PostHog CLI setup");
+	const files = await resolveTargetFiles(argv);
+	if (files.length === 0) {
+		process.exit(1);
+		return;
+	}
+	ui.log.info("Installing or updating PostHog CLI...");
+	const cliInstallResult = installOrUpdatePostHogCli();
+	if (!cliInstallResult.success) {
+		ui.log.error(`Failed to install or update PostHog CLI: ${cliInstallResult.error ?? ""}`);
+		analytics.wizardCapture("cli steering installed", {
+			files: files.length,
+			failures: files.length,
+			cli_install_failed: true,
+			agent: typeof argv.agent === "string" ? argv.agent : void 0
+		});
+		process.exit(1);
+		return;
+	}
+	ui.log.success("Installed or updated PostHog CLI.");
+	let failures = 0;
+	for (const file of files) {
+		const result = installSteeringSnippet(file);
+		if (result.success) ui.log.success(`Installed PostHog steering instructions in ${file}`);
+		else {
+			failures += 1;
+			ui.log.error(`Failed to update ${file}: ${result.error ?? ""}`);
+		}
+	}
+	analytics.wizardCapture("cli steering installed", {
+		files: files.length,
+		failures,
+		agent: typeof argv.agent === "string" ? argv.agent : void 0
+	});
+	if (failures > 0) {
+		process.exit(1);
+		return;
+	}
+	ui.outro("Done. PostHog CLI is installed and your agent will now use `posthog-cli api` for PostHog tasks.");
+	process.exit(0);
+}
+/** Resolve which instruction files to write, from flags, detection, or a prompt. */
+async function resolveTargetFiles(argv) {
+	const ui = getUI();
+	if (typeof argv.path === "string" && argv.path.trim()) return [path$1.resolve(argv.path.trim())];
+	if (typeof argv.agent === "string") {
+		const target = findTarget(argv.agent);
+		if (!target) {
+			ui.log.error(`Unsupported agent: ${argv.agent}`);
+			return [];
+		}
+		return [target.instructionsPath()];
+	}
+	const detected = detectTargets();
+	if (detected.length === 0) {
+		ui.log.error("No supported coding agents detected. Pass --agent <id> or --path <file> to choose a target.");
+		ui.log.info(`Supported agents: ${CLI_STEERING_TARGETS.map((t) => t.id).join(", ")}`);
+		return [];
+	}
+	if (argv.all === true) {
+		ui.log.info(`Installing for all detected agents: ${detected.map((t) => t.name).join(", ")}`);
+		return detected.map((target) => target.instructionsPath());
+	}
+	if (detected.length === 1) {
+		ui.log.info(`Detected ${detected[0].name} (${detected[0].instructionsPath()})`);
+		return [detected[0].instructionsPath()];
+	}
+	if (!process.stdin.isTTY || !process.stdout.isTTY) {
+		ui.log.info(`Installing for all detected agents: ${detected.map((t) => t.name).join(", ")}`);
+		return detected.map((target) => target.instructionsPath());
+	}
+	return (await promptForTargets(detected)).map((target) => target.instructionsPath());
+}
+/** Minimal numbered selection — this command is intentionally not a TUI flow. */
+async function promptForTargets(detected) {
+	const ui = getUI();
+	ui.log.info("Which coding agent are you using?");
+	detected.forEach((target, index) => {
+		ui.log.info(`  ${index + 1}) ${target.name} (${target.instructionsPath()})`);
+	});
+	ui.log.info(`  ${detected.length + 1}) All of the above`);
+	const rl = readline.createInterface({
+		input: process.stdin,
+		output: process.stdout
+	});
+	try {
+		for (;;) {
+			const answer = (await rl.question(`Select 1-${detected.length + 1}: `)).trim();
+			const choice = Number(answer);
+			if (Number.isInteger(choice) && choice >= 1 && choice <= detected.length) return [detected[choice - 1]];
+			if (choice === detected.length + 1) return detected;
+			ui.log.warn(`Enter a number between 1 and ${detected.length + 1}.`);
+		}
+	} finally {
+		rl.close();
+	}
+}
+//#endregion
+//#region src/commands/cli/index.ts
+const cliCommand = {
+	name: "cli",
+	description: "PostHog CLI agent integration commands",
+	children: [cliAddCommand]
+};
+//#endregion
 //#region bin.ts
 const NODE_VERSION_RANGE = ">=18.17.0";
 if (!satisfies(process.version, NODE_VERSION_RANGE)) {
@@ -3982,8 +4692,8 @@ function resolveInstallDir() {
 	if (inline) return inline.slice(14);
 	return process.env.POSTHOG_WIZARD_INSTALL_DIR ?? process.cwd();
 }
-Wizard.use(basicIntegrationCommand).use(mcpCommand).use(auditCommand).use(doctorCommand).use(migrateCommand).use(revenueCommand).use(slackCommand).use(uploadSourcemapsCommand).use(skillCommand).init();
+Wizard.use(basicIntegrationCommand).use(mcpCommand).use(cliCommand).use(auditCommand).use(doctorCommand).use(migrateCommand).use(revenueCommand).use(selfDrivingCommand).use(slackCommand).use(uploadSourcemapsCommand).use(skillCommand).init();
 //#endregion
-export { POSTHOG_SDKS$1 as _, PromptLabel as a, PROGRAM_REGISTRY as c, DISPLAY_NAME as d, SOURCE_MAPS_CONTEXT_KEYS as f, getContentBlocks$2 as g, fetchHealthIssues as h, useKeyboardHintsContext as i, Program as l, getKindMeta as m, useKeyBindings as n, runWizardCI as o, getContentBlocks$1 as p, KeyboardHintsProvider as r, runWizard as s, PickerMenu as t, getProgramConfig as u, STRIPE_SDKS as v };
+export { POSTHOG_SDKS$1 as _, ConfirmButton as a, runWizard as c, getProgramConfig as d, DISPLAY_NAME as f, getContentBlocks$2 as g, fetchHealthIssues as h, useKeyboardHintsContext as i, PROGRAM_REGISTRY as l, getKindMeta as m, useKeyBindings as n, PromptLabel as o, SOURCE_MAPS_CONTEXT_KEYS as p, KeyboardHintsProvider as r, runWizardCI as s, PickerMenu as t, Program as u, STRIPE_SDKS as v };
 
 //# sourceMappingURL=bin.js.map