diff --git a/.claude/skills/kongctl-new-command/SKILL.md b/.claude/skills/kongctl-new-command/SKILL.md index 21aea017079..3c676f79465 100644 --- a/.claude/skills/kongctl-new-command/SKILL.md +++ b/.claude/skills/kongctl-new-command/SKILL.md @@ -26,7 +26,9 @@ Pass a file or glob relative to `app/_includes/kongctl/help`: /kongctl-new-command get/event-gateway/backend-clusters.md ``` -If any paths correspond to removed commands (the include file no longer exists), handle those with Step 2 first, then skip to Step 3 for new ones. +For each path, check whether the include file exists at `app/_includes/kongctl/help/`: +- **File exists**: new command. Go to Step 3 (and Step 4 if it's a new resource group). +- **File does not exist**: removed command. Go to Step 2 first, then continue with any new commands. ## Prerequisites diff --git a/app/_data/tools/kongctl.yml b/app/_data/tools/kongctl.yml index 56b5a3fbd36..7a061523e66 100644 --- a/app/_data/tools/kongctl.yml +++ b/app/_data/tools/kongctl.yml @@ -1,9 +1,12 @@ name: kongctl releases: + - release: "1.9" + version: "1.9.0" + latest: true + released: 2026-07-30 - release: "1.8" version: "1.8.0" - latest: true released: 2026-07-23 - release: "1.7" version: "1.7.0" @@ -23,6 +26,3 @@ releases: - release: "1.2" version: "1.2.1" released: 2026-06-01 - - release: "1.0" - version: "1.0.0" - released: 2026-05-20 diff --git a/app/_includes/kongctl/help/dump/declarative.md b/app/_includes/kongctl/help/dump/declarative.md index 0b20ce9db33..156f9d747f5 100644 --- a/app/_includes/kongctl/help/dump/declarative.md +++ b/app/_includes/kongctl/help/dump/declarative.md @@ -38,6 +38,6 @@ Flags: -p, --profile string Specify the profile to use for this command. (default "default") --region string Konnect region identifier (for example "eu"). Used to construct the base URL when --base-url is not provided. - Config path: [ konnect.region ] - --resources string Comma separated list of resource types to dump (portals, apis, application_auth_strategies, dcr_providers, control_planes, analytics.dashboards, event_gateways, ai_gateways, ai_gateway_model_providers, ai_gateway_identity_providers, ai_gateway_policies, ai_gateway_agents, ai_gateway_consumers, ai_gateway_consumer_credentials, ai_gateway_consumer_groups, ai_gateway_models, ai_gateway_mcp_servers, ai_gateway_vaults, ai_gateway_data_plane_certificates, organization.teams). + --resources string Comma separated list of resource types to dump (portals, apis, application_auth_strategies, dcr_providers, control_planes, analytics.dashboards, event_gateways, ai_gateways, ai_gateway_model_providers, ai_gateway_identity_providers, ai_gateway_policies, ai_gateway_agents, ai_gateway_consumers, ai_gateway_consumer_credentials, ai_gateway_consumer_groups, ai_gateway_models, ai_gateway_mcp_servers, ai_gateway_config_stores, ai_gateway_vaults, ai_gateway_data_plane_certificates, organization.teams). ``` \ No newline at end of file diff --git a/app/_includes/kongctl/help/get/ai-gateway/config-stores.md b/app/_includes/kongctl/help/get/ai-gateway/config-stores.md new file mode 100644 index 00000000000..c15f90ed4f2 --- /dev/null +++ b/app/_includes/kongctl/help/get/ai-gateway/config-stores.md @@ -0,0 +1,69 @@ +```ansi +Usage: + kongctl get ai-gateway config-stores [config-store-id|config-store-name] [flags] + +Maturity: + beta + +Aliases: + config-stores, config-store + +Examples: + # List Config Stores by gateway name + kongctl get ai-gateway config-stores --gateway-name "Customer Support Gateway" + # Get a Config Store by name + kongctl get ai-gateway config-stores --gateway-id support-store + + +Flags: + --base-url string Base URL for Konnect API requests. + - Config path: [ konnect.base-url ] + - Default : [ https://us.api.konghq.com ] + --color-theme string Configures the CLI UI/theme (prompt, tables, TUI elements). + - Config path: [ color-theme ] + - Examples : [ auto, 3024_day, 3024_night, aardvark_blue, abernathy ] + - Reference : [ https://github.com/lrstanley/bubbletint/blob/master/DEFAULT_TINTS.md ] (default "auto") + --columns stringArray Select text columns as HEADER=.field (repeatable or comma-separated). Supports nested fields, quoted keys, array indexes, and string slices. + --config-file string Path to the configuration file to load. + - Default: [ $XDG_CONFIG_HOME/kongctl/config.yaml ] + --config-store-id string The ID of the AI Gateway Config Store to retrieve. + - Config path: [ konnect.ai-gateway.config-store.id ] + --config-store-name string The name of the AI Gateway Config Store to retrieve. + - Config path: [ konnect.ai-gateway.config-store.name ] + --gateway-id string The ID of the AI Gateway that owns the resource. + - Config path: [ konnect.ai-gateway.id ] + --gateway-name string The name or display_name of the AI Gateway that owns the resource. + - Config path: [ konnect.ai-gateway.name ] + -h, --help help for config-stores + --jq string Filter JSON responses using jq expressions (powered by gojq for full jq compatibility) + --jq-color string Controls colorized output for jq filter results. + - Config path: [ jq.color.enabled ] + - Allowed : [ auto|always|never ] (default "auto") + --jq-color-theme string Select the color theme used for jq filter results. + - Config path: [ jq.color.theme ] + - Examples : [ friendly, github-dark, dracula ] + - Reference : [ https://xyproto.github.io/splash/docs/ ] (default "friendly") + -r, --jq-raw-output Output string jq results without JSON quotes (like jq -r). + - Config path: [ jq.raw-output ] + --log-file string Write execution logs to the specified file instead of STDERR. + - Config path: [ log-file ] + --log-level string Configures the logging level. Execution logs are written to STDERR. + - Config path: [ log-level ] + - Allowed : [ trace|debug|info|warn|error ] (default "error") + --no-telemetry Disable telemetry for this command invocation. Overrides config and env. + - Config path: [ telemetry.enabled ] + - Env var : [ KONGCTL_NO_TELEMETRY ] + - Default : [ false ] + -o, --output string Configures the format of data written to STDOUT. + - Config path: [ output ] + - Allowed : [ json|yaml|text ] (default "text") + --page-size int Max number of results to include per response page for get and list operations. + - Config path: [ konnect.page-size ] (default 10) + --pat string Konnect Personal Access Token (PAT) used to authenticate the CLI. + Setting this value overrides tokens obtained from the login command. + - Config path: [ konnect.pat ] + -p, --profile string Specify the profile to use for this command. (default "default") + --region string Konnect region identifier (for example "eu"). Used to construct the base URL when --base-url is not provided. + - Config path: [ konnect.region ] + +``` \ No newline at end of file diff --git a/app/_includes/kongctl/help/get/ai-gateway/index.md b/app/_includes/kongctl/help/get/ai-gateway/index.md index 12291f31981..dea93ce785e 100644 --- a/app/_includes/kongctl/help/get/ai-gateway/index.md +++ b/app/_includes/kongctl/help/get/ai-gateway/index.md @@ -19,6 +19,7 @@ Examples: Available Commands: agents List or get Agents for a Konnect AI Gateway + config-stores List or get Config Stores for a Konnect AI Gateway consumer-groups List or get Consumer Groups for a Konnect AI Gateway consumers List or get Consumers for a Konnect AI Gateway credentials List or get Consumer Credentials for a Konnect AI Gateway Consumer diff --git a/app/_includes/kongctl/help/get/konnect/ai-gateway.md b/app/_includes/kongctl/help/get/konnect/ai-gateway.md index 6b42ca99f64..4326c16a17d 100644 --- a/app/_includes/kongctl/help/get/konnect/ai-gateway.md +++ b/app/_includes/kongctl/help/get/konnect/ai-gateway.md @@ -21,6 +21,7 @@ Examples: Available Commands: agents List or get Agents for a Konnect AI Gateway + config-stores List or get Config Stores for a Konnect AI Gateway consumer-groups List or get Consumer Groups for a Konnect AI Gateway consumers List or get Consumers for a Konnect AI Gateway credentials List or get Consumer Credentials for a Konnect AI Gateway Consumer diff --git a/app/_includes/kongctl/help/list/ai-gateway/config-stores.md b/app/_includes/kongctl/help/list/ai-gateway/config-stores.md new file mode 100644 index 00000000000..59bb4c4d827 --- /dev/null +++ b/app/_includes/kongctl/help/list/ai-gateway/config-stores.md @@ -0,0 +1,69 @@ +```ansi +Usage: + kongctl list ai-gateway config-stores [config-store-id|config-store-name] [flags] + +Maturity: + beta + +Aliases: + config-stores, config-store + +Examples: + # List Config Stores by gateway name + kongctl get ai-gateway config-stores --gateway-name "Customer Support Gateway" + # Get a Config Store by name + kongctl get ai-gateway config-stores --gateway-id support-store + + +Flags: + --base-url string Base URL for Konnect API requests. + - Config path: [ konnect.base-url ] + - Default : [ https://us.api.konghq.com ] + --color-theme string Configures the CLI UI/theme (prompt, tables, TUI elements). + - Config path: [ color-theme ] + - Examples : [ auto, 3024_day, 3024_night, aardvark_blue, abernathy ] + - Reference : [ https://github.com/lrstanley/bubbletint/blob/master/DEFAULT_TINTS.md ] (default "auto") + --columns stringArray Select text columns as HEADER=.field (repeatable or comma-separated). Supports nested fields, quoted keys, array indexes, and string slices. + --config-file string Path to the configuration file to load. + - Default: [ $XDG_CONFIG_HOME/kongctl/config.yaml ] + --config-store-id string The ID of the AI Gateway Config Store to retrieve. + - Config path: [ konnect.ai-gateway.config-store.id ] + --config-store-name string The name of the AI Gateway Config Store to retrieve. + - Config path: [ konnect.ai-gateway.config-store.name ] + --gateway-id string The ID of the AI Gateway that owns the resource. + - Config path: [ konnect.ai-gateway.id ] + --gateway-name string The name or display_name of the AI Gateway that owns the resource. + - Config path: [ konnect.ai-gateway.name ] + -h, --help help for config-stores + --jq string Filter JSON responses using jq expressions (powered by gojq for full jq compatibility) + --jq-color string Controls colorized output for jq filter results. + - Config path: [ jq.color.enabled ] + - Allowed : [ auto|always|never ] (default "auto") + --jq-color-theme string Select the color theme used for jq filter results. + - Config path: [ jq.color.theme ] + - Examples : [ friendly, github-dark, dracula ] + - Reference : [ https://xyproto.github.io/splash/docs/ ] (default "friendly") + -r, --jq-raw-output Output string jq results without JSON quotes (like jq -r). + - Config path: [ jq.raw-output ] + --log-file string Write execution logs to the specified file instead of STDERR. + - Config path: [ log-file ] + --log-level string Configures the logging level. Execution logs are written to STDERR. + - Config path: [ log-level ] + - Allowed : [ trace|debug|info|warn|error ] (default "error") + --no-telemetry Disable telemetry for this command invocation. Overrides config and env. + - Config path: [ telemetry.enabled ] + - Env var : [ KONGCTL_NO_TELEMETRY ] + - Default : [ false ] + -o, --output string Configures the format of data written to STDOUT. + - Config path: [ output ] + - Allowed : [ json|yaml|text ] (default "text") + --page-size int Max number of results to include per response page for get and list operations. + - Config path: [ konnect.page-size ] (default 10) + --pat string Konnect Personal Access Token (PAT) used to authenticate the CLI. + Setting this value overrides tokens obtained from the login command. + - Config path: [ konnect.pat ] + -p, --profile string Specify the profile to use for this command. (default "default") + --region string Konnect region identifier (for example "eu"). Used to construct the base URL when --base-url is not provided. + - Config path: [ konnect.region ] + +``` \ No newline at end of file diff --git a/app/_includes/kongctl/help/list/ai-gateway/index.md b/app/_includes/kongctl/help/list/ai-gateway/index.md index 038b7824921..4669384829a 100644 --- a/app/_includes/kongctl/help/list/ai-gateway/index.md +++ b/app/_includes/kongctl/help/list/ai-gateway/index.md @@ -17,6 +17,7 @@ Examples: Available Commands: agents List or get Agents for a Konnect AI Gateway + config-stores List or get Config Stores for a Konnect AI Gateway consumer-groups List or get Consumer Groups for a Konnect AI Gateway consumers List or get Consumers for a Konnect AI Gateway credentials List or get Consumer Credentials for a Konnect AI Gateway Consumer diff --git a/app/_includes/kongctl/help/list/konnect/ai-gateway.md b/app/_includes/kongctl/help/list/konnect/ai-gateway.md index 5b9f0b948c2..f9f2f604d2a 100644 --- a/app/_includes/kongctl/help/list/konnect/ai-gateway.md +++ b/app/_includes/kongctl/help/list/konnect/ai-gateway.md @@ -21,6 +21,7 @@ Examples: Available Commands: agents List or get Agents for a Konnect AI Gateway + config-stores List or get Config Stores for a Konnect AI Gateway consumer-groups List or get Consumer Groups for a Konnect AI Gateway consumers List or get Consumers for a Konnect AI Gateway credentials List or get Consumer Credentials for a Konnect AI Gateway Consumer diff --git a/app/kongctl/get/ai-gateway.md b/app/kongctl/get/ai-gateway.md index 279b97f6bae..4e0a9e425e3 100644 --- a/app/kongctl/get/ai-gateway.md +++ b/app/kongctl/get/ai-gateway.md @@ -39,6 +39,9 @@ rows: - command: | [kongctl get ai-gateway consumers](/kongctl/get/ai-gateway/#kongctl-get-ai-gateway-consumers) description: "Use the `consumers` command to list or retrieve Consumers for a specific {{site.konnect_short_name}} {{site.ai_gateway}}." + - command: | + [kongctl get ai-gateway config-stores](/kongctl/get/ai-gateway/#kongctl-get-ai-gateway-config-stores) + description: "Use the `config-stores` command to list or retrieve Config Stores for a {{site.konnect_short_name}} {{site.ai_gateway}}." - command: | [kongctl get ai-gateway credentials](/kongctl/get/ai-gateway/#kongctl-get-ai-gateway-credentials) description: "Use the `credentials` command to list or retrieve Credentials for a specific {{site.konnect_short_name}} {{site.ai_gateway}} Consumer." @@ -90,6 +93,12 @@ Use the `consumers` command to list or retrieve Consumers for a specific {{site. {% include_cached /kongctl/help/get/ai-gateway/consumers.md %} +### kongctl get ai-gateway config-stores + +Use the `config-stores` command to list or retrieve Config Stores for a {{site.konnect_short_name}} {{site.ai_gateway}}. + +{% include_cached /kongctl/help/get/ai-gateway/config-stores.md %} + ### kongctl get ai-gateway credentials Use the `credentials` command to list or retrieve Credentials for a specific {{site.konnect_short_name}} {{site.ai_gateway}} Consumer. diff --git a/app/kongctl/list/ai-gateway.md b/app/kongctl/list/ai-gateway.md index 3341fa32845..07a9257f016 100644 --- a/app/kongctl/list/ai-gateway.md +++ b/app/kongctl/list/ai-gateway.md @@ -39,6 +39,9 @@ rows: - command: | [kongctl list ai-gateway consumers](/kongctl/list/ai-gateway/#kongctl-list-ai-gateway-consumers) description: "Use the `consumers` command to list or retrieve Consumers for a specific {{site.konnect_short_name}} {{site.ai_gateway}}." + - command: | + [kongctl list ai-gateway config-stores](/kongctl/list/ai-gateway/#kongctl-list-ai-gateway-config-stores) + description: "Use the `config-stores` command to list or retrieve Config Stores for a {{site.konnect_short_name}} {{site.ai_gateway}}." - command: | [kongctl list ai-gateway credentials](/kongctl/list/ai-gateway/#kongctl-list-ai-gateway-credentials) description: "Use the `credentials` command to list or retrieve Credentials for a specific {{site.konnect_short_name}} {{site.ai_gateway}} Consumer." @@ -90,6 +93,12 @@ Use the `consumers` command to list or retrieve Consumers for a specific {{site. {% include_cached /kongctl/help/list/ai-gateway/consumers.md %} +### kongctl list ai-gateway config-stores + +Use the `config-stores` command to list or retrieve Config Stores for a {{site.konnect_short_name}} {{site.ai_gateway}}. + +{% include_cached /kongctl/help/list/ai-gateway/config-stores.md %} + ### kongctl list ai-gateway credentials Use the `credentials` command to list or retrieve Credentials for a specific {{site.konnect_short_name}} {{site.ai_gateway}} Consumer.