Skip to content

Commit 6df77cb

Browse files
docs-botgithub-actions[bot]saritai
authored
docs: update copilot-cli content from source docs (#60794)
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: Sarita Iyer <66540150+saritai@users.noreply.github.com>
1 parent 9ead030 commit 6df77cb

File tree

2 files changed

+39
-2
lines changed

2 files changed

+39
-2
lines changed

content/copilot/reference/copilot-cli-reference/cli-command-reference.md

Lines changed: 38 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -317,6 +317,7 @@ Settings cascade from user to repository to local, with more specific scopes ove
317317
| `compactPaste` | `boolean` | `true` | Collapse large pastes into compact tokens. |
318318
| `custom_agents.default_local_only` | `boolean` | `false` | Only use local custom agents. |
319319
| `denied_urls` | `string[]` | `[]` | URLs or domains blocked (takes precedence over `allowed_urls`). |
320+
| `enabledFeatureFlags` | `object` || Enable or disable individual feature flags. Keys are flag names; values are `true` (enable) or `false` (explicitly disable). Takes precedence over the legacy `feature_flags.enabled` array format. See [Feature flag reference](#feature-flag-reference). |
320321
| `experimental` | `boolean` | `false` | Enable experimental features. |
321322
| `includeCoAuthoredBy` | `boolean` | `true` | Add a `Co-authored-by` trailer to git commits made by the agent. |
322323
| `companyAnnouncements` | `string[]` | `[]` | Custom messages shown randomly on startup. |
@@ -969,6 +970,26 @@ MCP servers are loaded from multiple sources, each with a different trust level.
969970

970971
All MCP tool invocations require explicit permission. This applies even to read-only operations on external services.
971972

973+
### Migrating from `.vscode/mcp.json`
974+
975+
If your project uses `.vscode/mcp.json` (VS Code's MCP configuration format), migrate to `.mcp.json` for {% data variables.copilot.copilot_cli %}. The migration remaps the `servers` key to `mcpServers`.
976+
977+
**POSIX shells (bash, zsh, fish, and others):**
978+
979+
```shell
980+
jq '{mcpServers: .servers}' .vscode/mcp.json > .mcp.json
981+
```
982+
983+
Requires [`jq`](https://jqlang.github.io/jq/).
984+
985+
**PowerShell:**
986+
987+
```powershell
988+
pwsh -NoProfile -Command "`$json = Get-Content '.vscode/mcp.json' -Raw | ConvertFrom-Json; `$content = ([pscustomobject]@{ mcpServers = `$json.servers } | ConvertTo-Json -Depth 100); [System.IO.File]::WriteAllText('.mcp.json', `$content, (New-Object System.Text.UTF8Encoding `$false))"
989+
```
990+
991+
On Windows, replace `pwsh` with `powershell` if you are using Windows PowerShell instead of PowerShell Core.
992+
972993
## Skills reference
973994

974995
Skills are Markdown files that extend what the CLI can do. Each skill lives in its own directory containing a `SKILL.md` file. When invoked (via `/SKILL-NAME` or automatically by the agent), the skill's content is injected into the conversation.
@@ -1239,7 +1260,23 @@ When content capture is enabled, the following attributes are populated.
12391260

12401261
## Feature flag reference
12411262

1242-
Feature flags enable functionality that is not yet generally available. Enable flags via the `COPILOT_CLI_ENABLED_FEATURE_FLAGS` environment variable (comma-separated list) or by using the `/experimental` slash command.
1263+
Feature flags enable functionality that is not yet generally available. You can enable or disable individual flags in three ways:
1264+
1265+
* **Environment variable**: Set `COPILOT_CLI_ENABLED_FEATURE_FLAGS` to a comma-separated list of flag names (for example, `"SOME_FEATURE,SOME_OTHER_FEATURE"`).
1266+
* **Slash command**: Use `/experimental on` in an interactive session to enable all experimental-tier flags.
1267+
* **Configuration file**: Add an `enabledFeatureFlags` object to `~/.copilot/config.json`. Set a flag to `true` to enable it or `false` to explicitly disable a flag that would otherwise be enabled by your tier.
1268+
1269+
```json
1270+
{
1271+
"enabledFeatureFlags": {
1272+
"SOME_FEATURE": true,
1273+
"SOME_OTHER_FEATURE": false
1274+
}
1275+
}
1276+
```
1277+
1278+
> [!NOTE]
1279+
> The legacy `feature_flags.enabled` array format is still supported as a fallback, but `enabledFeatureFlags` takes precedence when both are present.
12431280
12441281
| Flag | Tier | Description |
12451282
|------|------|-------------|
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
3aa5cd78f969f848b3607863b5f73ba722a3f489
1+
584832db507d47454ed410791e2d0c53468bea20

0 commit comments

Comments
 (0)