AI Setup CLI

Join the Preview!

AI Setup CLI is in Preview.

An interactive CLI that uses AI agents to automatically instrument projects with Datadog. Instead of manual SDK integration, this tool leverages Claude to detect your project structure, modify your codebase, and set up Datadog products — frontend, backend, infrastructure, AI, security, and CI testing.

Quick Start

Run it interactively — the CLI walks you through sign-in / sign-up, picks a product group, confirms the workspace, and instruments your code:

npx @datadog/ai-setup-cli --site datadoghq.com

Or skip the picker by passing --product:

npx @datadog/ai-setup-cli --site datadoghq.com --product rum

Arguments

| Argument | Description | Required | Default | |----------|-------------|----------|---------| | --site | Datadog site (see Supported Sites) | Yes | — | | --product | Product to instrument (see Supported Products). When omitted, the CLI shows an interactive picker. | No | — | | --auto-approve | Auto-approve all bash commands without prompting | No | false | | -h, --help | Show help (includes all product-specific flags) | — | — |

Product-specific arguments

Each product can define additional flags in its products/<name>/config.yaml. Pass them as --flag=value. The full set is also printed by --help.

| Product | Flag | Description | |---------|------|-------------| | rum | --app-id / --rum-application-id | RUM Application ID | | rum | --rum-client-token | RUM client token | | rum | --rum-framework | Framework (e.g. react, browser) | | error-tracking | --app-id | RUM Application ID for Error Tracking | | product-analytics | --app-id | RUM Application ID | | llm-obs | --api-key | Datadog API Key | | llm-obs | --llm-obs-app | LLM application name (DD_LLMOBS_ML_APP) | | infra-monitoring (Kubernetes) | --k8s-products / --enabled-products | Comma-separated products to enable (apm, logs, infrastructure, otel). --enabled-products wins if both are set. | | infra-monitoring | --k8s-distro | gke, eks, minikube, aks, … | | infra-monitoring | --k8s-cluster-name | Cluster name | | infra-monitoring | --k8s-env-name | DD_ENV value | | infra-monitoring | --k8s-library-versions | e.g. java:v1,python:v4,js:v5 | | infra-monitoring | --k8s-target-namespaces | Namespaces to include | | infra-monitoring | --k8s-disabled-namespaces | Namespaces to exclude | | infra-monitoring | --k8s-registry | Override container registry | | docker | --products | Comma-separated products (infra, apm, logs). Default: infra,apm,logs. | | docker | --library-versions | Language tracer/library versions | | docker | --env | DD_ENV value | | linux | --products | Comma-separated products (infra, apm, logs, otel). Default: infra,apm,logs. | | linux | --env | DD_ENV value | | serverless | --api-key | Datadog API Key | | serverless | --serverless-compute-type | aws-lambda, gcp-cloud-run, gcp-cloud-run-functions (inferred if omitted) | | serverless | --serverless-runtime | nodejs, python, java, ruby, dotnet, go (inferred if omitted) | | serverless | --development-framework | aws-cdk, aws-sam, serverless-framework, terraform, ci, other (inferred if omitted) | | test-optimization | --api-key | Datadog API Key | | ci_code_coverage | --api-key | Datadog API Key |

Environment variables

| Variable | Description | Values | |----------|-------------|--------| | COLOR_THEME | Force light/dark color theme (default: auto-detect via COLORFGBG, falls back to dark) | light, dark | | COLOR_SCHEME | Switch color scheme | datadog (default), high-contrast |

Supported Sites

| Site | Value | |------|-------| | US1 | datadoghq.com | | US3 | us3.datadoghq.com | | US5 | us5.datadoghq.com | | EU1 | datadoghq.eu | | AP1 | ap1.datadoghq.com | | AP2 | ap2.datadoghq.com |

Supported Products

Shown in the interactive picker, grouped by category:

| Group | Product | --product value | |-------|---------|-------------------| | Infrastructure (pick one) | Kubernetes | infra-monitoring | | Infrastructure | Docker | docker | | Infrastructure | Linux | linux | | Infrastructure | Serverless | serverless | | Frontend Monitoring | RUM | rum | | Frontend Monitoring | Error Tracking | error-tracking | | Frontend Monitoring | Product Analytics | product-analytics | | LLM-Based applications | LLM Observability | llm-obs | | CI Testing | Test Optimization | test-optimization | | CI Testing | Code Coverage | ci_code_coverage |

Hidden from the picker but installable via --product=<value>:

| Product | --product value | |---------|-------------------| | App and API Protection | app_and_api_protection | | OpenTelemetry | otel | | Studio | studio |