---
id: f3d8a1c2-e4b5-4f6a-8c7d-9e0f1a2b3c4d
blueprint: get-started
title: 'Amplitude Setup Wizard CLI'
description: 'Install Amplitude with one terminal command using an AI-powered CLI that instruments events tailored to your codebase and creates your first dashboard.'
landing: false
exclude_from_sitemap: false
updated_at: 1744761600
---

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.

```shell
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.

{{partial:admonition type="note"}}
The Amplitude Setup Wizard requires Node.js 20+.
{{/partial:admonition}}

{{partial:admonition type="tip"}}
Prefer a manual setup? Follow the [Amplitude Quickstart](/docs/get-started/amplitude-quickstart) to instrument your site directly.
{{/partial:admonition}}

## 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](/docs/sdks/analytics/browser/browser-sdk-2) or [Browser Unified SDK](/docs/sdks/analytics/browser/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](https://github.com/amplitude/mcp-marketplace/tree/main/plugins/amplitude), which provides the same MCP tools along with built-in slash commands for quick access.

  Inside a Claude Code session:

  ```bash
  /plugin install amplitude
  ```

  Or from your terminal:

  ```bash
  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

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