From 5837a9cbd71b9796425aae9d0e5cb77481f4b10f Mon Sep 17 00:00:00 2001
From: Dyan Galih <dyan.galih@gmail.com>
Date: Fri, 26 Jun 2026 02:16:59 +0000
Subject: [PATCH 1/2] docs: add missing integration subcommands

---
 docs/reference/integrations.md | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/docs/reference/integrations.md b/docs/reference/integrations.md
index 5746382161..a214598e84 100644
--- a/docs/reference/integrations.md
+++ b/docs/reference/integrations.md
@@ -54,6 +54,35 @@ Shows all available integrations, which one is currently installed, and whether
 When multiple integrations are installed, the list marks the default integration separately from the other installed integrations.
 The list also shows whether each built-in integration is declared multi-install safe.
 
+## Search Available Integrations
+
+```bash
+specify integration search [query]
+```
+
+| Option       | Description                          |
+| ------------ | ------------------------------------ |
+| `--tag`      | Filter by tag                        |
+| `--author`   | Filter by author                     |
+
+Searches the catalog for integrations matching the query. Without a query, lists all available integrations.
+
+## Integration Info
+
+```bash
+specify integration info <key>
+```
+
+Shows catalog information for an integration, including its description, author, repository, and tags.
+
+## Scaffold a New Integration
+
+```bash
+specify integration scaffold <key>
+```
+
+Creates a minimal integration stub for the given key.
+
 ## Install an Integration
 
 ```bash

From 9ed25b921fa049264eb34e1729340edcc535eff0 Mon Sep 17 00:00:00 2001
From: Dyan Galih <dyan.galih@gmail.com>
Date: Fri, 26 Jun 2026 02:23:11 +0000
Subject: [PATCH 2/2] docs: address feedback on integration subcommands

---
 docs/reference/integrations.md | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/docs/reference/integrations.md b/docs/reference/integrations.md
index a214598e84..7d33d6e2b0 100644
--- a/docs/reference/integrations.md
+++ b/docs/reference/integrations.md
@@ -65,12 +65,12 @@ specify integration search [query]
 | `--tag`      | Filter by tag                        |
 | `--author`   | Filter by author                     |
 
-Searches the catalog for integrations matching the query. Without a query, lists all available integrations.
+Searches all active catalogs for integrations matching the query. Without a query, lists all available integrations.
 
 ## Integration Info
 
 ```bash
-specify integration info <key>
+specify integration info <integration_id>
 ```
 
 Shows catalog information for an integration, including its description, author, repository, and tags.
@@ -78,10 +78,14 @@ Shows catalog information for an integration, including its description, author,
 ## Scaffold a New Integration
 
 ```bash
-specify integration scaffold <key>
+specify integration scaffold [options] <integration_id>
 ```
 
-Creates a minimal integration stub for the given key.
+| Option   | Description                                           |
+| -------- | ----------------------------------------------------- |
+| `--type` | The type of integration to scaffold (default: `markdown`) |
+
+Creates a minimal integration stub for the given integration ID.
 
 ## Install an Integration