From 9dfef8629e68a59aa3827f514fee918d60c079d2 Mon Sep 17 00:00:00 2001 From: Noor ul ain Date: Tue, 30 Jun 2026 02:52:01 +0500 Subject: [PATCH] docs: document integration `search`/`info`/`scaffold` subcommands (#3174) (#3194) * 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) * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: Claude Opus 4.8 (1M context) Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- docs/reference/integrations.md | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/docs/reference/integrations.md b/docs/reference/integrations.md index faecc3952..c2fe1d8ea 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, 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 ```bash @@ -167,6 +188,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 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 | +| -------- | ---------------------------------------------------------------- | +| `--type` | Scaffold template to use: `markdown` (default), `skills`, `toml`, or `yaml` | + ## FAQ ### Can I install multiple integrations in the same project?