docs(nuxt): add sentry init setup

docs/platforms/javascript/guides/nuxt/index.mdx

@@ -14,35 +14,55 @@ categories:
 
 ## Install
 
+<Alert level="warning">
+
+The AI-powered `sentry init` flow is currently experimental. To use the existing framework-specific setup instead, see the option below, or check out the [Manual Setup](/platforms/javascript/guides/nuxt/manual-setup/) guide.
+
+</Alert>
+
 <SplitLayout>
 <SplitSection>
 <SplitSectionText>
 
-To install Sentry using the installation wizard, run the following command within your project:
+Run the Sentry init command in your project directory to automatically configure Sentry in your Nuxt application.
 
-The wizard then guides you through the setup process, asking you to enable additional (optional) Sentry features for your application beyond error monitoring.
+The command guides you through setup and asks which optional Sentry features you want to enable beyond error monitoring.
 
 </SplitSectionText>
 <SplitSectionCode>
 
 ```bash
-npx @sentry/wizard@latest -i nuxt
+npx sentry@latest init
 ```
 
 </SplitSectionCode>
 </SplitSection>
 </SplitLayout>
 
-<Include name="quick-start-features-expandable" />
+<Alert level="info" title="Prefer the existing framework wizard?">
+
+If you don't want to use the experimental AI-powered flow, run the framework-specific installation wizard instead:
+
+```bash
+npx @sentry/wizard@latest -i nuxt
+```
+
+To configure Sentry without a wizard, follow the [Manual Setup](/platforms/javascript/guides/nuxt/manual-setup/) guide.
+
+</Alert>
+
+<Expandable title="How does sentry init work?">
+
+The `sentry init` command is AI-powered. It analyzes your project and generates a tailored integration, rather than applying a fixed template. Here's what it does:
 
-This guide assumes that you enable all features and allow the wizard to create an example page or component. You can add or remove features at any time, but setting them up now will save you the effort of configuring them manually later.
+- **Analyzes your project** — reads project files and manifests to understand your Nuxt app structure, including monorepos. It also respects AI instruction files such as `CLAUDE.md`, `AGENTS.md`, and `.cursorrules`.
+- **Detects your framework** — identifies Nuxt and selects the `@sentry/nuxt` SDK.
+- **Fetches official Sentry docs** — uses the current Sentry documentation as the source of truth when generating integration code.
+- **Installs dependencies** — adds `@sentry/nuxt` using your project's package manager.
+- **Creates and modifies files** — sets up client-side and server-side initialization, Nuxt module configuration, and other selected features based on your project structure.
+- **Verifies the integration** — re-reads modified files after writing to confirm Sentry was integrated.
 
-<Expandable title="What does the installation wizard change inside your application?">
-- Creates `sentry.(client|server).config.ts` to initialize the SDK
-- Creates or updates your `nuxt.config.ts` to add build options to add source maps upload and auto-instrumentation via Vite plugins
-- Creates `.env.sentry-build-plugin` with an auth token to upload source maps (this file is automatically added to `.gitignore`)
-- Adds an example page and route to your application to help verify your Sentry setup
-  - If it couldn't create a page, the wizard adds an example component instead
+For full details on what each file does, see the [Manual Setup](/platforms/javascript/guides/nuxt/manual-setup/) guide.
 
 </Expandable>
 

docs/platforms/javascript/guides/nuxt/manual-setup.mdx

@@ -5,8 +5,19 @@ description: "Learn how to manually set up Sentry in your Nuxt app and capture y
 ---
 
 <Alert level="info">
-  For the fastest setup, we recommend using the [wizard
-  installer](/platforms/javascript/guides/nuxt).
+  For automated setup, run the experimental AI-powered `sentry init` command:
+
+  ```bash
+  npx sentry@latest init
+  ```
+
+  If you'd rather use the existing Nuxt installation wizard, run:
+
+  ```bash
+  npx @sentry/wizard@latest -i nuxt
+  ```
+
+  Continue with this guide to set up Sentry manually.
 </Alert>
 
 <PlatformContent includePath="getting-started-complete" />