Skip to content

Commit 916e29b

Browse files
authored
Docs: document missing flags --force and --refresh-shared-infra (#3179)
* Docs: document missing flags --force and --refresh-shared-infra Fixes #3177 * Address review: Reorder flags to match CLI help output
1 parent c49966d commit 916e29b

2 files changed

Lines changed: 2 additions & 0 deletions

File tree

docs/reference/extensions.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,7 @@ specify extension add <name>
2626
| --------------- | -------------------------------------------------------- |
2727
| `--dev` | Install from a local directory (for development) |
2828
| `--from <url>` | Install from a custom URL instead of the catalog |
29+
| `--force` | Overwrite if already installed |
2930
| `--priority <N>`| Resolution priority (default: 10; lower = higher precedence) |
3031

3132
Installs an extension from the catalog, a URL, or a local directory. Extension commands are automatically registered with the currently installed AI coding agent integration.

docs/reference/integrations.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -100,6 +100,7 @@ specify integration switch <key>
100100
| ------------------------ | ------------------------------------------------------------------------ |
101101
| `--script sh\|ps` | Script type: `sh` (bash/zsh) or `ps` (PowerShell) |
102102
| `--force` | Force removal of modified files during uninstall; when the target is already installed, overwrite managed shared templates while changing the default |
103+
| `--refresh-shared-infra` | Also overwrite shared infrastructure files even if you customized them (otherwise customizations are preserved) |
103104
| `--integration-options` | Options for the target integration when it is not already installed |
104105

105106
If the target integration is not already installed, equivalent to running `uninstall` followed by `install` in a single step. In this mode, `--force` controls whether modified files from the removed integration are deleted. If the target integration is already installed, `switch` only changes the default integration, like `use`; in this mode, `--force` controls whether managed shared templates are overwritten while the default changes. `--integration-options` is rejected for already-installed targets because changing integration options requires reinstalling managed files; run `upgrade <key> --integration-options ...` first, then `use <key>`.

0 commit comments

Comments
 (0)