From 4f3bee70ee1e437fb9deffc256451cd5994a015f Mon Sep 17 00:00:00 2001 From: Noor-ul-ain001 Date: Sat, 27 Jun 2026 13:23:53 +0500 Subject: [PATCH 1/3] docs: document integration search/info/scaffold subcommands (#3174) docs/reference/integrations.md omitted three subcommands that exist in code, breaking parity with the extension/preset/bundle/workflow references which all document their search/info equivalents. Added sections for: - `specify integration search [query]` (--tag, --author) - `specify integration info ` - `specify integration scaffold ` (--type: markdown/skills/toml/yaml) Content mirrors the command docstrings, arguments, and options in src/specify_cli/integrations/_query_commands.py and _scaffold_commands.py. Fixes #3174. Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/reference/integrations.md | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/docs/reference/integrations.md b/docs/reference/integrations.md index 5746382161..f78e953532 100644 --- a/docs/reference/integrations.md +++ b/docs/reference/integrations.md @@ -54,6 +54,27 @@ 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 active catalog stack for integrations matching the query. Without a query, lists all available integrations. Must be run inside a Spec Kit project. + +## Integration Info + +```bash +specify integration info +``` + +Shows catalog details for a single integration, including its description, type (CLI-based or IDE-based), author, and tags. Must be run inside a Spec Kit project. + ## Install an Integration ```bash @@ -166,6 +187,18 @@ Example: specify integration install generic --integration-options="--commands-dir .myagent/cmds" ``` +## Scaffold a New Integration + +```bash +specify integration scaffold +``` + +Creates a minimal built-in integration package and a matching test skeleton, then prints the next steps for wiring it up. The `` must be lowercase kebab-case (for example, `my-agent`). + +| Option | Description | +| -------- | ---------------------------------------------------------------- | +| `--type` | Scaffold template to use: `markdown` (default), `skills`, `toml`, or `yaml` | + ## FAQ ### Can I install multiple integrations in the same project? From cc4f96a7d7adfa96dac14b65ada7a7f044002298 Mon Sep 17 00:00:00 2001 From: Noor ul ain Date: Mon, 29 Jun 2026 19:43:39 +0500 Subject: [PATCH 2/3] Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- docs/reference/integrations.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/integrations.md b/docs/reference/integrations.md index f78e953532..19bc6a3315 100644 --- a/docs/reference/integrations.md +++ b/docs/reference/integrations.md @@ -193,7 +193,7 @@ specify integration install generic --integration-options="--commands-dir .myage specify integration scaffold ``` -Creates a minimal built-in integration package and a matching test skeleton, then prints the next steps for wiring it up. The `` must be lowercase kebab-case (for example, `my-agent`). +Creates a minimal built-in integration package and a matching test skeleton in the Spec Kit repository, then prints the next steps for wiring it up. Run this command from the Spec Kit repository root. The `` must be lowercase kebab-case (for example, `my-agent`). | Option | Description | | -------- | ---------------------------------------------------------------- | From 78eec7132f0ff3f9235d02cf2199046683e42e5a Mon Sep 17 00:00:00 2001 From: Noor ul ain Date: Mon, 29 Jun 2026 21:44:37 +0500 Subject: [PATCH 3/3] Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- docs/reference/integrations.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/integrations.md b/docs/reference/integrations.md index 19bc6a3315..6544dac758 100644 --- a/docs/reference/integrations.md +++ b/docs/reference/integrations.md @@ -73,7 +73,7 @@ Searches the active catalog stack for integrations matching the query. Without a specify integration info ``` -Shows catalog details for a single integration, including its description, type (CLI-based or IDE-based), author, and tags. Must be run inside a Spec Kit project. +Shows catalog details for a single integration, including its description, author, license, tags, source catalog, repository (when available), and whether it is currently active. Must be run inside a Spec Kit project. ## Install an Integration