You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/copilot/reference/copilot-cli-reference/acp-server.md
+3Lines changed: 3 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -32,6 +32,9 @@ The Agent Client Protocol (ACP) is a protocol that standardizes communication be
32
32
33
33
{% data variables.copilot.copilot_cli %} can be started as an ACP server using the `--acp` flag. The server supports two modes, `stdio` and `TCP`.
34
34
35
+
> [!NOTE]
36
+
> When running in ACP mode, the tool-filtering flags (`--available-tools`, `--excluded-tools`) and the reasoning flag (`--effort`, `--reasoning-effort`) are applied to each session started by the ACP client.
37
+
35
38
### stdio mode (recommended for IDE integration)
36
39
37
40
By default, when providing the `--acp` flag, `stdio` mode will be inferred. The `--stdio` flag can also be provided for disambiguation.
|`copilot`| Launch the interactive user interface. |
22
22
|`copilot completion SHELL`| Print a shell script for the chosen shell that can be used to enable tab completion for {% data variables.copilot.copilot_cli_short %}. Supported shells: `bash`, `zsh`, `fish`. See [Using `copilot completion`](#using-copilot-completion). |
23
-
|`copilot help [TOPIC]`| Display help information. Help topics include: `config`, `commands`, `environment`, `logging`, `monitoring`, `permissions`, and `providers`. |
23
+
|`copilot help [TOPIC]`| Display help information. Help topics include: `billing`, `config`, `commands`, `environment`, `logging`, `monitoring`, `permissions`, and `providers`. |
24
24
|`copilot init`| Initialize {% data variables.product.prodname_copilot_short %} custom instructions for this repository. |
25
25
|`copilot login`| Authenticate with {% data variables.product.prodname_copilot_short %} via the OAuth device flow. Accepts `--host HOST` to specify the {% data variables.product.github %} host URL (default: `https://github.com`). |
26
26
|`copilot login`[OPTION]| Authenticate with {% data variables.product.prodname_copilot_short %} via the OAuth device flow. See [`copilot login` options](#copilot-login-options). |
@@ -241,7 +241,7 @@ Holding <kbd>↑</kbd> or <kbd>↓</kbd> accelerates scrolling after the first 1
241
241
|`/rubber-duck [PROMPT]`| Consult the rubber duck agent for a second opinion on plans, code, and tests. See [AUTOTITLE](/copilot/concepts/agents/copilot-cli/rubber-duck). |
|`/search [QUERY]`, `/find [QUERY]`| Search the conversation timeline. {% data reusables.copilot.experimental %} |
244
-
|`/session [info\|checkpoints [n]\|files\|plan\|rename [NAME]\|cleanup\|prune\|delete [ID]\|delete-all]`, `/sessions [info\|checkpoints [n]\|files\|plan\|rename [NAME]\|cleanup\|prune\|delete [ID]\|delete-all]`| Show session information and manage sessions. Subcommands: `info`, `checkpoints`, `files`, `plan`, `rename`, `cleanup`, `prune`, `delete`, `delete-all`. |
244
+
|`/session [info\|checkpoints [n]\|files\|plan\|rename [NAME]\|cleanup\|prune\|delete [ID]\|delete-all]`, `/sessions [info\|checkpoints [n]\|files\|plan\|rename [NAME]\|cleanup\|prune\|delete [ID]\|delete-all]`| Show session information and manage sessions. The `info` subcommand shows session details including the session link (when available). Subcommands: `info`, `checkpoints`, `files`, `plan`, `rename`, `cleanup`, `prune`, `delete`, `delete-all`. |
245
245
|`/share [file\|html\|gist] [session\|research] [PATH]`, `/export [file\|html\|gist] [session\|research] [PATH]`| Share the session to a Markdown file, interactive HTML file, or {% data variables.product.github %} gist. |
246
246
|`/skills [list\|info\|add\|remove\|reload] [ARGS...]`| Manage skills for enhanced capabilities. See [AUTOTITLE](/copilot/how-tos/copilot-cli/customize-copilot/create-skills). |
247
247
|`/statusline`, `/footer`| Configure which items appear in the status line. |
@@ -312,7 +312,7 @@ For a complete list of available slash commands enter `/help` in the CLI's inter
312
312
|`--plain-diff`| Disable rich diff rendering (syntax highlighting via the diff tool specified by your git config). |
313
313
|`--plugin-dir=DIRECTORY`| Load a plugin from a local directory (can be used multiple times). |
314
314
|`--remote`| Enable remote access to this session from {% data variables.product.prodname_dotcom_the_website %} and {% data variables.product.prodname_mobile %}. See [AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli/steer-remotely). |
315
-
|`--resume[=VALUE]`| Resume a previous interactive session by choosing from a list. Optionally specify a session ID, ID prefix, or session name. Name matching is exact and case-insensitive; falls back to the auto-generated summary when no explicit name matches. |
315
+
|`-r`, `--resume[=VALUE]`| Resume a previous interactive session by choosing from a list. Optionally specify a session ID, ID prefix, or session name. Name matching is exact and case-insensitive; falls back to the auto-generated summary when no explicit name matches. |
316
316
|`-s`, `--silent`| Output only the agent response (without usage statistics), useful for scripting with `-p`. |
|`--secret-env-vars=VAR ...`| Redact an environment variable from shell and MCP server environments (can be used multiple times). For multiple variables, use a quoted, comma-separated list. The values in the `GITHUB_TOKEN` and `COPILOT_GITHUB_TOKEN` environment variables are redacted from output by default. |
@@ -329,6 +329,24 @@ For a complete list of commands and options, run `copilot help`.
329
329
330
330
You can use `--remote` with `--resume <TASK-ID>` to resume a remote task locally. This works even when the task was originally created outside a Git repository.
331
331
332
+
> [!NOTE]
333
+
> When `permissions.disableBypassPermissionsMode` is set to `"disable"` in your settings, all allow-all flags (`--allow-all-tools`, `--allow-all-paths`, `--allow-all-urls`, `--allow-all`, `--yolo`) are suppressed at startup and cannot be used to grant elevated permissions.
334
+
335
+
## Supported models
336
+
337
+
Use `--model=MODEL` or the `COPILOT_MODEL` environment variable to select the AI model. Pass `auto` to let {% data variables.product.prodname_copilot_short %} pick the best available model automatically.
|`gemini-3.1-pro-preview`| Google Gemini reasoning |
346
+
|`gemini-3.5-flash`| Fast Google Gemini responses |
347
+
348
+
You can also switch models during an interactive session using the `/model` slash command.
349
+
332
350
## Tool availability values
333
351
334
352
The `--available-tools` and `--excluded-tools` options support these values:
@@ -408,6 +426,7 @@ copilot --allow-tool='MyMCP'
408
426
|`COPILOT_CACHE_HOME`| Override the cache directory (used for marketplace caches, auto-update packages, and other ephemeral data). See [AUTOTITLE](/copilot/reference/copilot-cli-reference/cli-config-dir-reference#changing-the-location-of-the-configuration-directory) for platform defaults. |
409
427
|`COPILOT_CUSTOM_INSTRUCTIONS_DIRS`| Comma-separated list of additional directories for custom instructions. |
410
428
|`COPILOT_EDITOR`| Editor command for interactive editing (checked after `$VISUAL` and `$EDITOR`). Defaults to `vi` if none are set. |
429
+
|`COPILOT_ENABLE_HTTP2`| Set to `1` or `true` to opt into HTTP/2 transport. HTTP/1.1 is the default. |
411
430
|`COPILOT_GH_HOST`|{% data variables.product.github %} hostname for {% data variables.copilot.copilot_cli_short %} only, overriding `GH_HOST`. Use when `GH_HOST` targets {% data variables.product.prodname_ghe_server %} but {% data variables.product.prodname_copilot_short %} needs to authenticate against {% data variables.product.prodname_dotcom_the_website %} or a {% data variables.product.prodname_ghe_cloud %} hostname. |
412
431
|`COPILOT_GITHUB_TOKEN`| Authentication token. Takes precedence over `GH_TOKEN` and `GITHUB_TOKEN`. |
413
432
|`COPILOT_HOME`| Override the configuration and state directory. Default: `$HOME/.copilot`. |
Copy file name to clipboardExpand all lines: content/copilot/reference/copilot-cli-reference/cli-config-dir-reference.md
+1Lines changed: 1 addition & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -241,6 +241,7 @@ These settings apply across all your sessions and repositories. You can edit thi
241
241
|`mergeStrategy`|`"rebase"`\|`"merge"`| — | Conflict resolution strategy for `/pr fix conflicts`. When set to `"rebase"`, conflicts are resolved by rebasing onto the base branch. When set to `"merge"`, the base branch is merged into the feature branch. If not configured, a picker dialog is shown. |
242
242
|`model`|`string`| varies | AI model to use. Set to `"auto"` to let {% data variables.product.prodname_copilot_short %} pick the best available model automatically. Managed by the `/model` slash command. |
243
243
|`mouse`|`boolean`|`true`| Enable mouse support in alt screen mode. Can also be set with `--mouse` or `--no-mouse`. |
244
+
|`permissions.disableBypassPermissionsMode`|`string`| — | When set to `"disable"`, all allow-all flags (`--allow-all-tools`, `--allow-all-paths`, `--allow-all-urls`, `--allow-all`, `--yolo`) are suppressed at startup and cannot be used to grant elevated permissions. |
244
245
|`powershellFlags`|`string[]`|`["-NoProfile", "-NoLogo"]`| Flags passed to PowerShell on startup. On Windows, the CLI prefers PowerShell 7+ (`pwsh`) and falls back to Windows PowerShell (`powershell.exe`) when `pwsh` is unavailable. Windows only. |
245
246
|`remote`|`"on"`\|`"off"`|`"on"`| Controls session syncing and remote access. Set to `"off"` to keep session data local only and disable remote control. Can also be set with `--remote` or `--no-remote`. |
246
247
|`renderMarkdown`|`boolean`|`true`| Render Markdown in terminal output. |
0 commit comments