On this page

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

Amplitude CLI

Early Access

This feature is in Early Access. During this time, aspects of the functionality may still be developed, and this documentation may not always be up to date. If you have any questions, contact Amplitude Support.

amp is a command-line client for the Developer API. The API's OpenAPI spec generates amp's command surface directly, so every API command maps to an operation. Use amp to manage projects, event and user properties, events, feature flags, and saved charts from a terminal, script, or AI agent's shell instead of calling the REST endpoints directly.

Built for two readers

amp output adapts to who's reading it. In an interactive terminal, list and context commands print human-friendly tables and summaries. Pipe the output to a file or another command, or pass --json, and amp prints raw, compact API JSON instead, so an agent or script doesn't spend tokens or effort parsing decoration.

How amp fits with other Amplitude tools

  • Developer API: amp is a client for this API. Every command maps to one or more Developer API requests, and the same authentication, scopes, and resources apply to both.
  • SDKs: The projects, taxonomy, and feature flags you manage with amp are the same objects your app reads and writes at runtime through an Amplitude SDK. Use amp to set up and administer those objects; use an SDK to instrument your application against them.
  • Setup wizard: The Amplitude Wizard CLI (npx @amplitude/wizard) onboards a codebase, detects your framework, and instruments SDK events. amp doesn't instrument code; use it to manage the projects, taxonomy, and flags that an instrumented app reads and writes.
  • Amplitude MCP: MCP gives an AI client natural-language, OAuth-based access to the same kinds of Amplitude objects. Use amp for scriptable automation in agents and CI where a conversational interface isn't the right fit.

To get started, go to Install and Authentication, then follow the quickstart.

Was this helpful?