Agentic Data Plane

rpk ai doctor

Diagnose CLI setup without changing files, logging in, or selecting an environment. Authentication is checked locally. Connectivity probes send no credentials. Use --offline to skip network checks.

This command was introduced in ai version 0.2.110.

Usage

rpk ai doctor [flags]

Examples

This section provides examples of how to use rpk ai doctor.

rpk ai doctor
rpk ai doctor --json
rpk ai doctor --offline

Flags

Value Type Description

--json

bool

Output diagnostics as JSON, overriding --format.

--offline

bool

Skip the AI Gateway connectivity probe and the release lookup.

--timeout

duration

Maximum time to wait for each network check, up to 30s.

Global flags

Value Type Description

--config

string

Redpanda or rpk config file; default search paths are ~/.config/rpk/rpk.yaml, $PWD/redpanda.yaml, and /etc/redpanda/redpanda.yaml.

-X, --config-opt

stringArray

Override rpk configuration settings; -X help for detail or -X list for terser detail.

--ignore-profile

bool

Ignore rpk.yaml and redpanda.yaml; use default settings.

--profile

string

rpk profile to use.

-v, --verbose

bool

Enable verbose logging.