Add AI observability wizard command to start here and installation docs - #19269
Merged
Conversation
The wizard now ships a dedicated `ai-observability` command, so surface it in the AI Observability docs the same way other products do: - Installation index: add the standard "AI wizard" section with <WizardCommand command="ai-observability" />, mirroring error tracking, experiments, and surveys - Start here: offer the wizard as the fastest path in the first quest step, keeping the platform grid as the manual option - AI wizard page: add the `wizard ai-observability` row to the commands table - Flip wizardSupport from 'Coming soon' to true now that the CLI supports it - Fix doubled ↗ on the AI Observability nav link by dropping the literal arrow from the label and using a relative URL Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Contributor
Deploy preview
|
Contributor
|
Vale prose linter → found 5 errors, 20 warnings, 0 suggestions in your markdown Full report → Copy the linter results into an LLM to batch-fix issues. Linter being weird? Update the rules!
|
| Line | Severity | Message | Rule |
|---|---|---|---|
| 77:76 | warning | 'subcommands' is a possible misspelling. | PostHogBase.Spelling |
| 78:57 | warning | Capitalize 'Revenue Analytics' for PostHog's product. Use 'revenue analytics' for the general industry concept. | PostHogBase.ProductNames |
| 87:11 | warning | 'subcommands' is a possible misspelling. | PostHogBase.Spelling |
| 89:73 | warning | 'subcommand' is a possible misspelling. | PostHogBase.Spelling |
| 98:41 | warning | Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept. | PostHogBase.ProductNames |
| 108:66 | warning | 'subcommand' is a possible misspelling. | PostHogBase.Spelling |
| 109:62 | warning | 'subcommand' is a possible misspelling. | PostHogBase.Spelling |
contents/docs/ai-observability/start-here.mdx — 0 errors, 8 warnings, 0 suggestions
| Line | Severity | Message | Rule |
|---|---|---|---|
| 22:28 | warning | Use 'X' instead of 'x'. | Vale.Terms |
| 107:1 | warning | '** Product analytics' heading should be in sentence case, and product names should be capitalized. | PostHogBase.SentenceCase |
| 107:66 | warning | Capitalize 'Product Analytics' for PostHog's product. Use 'Product analytics' for the general industry concept. | PostHogBase.ProductNames |
| 118:1 | warning | '** Error tracking' heading should be in sentence case, and product names should be capitalized. | PostHogBase.SentenceCase |
| 118:70 | warning | Capitalize 'Error Tracking' for PostHog's product. Use 'Error tracking' for the general industry concept. | PostHogBase.ProductNames |
| 120:65 | warning | Capitalize 'Error Tracking' for PostHog's product. Use 'error tracking' for the general industry concept. | PostHogBase.ProductNames |
| 129:1 | warning | '** Session replay' heading should be in sentence case, and product names should be capitalized. | PostHogBase.SentenceCase |
| 129:72 | warning | Capitalize 'Session Replay' for PostHog's product. Use 'Session replay' for the general industry concept. | PostHogBase.ProductNames |
src/components/WizardHint/README.md — 5 errors, 5 warnings, 0 suggestions
| Line | Severity | Message | Rule |
|---|---|---|---|
| 20:36 | error | Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. | PostHogBase.EnDash |
| 20:38 | warning | Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. | PostHogBase.ProductNames |
| 20:171 | warning | Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. | PostHogBase.ProductNames |
| 21:42 | error | Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. | PostHogBase.EnDash |
| 27:33 | warning | 'subcommand' is a possible misspelling. | PostHogBase.Spelling |
| 35:54 | warning | 'localStorage' is a possible misspelling. | PostHogBase.Spelling |
| 35:160 | error | Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. | PostHogBase.EnDash |
| 37:35 | error | Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. | PostHogBase.EnDash |
| 38:28 | error | Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. | PostHogBase.EnDash |
| 40:87 | warning | 'localStorage' is a possible misspelling. | PostHogBase.Spelling |
Contributor
Author
|
Waiting on context-mill update to merge PostHog/context-mill#319 |
marco-g-pm
marked this pull request as ready for review
August 5, 2026 13:55
Contributor
Bundle reportTotal JS (gzip)7.03 MiB (+1.6 KiB / +0.0%) Largest changed named chunks
Eager graph (modules shipped in each entrypoint's initial chunks)
Largest modules in the
|
| Module | Size |
|---|---|
./src/data/mcp-tools.json |
954.6 KiB |
css ./node_modules/.pnpm/css-loader@5.2.7_webpack@5.101.3/node_modules/css-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[1]!./node_modules/.pnpm/postcss-loader@4.3.0_postcss@8.5.6_webpack@5.101.3/node_modules/postcss-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[2]!./src/styles/global.css |
735.5 KiB |
./src/components/Stickers/Stickers.tsx |
696.4 KiB |
./node_modules/.pnpm/@radix-ui+react-icons@1.3.2_react@18.3.1/node_modules/@radix-ui/react-icons/dist/react-icons.esm.js |
481.4 KiB |
./node_modules/.pnpm/rehype-raw@7.0.0/node_modules/rehype-raw/lib/index.js + 29 modules |
395.1 KiB |
./node_modules/.pnpm/@posthog+icons@0.36.6_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@posthog/icons/dist/posthog-icons.cjs.js |
364.8 KiB |
./node_modules/.pnpm/@posthog+icons@0.36.6_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@posthog/icons/dist/posthog-icons.es.js |
354.8 KiB |
./src/hooks/useCustomers.tsx + 54 modules |
354.8 KiB |
./node_modules/.pnpm/react-markdown@8.0.7_@types+react@16.14.66_react@18.3.1/node_modules/react-markdown/lib/react-markdown.js + 88 modules |
351.4 KiB |
./src/components/ProductComparisonTable/index.tsx + 126 modules |
296.6 KiB |
./node_modules/.pnpm/cloudinary-core@2.14.0_lodash@4.17.21/node_modules/cloudinary-core/cloudinary-core.js |
281.9 KiB |
./src/components/SearchUI/index.tsx + 87 modules |
273.0 KiB |
./node_modules/.pnpm/@posthog+brand@0.8.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/magnifying-glass.mjs |
254.7 KiB |
./node_modules/.pnpm/framer-motion@10.18.0_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/framer-motion/dist/es/render/dom/motion.mjs + 109 modules |
253.9 KiB |
./node_modules/.pnpm/d3@7.9.0/node_modules/d3/src/index.js + 208 modules |
247.4 KiB |
Eager-graph budgets are report-only until a baseline is established. Sizes are gzip of public/**/*.js; eager size is webpack module source bytes for the modules actually shipped in the entrypoint's initial chunks (post-tree-shake).
Radu-Raicea
approved these changes
Aug 5, 2026
Mirror the data warehouse pattern: the Handbook template now renders a dismissible wizard banner below the title of every AI observability platform installation page, pushing `npx @posthog/wizard ai-observability` as the automated alternative to manual SDK setup. - Extract the banner from WarehouseWizardHint into a generic WizardHint component (command, copy, and dismissal key as props); WarehouseWizardHint becomes a thin preconfigured wrapper so its call sites are unchanged - Add AIObservabilityWizardHint and render it from Handbook.tsx on /docs/ai-observability/installation/* paths, excluding the coding-agent integrations (Claude Code, OpenClaw, Pi) where the wizard doesn't apply - Wire pre-paint dismissal for the new key in theme-init.js and global.css Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Closing the WizardHint banner now collapses it to a slim bar (hedgehog, title, chevron) that expands back to the full banner on click, so the wizard command stays reachable after dismissal. Both states are always rendered and CSS keyed on the pre-paint <html> class decides which shows, so the persisted state applies with no flash. Expanding clears the stored preference. Applies to both the warehouse and AI observability variants. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Changes
The wizard CLI now ships a dedicated
ai-observabilitycommand ("Add PostHog AI Observability to your LLM calls" — verified againstnpx @posthog/wizard@latest --help), so this surfaces it in the docs the same way other products do:/docs/ai-observability/installation– adds the standard "AI wizard" section at the top with<WizardCommand command="ai-observability" />, followed by a "Platforms" heading around the existing platform grid. Mirrors the error tracking / experiments / surveys installation pages./docs/ai-observability/start-here– the first quest step now offers the wizard as the fastest install path (same flow as MCP Analytics and Product Analytics start-here pages), keeping the platform grid as the manual option./docs/ai-engineering/ai-wizard– adds thewizard ai-observabilityrow to the commands table.src/hooks/productData/ai_observability.tsx– flipswizardSupportfrom'Coming soon'totrue, which moves AI Observability into the supported-products list on the AI wizard page.src/navs/index.js– fixes the "AI Observability ↗ ↗" double arrow in the AI engineering docs nav: the label had a literal↗baked in and the URL was absolute, so the nav also appended its own external-link icon. Now a clean label with a relative URL, consistent with every other docs entry.All pages verified locally in a dev server (installation, start-here, and ai-wizard render the command and table row correctly; the nav shows a single clean link).
Checklist
vercel.json(no pages moved)🤖 Generated with Claude Code