From e557d52e427e747cd036b809f4965e8223d2eb3f Mon Sep 17 00:00:00 2001
From: "charmenta[bot]" <291047445+charmenta[bot]@users.noreply.github.com>
Date: Thu, 11 Jun 2026 18:34:05 +0000
Subject: [PATCH] auto-update(docs): chore: replace removed flat CLI commands
 with canonical adk integrations subcommands

---
 adk/cli-reference.mdx      | 47 ++++++++++++++++++--------------------
 adk/setup/integrations.mdx | 14 ++++++------
 2 files changed, 29 insertions(+), 32 deletions(-)

diff --git a/adk/cli-reference.mdx b/adk/cli-reference.mdx
index bee89212..129a84f6 100644
--- a/adk/cli-reference.mdx
+++ b/adk/cli-reference.mdx
@@ -105,64 +105,61 @@ These commands add, inspect, and manage the integrations your agent depends on:
 
 | Command | Description |
 |---------|-------------|
-| `adk add <resource>` | Add an integration or interface (aliases: `i`, `install`) |
+| `adk integrations add <resource>` | Add an integration or interface (aliases: `i`, `install`) |
 | `adk remove [resource]` | Remove an integration, interface, or plugin (alias: `rm`) |
 | `adk upgrade [integration]` | Upgrade integration(s) to latest version (alias: `up`) |
-| `adk search <query>` | Search the Botpress Hub |
-| `adk list` | List installed integrations |
-| `adk info <name>` | Show detailed integration info |
+| `adk integrations search <query>` | Search the Botpress Hub |
+| `adk integrations list` | List installed integrations |
+| `adk integrations info <name>` | Show detailed integration info |
 
-### `adk add`
+### `adk integrations add`
 
 Add an integration or interface to your agent. Accepts a name, `workspace/name`, or a specific version:
 
 ```bash
-adk add webchat
-adk add slack@latest
-adk add slack@0.5.0
-adk add my-workspace/custom@1.0.0
-adk add interface:translator@1.0.0
-adk add webchat --alias custom-webchat
+adk integrations add webchat
+adk integrations add slack@latest
+adk integrations add slack@0.5.0
+adk integrations add my-workspace/custom@1.0.0
+adk integrations add interface:translator@1.0.0
+adk integrations add webchat --alias custom-webchat
 ```
 
 | Flag | Description |
 |------|-------------|
 | `--alias <alias>` | Custom alias for the resource |
 
-### `adk search`
+### `adk integrations search`
 
 Search the Botpress Hub for integrations:
 
 ```bash
-adk search crm
-adk search slack --limit 5
+adk integrations search crm
+adk integrations search slack --limit 5
 ```
 
 | Flag | Description | Default |
 |------|-------------|---------|
 | `--limit <number>` | Max results to return | `20` |
 
-### `adk list`
+### `adk integrations list`
 
-List integrations in your project, or all available ones on the Hub:
+List installed integrations in your project:
 
-```bash
-adk list
-adk list --available
-```
+adk integrations list
 
 | Flag | Description | Default |
 |------|-------------|---------|
-| `--available` | List all available integrations (not just installed) | |
+| `--limit <n>` | Max results | `50` |
 | `--limit <n>` | Max results | `50` |
 
-### `adk info`
+### `adk integrations info`
 
 Show details for a specific integration. Filter by a single facet or show the full spec:
 
-```bash
-adk info slack
-adk info slack --actions
+adk integrations info slack
+adk integrations info slack --actions
+adk integrations info slack --full
 adk info slack --full
 ```
 
diff --git a/adk/setup/integrations.mdx b/adk/setup/integrations.mdx
index c9970d85..6f44fc43 100644
--- a/adk/setup/integrations.mdx
+++ b/adk/setup/integrations.mdx
@@ -63,13 +63,13 @@ You can also manage integrations from the command line:
 
 | Command | What it does |
 |---------|-------------|
-| `adk search <query>` | Search the Botpress Hub for integrations |
-| `adk list --available` | List all available integrations |
-| `adk info <name>` | Show details, actions, events, and channels for an integration |
-| `adk add <name>` | Add an integration to your project |
-| `adk add <name> --alias <alias>` | Add with a custom alias |
-| `adk upgrade <name>` | Update an integration to a newer version |
-| `adk remove <name>` | Remove an integration from your project |
+| `adk integrations search <query>` | Search the Botpress Hub for integrations |
+| `adk integrations list` | List installed integrations |
+| `adk integrations info <name>` | Show details, actions, events, and channels for an integration |
+| `adk integrations add <name>` | Add an integration to your project |
+| `adk integrations add <name> --alias <alias>` | Add with a custom alias |
+| `adk integrations upgrade <name>` | Update an integration to a newer version |
+| `adk integrations remove <name>` | Remove an integration from your project |
 
 Newly added integrations are disabled by default. You can enable and configure them in the dev console.