Skip to content

docs(integrations): document the 'integration list --catalog' flag#3530

Open
jawwad-ali wants to merge 1 commit into
github:mainfrom
jawwad-ali:docs/integration-list-catalog-flag
Open

docs(integrations): document the 'integration list --catalog' flag#3530
jawwad-ali wants to merge 1 commit into
github:mainfrom
jawwad-ali:docs/integration-list-catalog-flag

Conversation

@jawwad-ali

Copy link
Copy Markdown
Contributor

What

specify integration list accepts a --catalog flag:

@integration_app.command("list")
def integration_list(
    catalog: bool = typer.Option(False, "--catalog", help="Browse full catalog (built-in + community)"),
):

…but the List Available Integrations section of docs/reference/integrations.md documented no options, so the flag was undiscoverable from the docs (unlike integration search and integration catalog add, which both have option tables).

Fix

Add a one-row option table documenting --catalog, matching the style of the sibling command sections. Docs-only.

Verification

  • Flag confirmed present in src/specify_cli/integrations/_query_commands.py.
  • markdownlint-cli2 docs/reference/integrations.md → 0 errors; git diff --check clean.

🤖 Written with the assistance of Claude Code (AI). Gap self-found (flag present in code, absent from docs).

'specify integration list' accepts a --catalog flag (integrations/_query_commands.py:
typer.Option(False, "--catalog", ...)) that browses the full built-in +
community catalog, but the Integrations reference documented no options for the
list command. Add an option table for it, matching the style used by the sibling
'integration search' and 'integration catalog add' sections.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@jawwad-ali jawwad-ali requested a review from mnriem as a code owner July 14, 2026 18:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant