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.
npx @posthog/wizard
With a single command, the wizard automatically:
- Authenticates your PostHog account
- Installs the relevant PostHog SDK(s)
- Scans your codebase and app architecture
- Creates directories and files
- Configures
.env
file with your project credentials - Writes code and initializes the PostHog SDKs client-side and server-side
- Optionally installs the PostHog MCP server for your AI agent
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):
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.