π« Toolkit to help you get started with SDD or any other process!
docs: document integration catalog subcommands (#3206)
Quratulain-bilal00f6a80201eb
diff --git a/docs/reference/integrations.md b/docs/reference/integrations.mdindex c2fe1d8ea..18dbdd1c4 100644--- a/docs/reference/integrations.md+++ b/docs/reference/integrations.md@@ -173,6 +173,47 @@ is `null` when no installed integration set can be evaluated, such as when theintegration state is missing, unreadable, lacks a valid recorded integrationlist, or records no installed integrations.+## Catalog Management++Integration catalogs control where the discovery commands (`search` and `info`) look for integrations. Catalogs are checked in priority order.++### List Catalogs++```bash+specify integration catalog list+```++Shows the active catalog sources. Project-level sources (when configured) are removable by index; otherwise the active sources are shown as non-removable.++### Add a Catalog++```bash+specify integration catalog add <url>+```++| Option | Description |+| --------------- | ----------------------------- |+| `--name <name>` | Optional name for the catalog |++Adds a custom catalog URL to the project's `.specify/integration-catalogs.yml`. The URL must use HTTPS (except `http://localhost`, `http://127.0.0.1`, or `http://[::1]` for local testing).++### Remove a Catalog++```bash+specify integration catalog remove <index>+```++Removes a project catalog source by its 0-based index in `catalog list`.++### Catalog Resolution Order++Catalogs are resolved in this order (first match wins):++1. **Environment variable** β `SPECKIT_INTEGRATION_CATALOG_URL` overrides all catalogs+2. **Project config** β `.specify/integration-catalogs.yml`+3. **User config** β `~/.specify/integration-catalogs.yml`+4. **Built-in defaults** β official catalog + community catalog+## Integration-Specific OptionsSome integrations accept additional options via `--integration-options`: