From a5d8e2ed956d8f33e8ce24dab8e85efb5512fd97 Mon Sep 17 00:00:00 2001 From: dhilipkumars Date: Tue, 10 Mar 2026 17:31:49 -0400 Subject: [PATCH 1/3] docs: add catalog cli help documentation (#1793) --- extensions/EXTENSION-USER-GUIDE.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/extensions/EXTENSION-USER-GUIDE.md b/extensions/EXTENSION-USER-GUIDE.md index e551809ef..9c2284dfe 100644 --- a/extensions/EXTENSION-USER-GUIDE.md +++ b/extensions/EXTENSION-USER-GUIDE.md @@ -432,6 +432,27 @@ Spec Kit uses a **catalog stack** — an ordered list of catalogs searched simul specify extension catalog list ``` +### Managing Catalogs via CLI + +You can view the main catalog management commands using `--help`: + +```bash +specify extension catalog --help + + Usage: specify extension catalog [OPTIONS] COMMAND [ARGS]... + + Manage extension catalogs + +╭─ Options ────────────────────────────────────────────────────────────────────────╮ +│ --help Show this message and exit. │ +╰──────────────────────────────────────────────────────────────────────────────────╯ +╭─ Commands ───────────────────────────────────────────────────────────────────────╮ +│ list List all active extension catalogs. │ +│ add Add a catalog to .specify/extension-catalogs.yml. │ +│ remove Remove a catalog from .specify/extension-catalogs.yml. │ +╰──────────────────────────────────────────────────────────────────────────────────╯ +``` + ### Adding a Catalog (Project-scoped) ```bash From 0be1220a50e8cc4bfdfc1cefbe828543fc674e80 Mon Sep 17 00:00:00 2001 From: Dhilip Date: Tue, 10 Mar 2026 17:51:13 -0400 Subject: [PATCH 2/3] Fix code block formatting in user guide Corrected code block syntax for CLI commands in user guide. --- extensions/EXTENSION-USER-GUIDE.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/extensions/EXTENSION-USER-GUIDE.md b/extensions/EXTENSION-USER-GUIDE.md index 9c2284dfe..6fefdf809 100644 --- a/extensions/EXTENSION-USER-GUIDE.md +++ b/extensions/EXTENSION-USER-GUIDE.md @@ -436,7 +436,7 @@ specify extension catalog list You can view the main catalog management commands using `--help`: -```bash +```text specify extension catalog --help Usage: specify extension catalog [OPTIONS] COMMAND [ARGS]... From c350a278c8c891c4c9311aba27b7f64ae3d0d4a8 Mon Sep 17 00:00:00 2001 From: Dhilip Date: Tue, 10 Mar 2026 17:51:56 -0400 Subject: [PATCH 3/3] Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- extensions/EXTENSION-USER-GUIDE.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/extensions/EXTENSION-USER-GUIDE.md b/extensions/EXTENSION-USER-GUIDE.md index 6fefdf809..ae77860fe 100644 --- a/extensions/EXTENSION-USER-GUIDE.md +++ b/extensions/EXTENSION-USER-GUIDE.md @@ -439,10 +439,9 @@ You can view the main catalog management commands using `--help`: ```text specify extension catalog --help - Usage: specify extension catalog [OPTIONS] COMMAND [ARGS]... - - Manage extension catalogs - + Usage: specify extension catalog [OPTIONS] COMMAND [ARGS]... + + Manage extension catalogs ╭─ Options ────────────────────────────────────────────────────────────────────────╮ │ --help Show this message and exit. │ ╰──────────────────────────────────────────────────────────────────────────────────╯