AI wizard

Last updated:

|

The PostHog AI wizard helps you easily add PostHog to your application codebase using AI. It's an agentic CLI tool that handles the entire PostHog installation and integration process on your behalf.

Terminal
npx @posthog/wizard

With a single command, the wizard automatically:

  1. Authenticates your PostHog account
  2. Installs the relevant PostHog SDK(s)
  3. Scans your codebase and app architecture
  4. Creates directories and files
  5. Configures .env file with your project credentials
  6. Writes code and initializes the PostHog SDKs client-side and server-side
  7. Optionally installs the PostHog MCP server for your AI agent
The AI wizard integrating both the JS Web SDK and Node SDK into a Next.js application

We think flows like the AI wizard are pretty cool and the future of developer experience. The AI wizard is our recommended and default method for installing PostHog and getting started.

If you have any feedback or requests, our growth team would love to hear from you. Feel free to comment on this page or open an issue on GitHub.

AI wizard installation

Install PostHog in seconds with our wizard by running this command in your project directory with your terminal (it also works for LLM coding agents like Cursor and Bolt):

prompt
npx -y @posthog/wizard@latest --region us

Wait for it to finish and test the setup once the wizard is complete.

The wizard supports React, Next.js, Svelte, and React Native. We've got more on the way.

Check out the wizard's GitHub repo for more details.

Set up a reverse proxy (recommended)

We recommend setting up a reverse proxy, so that events are less likely to be intercepted by tracking blockers.

We have our own managed reverse proxy service included in the platform add-ons, which routes through our infrastructure and makes setting up your proxy easy.

If you don't want to use our managed service then there are several other options for creating a reverse proxy, including using Cloudflare, AWS Cloudfront, and Vercel.

Grouping products in one project (recommended)

If you have multiple customer-facing products (e.g. a marketing website + mobile app + web app), it's best to install PostHog on them all and group them in one project.

This makes it possible to track users across their entire journey (e.g. from visiting your marketing website to signing up for your product), or how they use your product across multiple platforms.

Questions? Ask Max AI.

It's easier than reading through 807 pages of documentation

Community questions

Was this page useful?

Next article

Model Context Protocol (MCP)

The PostHog Model Context Protocol (MCP) server enables your AI agents and tools to directly interact with PostHog's products. Quick install using the PostHog wizard Besides being able to quickly set up your project using AI , the PostHog Wizard can also install the MCP server directly into Cursor , Claude Code , Claude Desktop , VS Code and Zed . We're working on adding more supported tools to the wizard. If you're using another option, you can manually install our MCP server with…

Read next article