PostHog Handbook Library / Wizard And Docs

604 words. Estimated reading time: 3 min.

Wizard overview

Developers love the wizard. It started as the fastest way to get a deep, correct PostHog integration, without the hallucinations that come from naive agent-based attempts. It's growing into something more like a forward deployed agent.

npx -y @posthog/wizard@latest

Why a CLI

Users run the wizard with one npx command. This is a big reason it's so portable. Running a command feels better than copying and pasting a prompt into an agent, which is annoying. It works in any terminal, in any project, with no setup.

Because we own the harness, a run is unlikely to be affected by the user's local setup, their model preferences, or whatever else is polluting their agent's context. We can also track the success rate of real runs on the wizard dashboard, and use it to improve the docs.

What it does today

Roadmap

Things we'd like to work on, in no particular order. For what we're doing this quarter, see the team's objectives.

Who owns what

The wizard has a shared ownership model. The owns the wizard as a harness, and makes it better for everyone. Product teams own the programs for their part of the product.

| Part | Owner | Folder in the wizard | |---|---|---| | Wizard core: agent, harness, TUI, and CLI | | agent, tui, cli | | TUI + npx wizard | | posthog-integration | | Headless CLI wizard | | headless | | Cloud in-app wizard | | headless | | Main integration | | posthog-integration | | Migration | | migration | | Audit | | audit | | Error tracking | | error-tracking, error-tracking-upload-source-maps | | Revenue analytics | | revenue-analytics | | Web analytics doctor | | web-analytics-doctor | | Warehouse sources | | warehouse-source | | Self-driving | | self-driving | | MCP analytics | | mcp-analytics | | Metrics | | metrics | | Replay vision | | replay-vision | | AI observability | | ai-observability | | Run any skill with wizard skill | | agent-skill | | Feature flags, for now | | feature-flags |

%%{init: {"block": {"padding": 16}}}%%
block-beta
  columns 4
  surfBand["Wizard surfaces · owner per surface"]:4
  tui["TUI wizard<br/>team-wizard-docs"]
  headless["Headless CLI wizard<br/>team-growth"]
  cloud["Cloud in-app wizard<br/>team-growth"]
  mcpw["MCP wizard<br/>team-context-mcp · coming soon"]
  progBand["Wizard programs · owner per program"]:4
  integ["PostHog integration<br/>team-wizard-docs"]
  audit["Audit<br/>team-fde"]
  eaudit["Events audit<br/>team-fde"]
  askill["Agent skill<br/>team-wizard-docs"]
  et["Error tracking<br/>team-error-tracking"]
  sm["Source maps upload<br/>team-error-tracking"]
  ff["Feature flags<br/>team-wizard-docs · for now"]
  mig["Migration<br/>team-fde"]
  aio["AI observability<br/>team-ai-observability"]
  mcpa["MCP analytics<br/>mcp-analytics"]
  met["Metrics<br/>team-apm"]
  rv["Replay vision<br/>team-replay"]
  rev["Revenue analytics<br/>team-web-analytics"]
  wad["Web analytics doctor<br/>team-web-analytics"]
  sd["Self-driving<br/>team-self-driving"]
  wh["Warehouse source<br/>team-warehouse-sources"]
  platBand["Wizard platform · owner team-wizard-docs"]:4
  agent["agent"]
  tuip["TUI"]
  cli["CLI"]
  svc["services"]

  classDef wd fill:#3b82f626,stroke:#3b82f6,stroke-width:2px
  classDef pt fill:#22c55e26,stroke:#22c55e,stroke-width:2px
  classDef soon fill:none,stroke:#9ca3af,stroke-dasharray:4 3
  classDef band fill:#9ca3af40,stroke:none
  class tui,integ,askill,ff,agent,tuip,cli,svc wd
  class headless,cloud,audit,eaudit,et,sm,mig,aio,mcpa,met,rv,rev,wad,sd,wh pt
  class mcpw soon
  class surfBand,progBand,platBand band

Blue is the , green is another team, and dashed is coming soon. Surfaces run programs, and programs run on the platform.

New top-level command names need sign-off from the , because a public command is hard to remove.

Programs live in src/programs/. CODEOWNERS requests reviews from the owner. For who owns each skill, see the context mill.

Ask questions in #team-wizard-and-docs.

Go deeper

Canonical URL: https://posthog.com/handbook/wizard-and-docs/wizard

GitHub source: contents/handbook/wizard-and-docs/wizard.mdx

Content hash: a565998afc97be55

Static reader notes
  • MDX_COMPONENT_STATIC_ADAPTER: Adapted interactive MDX components for static reading: PrivateLink, SmallTeam.