github/spec-kit · error · IntegrationCatalogError

Failed to fetch any integration catalog

Error message

Failed to fetch any integration catalog

What it means

Error "Failed to fetch any integration catalog" thrown in github/spec-kit.

Source

Thrown at src/specify_cli/integrations/catalog.py:293

                print(
                    f"Warning: Could not fetch catalog '{entry.name}': {exc}",
                    file=sys.stderr,
                )
                continue

            for integ_id, integ_data in data.get("integrations", {}).items():
                if not isinstance(integ_data, dict):
                    continue
                if integ_id not in merged:
                    merged[integ_id] = {
                        **integ_data,
                        "id": integ_id,
                        "_catalog_name": entry.name,
                        "_install_allowed": entry.install_allowed,
                    }

        if not any_success and active:
            raise IntegrationCatalogError(
                "Failed to fetch any integration catalog"
            )

        return list(merged.values())

    # -- Search / info ----------------------------------------------------

    def search(
        self,
        query: Optional[str] = None,
        tag: Optional[str] = None,
        author: Optional[str] = None,
    ) -> List[Dict[str, Any]]:
        """Search catalogs for integrations matching the given filters."""
        results: List[Dict[str, Any]] = []
        for item in self._get_merged_integrations():
            author_val = item.get("author", "")
            if not isinstance(author_val, str):

View on GitHub (pinned to bf88c9f9a8)

Solutions

  1. Verify at least one configured catalog URL is reachable and valid; fix URLs, network, or credentials, then retry.

When it happens

Trigger: Thrown at src/specify_cli/integrations/catalog.py:293 when the library encounters an invalid state.

Common situations: See trigger scenarios.


AI-assisted analysis of github/spec-kit@bf88c9f9a8 (2026-08-14). Data as JSON: /api/errors/097e4b53a5ac8f2c. Report an issue: GitHub.