Skip to content

Commit 8ab82e3

Browse files
mnriemCopilot
andauthored
Update extensions/README.md
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
1 parent 74873d9 commit 8ab82e3

1 file changed

Lines changed: 8 additions & 8 deletions

File tree

extensions/README.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -8,18 +8,18 @@ Spec Kit provides two catalog files with different purposes:
88

99
### Your Catalog (`catalog.json`)
1010

11-
- **Purpose**: Your organization's curated catalog of approved extensions
12-
- **Default State**: Empty by design - you populate it with extensions you trust
13-
- **Location**: `extensions/catalog.json` in the spec-kit repo
14-
- **Usage**: The `specify extension` commands use this catalog by default
15-
- **Override**: Set `SPECKIT_CATALOG_URL` environment variable to use a different catalog
16-
- **Customization**: Copy extensions from the community catalog or add your own
11+
- **Purpose**: Default upstream catalog of extensions used by the Spec Kit CLI
12+
- **Default State**: Empty by design in the upstream project - you or your organization populate a fork/copy with extensions you trust
13+
- **Location (upstream)**: `extensions/catalog.json` in the GitHub-hosted spec-kit repo
14+
- **CLI Default**: The `specify extension` commands use the upstream catalog URL by default, unless overridden
15+
- **Org Catalog**: Point `SPECKIT_CATALOG_URL` at your organization's fork or hosted catalog JSON to use it instead of the upstream default
16+
- **Customization**: Copy entries from the community catalog into your org catalog, or add your own extensions directly
1717

1818
**Example override:**
1919
```bash
20-
# Point to your organization's catalog
20+
# Override the default upstream catalog with your organization's catalog
2121
export SPECKIT_CATALOG_URL="https://your-org.com/spec-kit/catalog.json"
22-
specify extension search # Now uses your custom catalog
22+
specify extension search # Now uses your organization's catalog instead of the upstream default
2323
```
2424

2525
### Community Reference Catalog (`catalog.community.json`)

0 commit comments

Comments
 (0)