Amplitude Setup Wizard CLI

One command, one terminal session. The wizard reads your actual codebase to propose events tailored to your app. You review and approve every change before the wizard writes anything.

npx @amplitude/wizard

The wizard runs in your terminal. Amplitude is testing Claude Code in Terminal, with Claude Code Desktop, Cursor Desktop, and more in development. Run npx @amplitude/wizard --help for information about subcommands and options.

What happens when you run it

1. Authenticate: The wizard signs you in (or picks up an existing session) and lets you choose your org, project, and data region.
2. Detect your framework: The wizard scans your project to identify your stack. It supports 18+ frameworks including Next.js, React, Vue, Django, Flask, Swift, Android, Flutter, Go, and more. Web projects use Browser SDK 2 or Browser Unified SDK.
3. Propose and instrument events: An Amplitude AI agent reads your codebase, proposes tracking events based on what your app does, and waits for your approval before writing any code. You don't need your own agent license.
4. Set up MCP integration: The wizard offers to install the Amplitude MCP server in your editor so you can query your analytics data in plain English.
5. Verify: The wizard polls the Amplitude API until it detects events arriving. Run your app, trigger some actions, and the wizard shows you the events as they flow in.
6. Create charts and a dashboard: The agent builds your first dashboard in Amplitude so you have something useful the moment data starts flowing.

If you stop the wizard with Ctrl+C, it crashes, or you close the terminal, the wizard saves a checkpoint. Run it again in the same directory to resume.

Access your data from wherever you work

• Terminal or IDE: Use the Amplitude MCP server to ask questions about your data in plain English from Claude, Cursor, or any MCP-compatible AI tool. Agents can run the CLI using --agent or --ci mode.

• Claude Code plugin: Install the Amplitude plugin for Claude Code, which provides the same MCP tools along with built-in slash commands for quick access.

  Inside a Claude Code session:

  /plugin install amplitude
  

  Or from your terminal:

  claude plugin install amplitude
  

  After installing, run /mcp in Claude Code and follow the browser prompts to log in to Amplitude. The plugin includes slash commands like /amplitude:create-chart, /amplitude:create-dashboard, /amplitude:instrument-events, /amplitude:replay-ux-audit, /amplitude:weekly-brief, and more.

• Slack or Teams app: Connect Amplitude to your team's messaging tool to get insights, create charts, and more where you work.

Things to try after your data is flowing

• Watch your first session replay: Review exactly what users experience in your app.
• Launch a web experiment: A/B test features with no extra code using the Visual Editor.
• Create a guide or survey: Collect in-product feedback or surface messages to specific user segments.

Feedback

The wizard is open source. View the source, report issues, and contribute on GitHub.

Share what's working and what you'd like next: wizard@amplitude.com.