---
title: Quickstart
description: "Install the amp CLI, authenticate, confirm your context, and create your first feature flag from the terminal."
product: general
token_estimate: 396
---
# Quickstart

> For AI agents: a documentation index is available at [/docs/llms.txt](/docs/llms.txt). Append `.md` to any page URL for markdown, or send `Accept: text/markdown`.

Follow these steps to go from a fresh install to your first feature flag.

1. **Install the CLI**

   ```bash
   npm install -g @amplitude/developer-cli
   ```

   Go to [Install](https://amplitude.com/docs/developers/cli/install) for `npx` usage and prerequisites.
2. **Log in**

   Authenticate with the OAuth device flow and save the result as the default US profile:

   ```bash
   amp auth login --region us
   ```

   Approve the request in the browser when prompted. Go to [Authentication](https://amplitude.com/docs/developers/cli/authentication) for Personal Access Tokens and profile management.
3. **Check your context**

   Confirm the CLI resolves your authentication and org/project context:

   ```bash
   amp context
   ```
4. **List your projects**

   ```bash
   amp projects list
   ```

   In an interactive terminal, this prints a table. Pipe it to another command, or pass `--json`, to get raw API JSON instead.
5. **Create a feature flag**

   Create a flag in one of your projects:

   ```bash
   amp flags create --project <project_id> --key my-flag --name "My Flag"
   ```

   Then confirm it exists:

   ```bash
   amp flags get --project <project_id> --flag <flag_id>
   ```

From here, run `amp help` to list every available command surface, or check [Configuration](https://amplitude.com/docs/developers/cli/configuration) for global flags like `--json` and `--dry-run`.