Agentic Data Plane

rpk ai run

Launch a third-party coding agent configured to send its model traffic through the Redpanda AI gateway for the current environment.

Authenticated sessions require an Agentic Data Plane API key. Account sign-in credentials are used only for provider reads and API-key management, never model invocation. The first launch in an environment asks to create a key valid for 30 days, stored next to rpk ai’s credentials file and replaced when it expires or is deleted. If key acquisition or validation fails, the launch stops. A declined or unanswered prompt never falls back to an account credential. `--api-key=yes creates a key without asking; --api-key=no disables creation and requires a provided Agentic Data Plane API key. Explicit local auth-disabled Claude/Codex environments retain their dummy/no-auth behavior; Antigravity CLI still requires an Agentic Data Plane API key.

Usage

rpk ai run [flags]

Subcommands

Command Description

rpk ai run agy

Launch Antigravity CLI (agy) through Google or Vertex Gemini providers. An isolated Gemini directory forces modelProvider=gemini without reading or changing your personal Antigravity CLI settings.

rpk ai run claude

Launch Anthropic’s Claude Code CLI with its model traffic routed through the Redpanda AI gateway for the current rpk ai environment. rpk ai points ANTHROPIC_BASE_URL at the gateway’s Anthropic Messages endpoint for the chosen provider and wires the gateway auth for the life of the session.

rpk ai run codex

Launch the OpenAI Codex CLI with its model traffic routed through the Redpanda AI gateway for the current rpk ai environment. rpk ai generates a throwaway Codex config in a temporary CODEX_HOME, points it at the gateway’s OpenAI-compatible Responses endpoint for the chosen provider, and authenticates Codex with an Agentic Data Plane API key.

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.