Skip to content

:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.

1.4 KB
Raw Blame
import { useValues } from 'kea'

import { preflightLogic } from 'lib/logic/preflightLogic'
import { teamLogic } from 'scenes/teamLogic'

const BASE_COMMAND = 'npx -y @posthog/wizard@latest'

export interface UseWizardCommandOptions {
    /**
     * Append `--project-id=<current team>` so the wizard pre-targets the project
     * being viewed (and, once the consent screen honors the hint, pre-selects it).
     * Harmless if the user authorizes the same project.
     */
    pinProjectId?: boolean
}

/**
 * The canonical `npx @posthog/wizard` command, with an optional subcommand
 * (e.g. `mcp-analytics`). The wizard resolves the cloud region from the OAuth
 * login token, so no `--region` flag is added. Kept dependency-light so
 * eagerly-loaded surfaces (like the product empty-state gate) can use it
 * without pulling in heavy onboarding components.
 */
export function useWizardCommand(
    subcommand?: string,
    { pinProjectId = false }: UseWizardCommandOptions = {}
): { wizardCommand: string; isCloudOrDev: boolean } {
    const { isCloudOrDev } = useValues(preflightLogic)
    const { currentTeam } = useValues(teamLogic)

    const subcommandPart = subcommand ? ` ${subcommand}` : ''
    const projectPart = pinProjectId && currentTeam?.id ? ` --project-id=${currentTeam.id}` : ''

    return {
        wizardCommand: `${BASE_COMMAND}${subcommandPart}${projectPart}`,
        isCloudOrDev: isCloudOrDev ?? false,
    }
}