Skip to content

Add AI observability wizard command to start here and installation docs - #19269

Merged
marco-g-pm merged 3 commits into
masterfrom
claude/ai-observability-wizard-docs-4b2324
Aug 5, 2026
Merged

Add AI observability wizard command to start here and installation docs#19269
marco-g-pm merged 3 commits into
masterfrom
claude/ai-observability-wizard-docs-4b2324

Conversation

@marco-g-pm

@marco-g-pm marco-g-pm commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Changes

The wizard CLI now ships a dedicated ai-observability command ("Add PostHog AI Observability to your LLM calls" — verified against npx @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 the wizard ai-observability row to the commands table.
  • src/hooks/productData/ai_observability.tsx – flips wizardSupport from 'Coming soon' to true, 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

  • I've read the docs and/or content style guides.
  • Words are spelled using American English
  • Use relative URLs for internal links
  • I've checked the pages added or changed in the Vercel preview build
  • If I moved a page, I added a redirect in vercel.json (no pages moved)

🤖 Generated with Claude Code

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>
@github-actions

github-actions Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview Aug 05, 2026 03:04PM

@github-actions

github-actions Bot commented Aug 5, 2026

Copy link
Copy Markdown
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!

contents/docs/ai-engineering/ai-wizard.mdx — 0 errors, 7 warnings, 0 suggestions
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

@marco-g-pm

Copy link
Copy Markdown
Contributor Author

Waiting on context-mill update to merge PostHog/context-mill#319

@marco-g-pm
marco-g-pm requested a review from a team August 5, 2026 13:55
@marco-g-pm
marco-g-pm marked this pull request as ready for review August 5, 2026 13:55
@github-actions

github-actions Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Bundle report

Total JS (gzip)

7.03 MiB (+1.6 KiB / +0.0%)

Largest changed named chunks
Chunk Gzip Δ vs master
app.js 2180.1 KiB +1.5 KiB / +0.1%

Eager graph (modules shipped in each entrypoint's initial chunks)

Entrypoint Eager size Budget Modules
app 16.74 MiB (+8.3 KiB / +0.0%) report-only 2012
Largest modules in the app closure
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).

marco-g-pm and others added 2 commits August 5, 2026 10:34
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>
@marco-g-pm
marco-g-pm merged commit d71df78 into master Aug 5, 2026
20 checks passed
@marco-g-pm
marco-g-pm deleted the claude/ai-observability-wizard-docs-4b2324 branch August 5, 2026 15:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants