PostHog Setup Wizard
https://github.com/posthog/wizard- Category
- Developer Tools
- Rank
- No. 820Tools index
Previous survey · No. 826 ·
- Pricing
- Open Source
- Type
- TOOL
- Builder
- PostHog
- GitHub
- 193 stars
- Latest release
- v2.73.0
- Date
About
Interactive CLI wizard that adds PostHog analytics to your project in seconds.
What it does
The wizard uses an AI agent to inspect a project, detect its framework, configure PostHog initialization, add starter event instrumentation, and guide the user toward a first dashboard. Separate commands can audit analytics, connect warehouse sources, configure revenue analytics, upload source maps, and manage MCP servers.
Why it's ranked here
Its scope extends well beyond initial installation. Framework detection, starter instrumentation, audits, source-map uploads, warehouse connections, and MCP management share one command surface. The strongest reservation is operational: project source is sent to Anthropic, telemetry defaults on, and published builds do not support the documented CI mode.
What's good
It states its data handling clearly. Environment files and detected secrets remain local, telemetry can be disabled, and organization-level AI approval gates source transmission. The default flow detects the framework and adds useful initial events rather than stopping after SDK installation. Existing integrations can also be checked by focused audit areas.
Tradeoffs
The AI workflow sends project source files to Anthropic through PostHog's gateway. Its secret scanner reduces exposure but does not remove that architectural consideration. Run metadata is collected unless disabled. Published packages reject CI mode, so normal installation currently requires an interactive terminal. Some specialized programs also assume existing PostHog, Stripe, or other project dependencies.
How to use it well
Use it when adopting or checking PostHog across supported frontend, backend, or mobile frameworks, especially when guided code changes and starter instrumentation save manual setup work. Review the resulting changes before committing, decide whether telemetry fits your policy, and confirm AI processing approval first. It does not replace a general analytics strategy or a currently usable published CI installer.
Technical notes+
package.json defines a public ESM npm package requiring Node 22.22.0 or newer, with TypeScript build, type-check, lint, unit, coverage, smoke, Warlock smoke, and end-to-end scripts. src/env.ts separates compile-time constants from runtime environment access through a typed allowlist and gates unsupported production features. src/commands/basic-integration/index.ts dynamically imports interactive, CI, headless, and playground branches only when selected. src/ui/index.ts provides a replaceable logging or Ink UI singleton, while src/ui/tui/App.tsx builds services and screens from a shared store. src/lib/detection/index.ts exports framework, feature, context, version, and agent-assisted project detection. src/commands/mcp/index.ts exposes add, remove, and tutorial subcommands.
Observed
- License
- MIT
- Primary language
- TypeScript, with TSX used for the terminal interface
- Packaging
- Public ESM npm package named @posthog/wizard
- Install surface
- Runs directly through npx
- Interfaces
- Interactive CLI with program commands, audit commands, skill execution, and MCP server management
- Runtime requirement
- Node.js 22.22.0 or newer
- Framework coverage
- README states support for more than 16 frontend, backend, and mobile frameworks
- Verification structure
- Package scripts include type checking, linting, unit tests, coverage, smoke tests, and end-to-end tests
Read from README.md, package.json, src/env.ts, src/ui/index.ts, src/steps/index.ts, src/ui/tui/App.tsx, src/lib/runners/index.ts, src/commands/cli/index.ts, src/commands/mcp/index.ts, src/lib/detection/index.ts, src/lib/middleware/index.ts, src/lib/task-stream/index.ts, src/lib/wizard-tools/index.ts, src/lib/health-checks/index.ts, src/commands/basic-integration/index.ts.
What it can do
Add PostHog analytics to existing project
Software project directory → Project with PostHog analytics integration
Generate PostHog configuration code
Project type and requirements → Analytics configuration code
Install PostHog dependencies
Project package manager information → Installed PostHog SDK and dependencies
Configure analytics tracking setup
User preferences and tracking requirements → Customized analytics tracking configuration
Guide user through PostHog integration steps
User responses to setup prompts → Step-by-step setup completion
Tags
Tech Stack
Media
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.