From 1b5741ee3e0e0e092e36ffdff130623ed169b51e Mon Sep 17 00:00:00 2001 From: Dyan Galih Date: Fri, 26 Jun 2026 01:57:15 +0000 Subject: [PATCH 1/2] docs: document missing flags and integrations --- docs/reference/extensions.md | 1 + docs/reference/integrations.md | 2 ++ 2 files changed, 3 insertions(+) diff --git a/docs/reference/extensions.md b/docs/reference/extensions.md index 90e5ab8747..fe5f8d263b 100644 --- a/docs/reference/extensions.md +++ b/docs/reference/extensions.md @@ -25,6 +25,7 @@ specify extension add | Option | Description | | --------------- | -------------------------------------------------------- | | `--dev` | Install from a local directory (for development) | +| `--force` | Overwrite if the extension is already installed | | `--from ` | Install from a custom URL instead of the catalog | | `--force` | Overwrite if already installed | | `--priority `| Resolution priority (default: 10; lower = higher precedence) | diff --git a/docs/reference/integrations.md b/docs/reference/integrations.md index 3c48c5a486..bed190ed02 100644 --- a/docs/reference/integrations.md +++ b/docs/reference/integrations.md @@ -147,6 +147,7 @@ specify integration upgrade [] | `--force` | Overwrite files even if they have been modified | | `--script sh\|ps` | Script type: `sh` (bash/zsh) or `ps` (PowerShell) | | `--integration-options` | Options for the integration | +| `--refresh-shared-infra` | Also refresh shared infrastructure files | Reinstalls an installed integration with updated templates and commands (e.g., after upgrading Spec Kit). Defaults to the default integration; if a key is provided, it must be one of the installed integrations. Detects locally modified files and blocks the upgrade unless `--force` is used. Stale files from the previous install that are no longer needed are removed automatically. Shared templates stay aligned with the default integration even when upgrading a non-default integration. @@ -271,6 +272,7 @@ The currently declared multi-install safe integrations are: | `shai` | `.shai/commands`, `SHAI.md` | | `tabnine` | `.tabnine/agent/commands`, `TABNINE.md` | | `trae` | `.trae/skills`, `.trae/rules/project_rules.md` | +| `windsurf` | `.windsurf/workflows`, `.windsurf/rules/specify-rules.md` | | `zcode` | `.zcode/skills`, `ZCODE.md` | Integrations that share a context file or command directory with another integration, require dynamic install paths such as `--commands-dir`, or merge shared tool settings are not declared safe by default. They can still be installed alongside another integration with `--force`. From b53524d5ac6348bc1a7cf824255b7d6609a0bdb9 Mon Sep 17 00:00:00 2001 From: Dyan Galih Date: Tue, 30 Jun 2026 14:15:21 +0000 Subject: [PATCH 2/2] docs: remove invalid --refresh-shared-infra from upgrade command --- docs/reference/integrations.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/reference/integrations.md b/docs/reference/integrations.md index bed190ed02..da2151fad3 100644 --- a/docs/reference/integrations.md +++ b/docs/reference/integrations.md @@ -147,7 +147,6 @@ specify integration upgrade [] | `--force` | Overwrite files even if they have been modified | | `--script sh\|ps` | Script type: `sh` (bash/zsh) or `ps` (PowerShell) | | `--integration-options` | Options for the integration | -| `--refresh-shared-infra` | Also refresh shared infrastructure files | Reinstalls an installed integration with updated templates and commands (e.g., after upgrading Spec Kit). Defaults to the default integration; if a key is provided, it must be one of the installed integrations. Detects locally modified files and blocks the upgrade unless `--force` is used. Stale files from the previous install that are no longer needed are removed automatically. Shared templates stay aligned with the default integration even when upgrading a non-default integration.