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/cli-command-reference.md
+13-3Lines changed: 13 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -156,8 +156,10 @@ Sessions already open in another window float to the top in all non-relevance so
156
156
| <kbd>Ctrl</kbd>+<kbd>K</kbd> | Delete from cursor to end of the line. If the cursor is at the end of the line, delete the line break. |
157
157
| <kbd>Ctrl</kbd>+<kbd>U</kbd> | Delete from cursor to beginning of the line. |
158
158
| <kbd>Ctrl</kbd>+<kbd>W</kbd> | Delete the previous word. |
159
-
| <kbd>Home</kbd> | Move to the start of the text. |
160
-
| <kbd>End</kbd> | Move to the end of the text. |
159
+
| <kbd>Home</kbd> | Move to the start of the current visual line. |
160
+
| <kbd>End</kbd> | Move to the end of the current visual line. |
161
+
| <kbd>Ctrl</kbd>+<kbd>Home</kbd> | Move to the start of the text. |
162
+
| <kbd>Ctrl</kbd>+<kbd>End</kbd> | Move to the end of the text. |
161
163
| <kbd>Alt</kbd>+<kbd>←</kbd>/<kbd>→</kbd> (Windows/Linux)<br><kbd>Option</kbd>+<kbd>←</kbd>/<kbd>→</kbd> (Mac) | Move the cursor by a word. |
162
164
| <kbd>↑</kbd>/<kbd>↓</kbd> | Navigate the command history. |
163
165
| <kbd>Tab</kbd> / <kbd>Ctrl</kbd>+<kbd>Y</kbd> | Accept the current inline completion suggestion. |
@@ -174,7 +176,9 @@ Sessions already open in another window float to the top in all non-relevance so
174
176
|`/chronicle <standup\|tips\|improve\|reindex>`| Session history tools and insights. {% data reusables.copilot.experimental %} |
175
177
|`/clear [PROMPT]`, `/new [PROMPT]`, `/reset [PROMPT]`| Start a new conversation. |
176
178
|`/clikit [COMPONENT]`| Preview CLI business components (for example, quota info). |
177
-
|`/compact`| Summarize the conversation history to reduce context window usage. See [AUTOTITLE](/copilot/concepts/agents/copilot-cli/context-management#compaction). |
179
+
|`/collect-debug-logs [file\|gist] [PATH]`| Collect debug logs to an archive file or {% data variables.product.github %} gist. |
180
+
|`/diagnose [PROMPT]`| Analyze the current session log and optionally prompt the agent with a question about diagnostics. |
181
+
|`/compact [FOCUS-INSTRUCTIONS]`| Summarize the conversation history to reduce context window usage. Optionally provide focus instructions to steer the summary—for example, `/compact focus on the auth module`. See [AUTOTITLE](/copilot/concepts/agents/copilot-cli/context-management#compaction). |
178
182
|`/context`| Show the context window token usage and visualization. See [AUTOTITLE](/copilot/concepts/agents/copilot-cli/context-management#checking-your-context-usage). |
179
183
|`/copy`| Copy the last response to the clipboard. |
180
184
|`/cwd`, `/cd [PATH]`| Change the working directory or display the current directory. |
@@ -183,6 +187,7 @@ Sessions already open in another window float to the top in all non-relevance so
183
187
|`/downgrade <VERSION>`| Download and restart into a specific CLI version. Available for team accounts. |
|`/experimental [on\|off\|show]`| Toggle, set, or show experimental features. |
187
192
|`/feedback`, `/bug`| Provide feedback about the CLI. |
188
193
|`/fleet [PROMPT]`| Enable parallel subagent execution of parts of a task. See [AUTOTITLE](/copilot/concepts/agents/copilot-cli/fleet). |
@@ -197,6 +202,7 @@ Sessions already open in another window float to the top in all non-relevance so
197
202
|`/lsp [show\|test\|reload\|help] [SERVER-NAME]`| Manage the language server configuration. |
198
203
|`/mcp [show\|add\|edit\|delete\|disable\|enable\|auth\|reload] [SERVER-NAME]`| Manage the MCP server configuration. See [AUTOTITLE](/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers#managing-mcp-servers). |
199
204
|`/model`, `/models [MODEL]`| Select the AI model you want to use. |
205
+
|`/permissions [show\|reset]`| View or clear in-memory tool and path approvals for the current session. |
200
206
|`/plan [PROMPT]`| Create an implementation plan before coding. |
201
207
|`/plugin [marketplace\|install\|uninstall\|update\|list] [ARGS...]`| Manage plugins and plugin marketplaces. See [AUTOTITLE](/copilot/concepts/agents/copilot-cli/about-cli-plugins). |
202
208
|`/pr [view\|create\|fix\|auto]`| Manage pull requests for the current branch. See [AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli/manage-pull-requests). |
@@ -207,14 +213,17 @@ Sessions already open in another window float to the top in all non-relevance so
207
213
|`/restart`| Restart the CLI, preserving the current session. |
208
214
|`/resume [SESSION-ID]`, `/continue [SESSION-ID]`| Switch to a different session by choosing from a list (optionally specify a session ID). |
209
215
|`/review [PROMPT]`| Run the code review agent to analyze changes. See [AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli/agentic-code-review). |
|`/search [QUERY]`, `/find [QUERY]`| Search the conversation timeline. {% data reusables.copilot.experimental %} |
211
218
|`/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`. |
212
219
|`/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. |
213
220
|`/skills [list\|info\|add\|remove\|reload] [ARGS...]`| Manage skills for enhanced capabilities. See [AUTOTITLE](/copilot/how-tos/copilot-cli/customize-copilot/create-skills). |
214
221
|`/statusline`, `/footer`| Configure which items appear in the status line. |
222
+
|`/streamer-mode`, `/on-air`| Toggle streamer mode, which hides preview model names and quota details. Useful when demonstrating {% data variables.copilot.copilot_cli_short %} or screen sharing. |
215
223
|`/tasks`| View and manage tasks (subagents and shell commands). |
216
224
|`/terminal-setup`| Configure the terminal for multiline input support (<kbd>Shift</kbd>+<kbd>Enter</kbd> and <kbd>Ctrl</kbd>+<kbd>Enter</kbd>). |
217
225
|`/theme [default\|dim\|high-contrast\|colorblind]`| View or set the color mode. |
226
+
|`/tuikit [colors\|icons\|select\|tabbar]`| Preview TUIkit design-system components and color tokens. |
218
227
|`/undo`, `/rewind`| Rewind the last turn and revert file changes. |
219
228
|`/update`, `/upgrade`| Update the CLI to the latest version. |
220
229
|`/usage`| Display session usage metrics and statistics. |
@@ -243,6 +252,7 @@ For a complete list of available slash commands enter `/help` in the CLI's inter
243
252
|`--banner`, `--no-banner`| Show or hide the startup banner. |
244
253
|`--bash-env`| Enable `BASH_ENV` support for bash shells. |
245
254
|`--connect[=SESSION-ID]`| Connect directly to a remote session (optionally specify a session ID or task ID). Conflicts with `--resume` and `--continue`. |
255
+
| `--config-dir=DIRECTORY` | This option for setting the configuration directory is deprecated. Use the `COPILOT_HOME` environment variable instead. | <!-- markdownlint-disable-line GHD046 -->
246
256
|`--continue`| Resume the most recent session in the current working directory, falling back to the globally most recent session. |
247
257
|`--deny-tool=TOOL ...`| Tools the CLI does not have permission to use. Will not prompt for permission. For multiple tools, use a quoted, comma-separated list. |
248
258
|`--deny-url=URL ...`| Deny access to specific URLs or domains, takes precedence over `--allow-url`. For multiple URLs, use a quoted, comma-separated list. |
Copy file name to clipboardExpand all lines: content/copilot/reference/copilot-cli-reference/cli-plugin-reference.md
+4-1Lines changed: 4 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -25,7 +25,9 @@ You can use the following commands in the terminal to manage plugins for {% data
25
25
|`copilot plugin install SPECIFICATION`| Install a plugin. See [Plugin specification for `install` command](#plugin-specification-for-install-command) below. |
26
26
|`copilot plugin uninstall NAME`| Remove a plugin |
27
27
|`copilot plugin list`| List installed plugins |
28
-
|`copilot plugin update NAME`| Update a plugin |
28
+
|`copilot plugin update NAME`| Update a named plugin. Use `--all` to update all installed plugins at once. |
29
+
|`copilot plugin enable NAME`| Enable a previously disabled plugin |
30
+
|`copilot plugin disable NAME`| Disable a plugin without uninstalling it |
29
31
|`copilot plugin marketplace add SPECIFICATION`| Register a marketplace |
30
32
|`copilot plugin marketplace list`| List registered marketplaces |
| LSP configuration |`lsp.json` or `.github/lsp.json`|
154
+
| Plugin data |`${COPILOT_PLUGIN_DATA}` (also available as `${CLAUDE_PLUGIN_DATA}`). Points to a persistent, writable directory unique to each installed plugin. Use this for plugin-specific runtime data instead of paths inside the installed-plugins cache directory. |
Copy file name to clipboardExpand all lines: content/copilot/reference/hooks-reference.md
+9-3Lines changed: 9 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -88,19 +88,21 @@ Command hooks run shell scripts and are supported on all hook types.
88
88
| Field | Type | Required | Description |
89
89
|-------|------|----------|-------------|
90
90
|`bash`| string | One of `bash`, `powershell`, or `command`| Shell command for Unix. |
91
-
|`command`| string | One of `bash`, `powershell`, or `command`| Cross-platform fallback used when neither `bash`nor`powershell`is set for the current platform. |
91
+
|`command`| string | One of `bash`, `powershell`, or `command`| Cross-platform fallback. Copied to both `bash` and `powershell`when those fields are absent; explicit `bash`or`powershell`entries take precedence on their respective platforms. |
92
92
|`cwd`| string | No | Working directory for the command (relative to repository root or absolute). |
93
93
|`env`| object | No | Environment variables to set (supports variable expansion). |
94
94
|`powershell`| string | One of `bash`, `powershell`, or `command`| Shell command for Windows. |
95
+
|`timeout`| number | No | Alias for `timeoutSec`, in seconds. Used only when `timeoutSec` is absent; `timeoutSec` takes precedence when both are present. |
95
96
|`timeoutSec`| number | No | Timeout in seconds. Default: `30`. |
96
-
|`type`|`"command"`|Yes|Must be `"command"`. |
97
+
|`type`|`"command"`|No|Hook type. Defaults to `"command"` when omitted. |
97
98
98
99
### HTTP hooks
99
100
100
101
HTTP hooks send the input payload as a JSON `POST` to a URL.
101
102
102
103
> [!NOTE]
103
-
> **Cloud agent only.** Outbound network from the sandbox is restricted by the cloud agent firewall, so `url` must target an allow-listed host.
104
+
> * By default, only `https://` URLs are allowed. Non-TLS `http://` requests are rejected, except for `http://localhost`, `http://127.*`, and `http://[::1]` when `COPILOT_HOOK_ALLOW_LOCALHOST=1` is set.
105
+
> ***Cloud agent only.** Outbound network from the sandbox is restricted by the cloud agent firewall, so `url` must target an allow-listed host.
104
106
105
107
```json
106
108
{
@@ -123,6 +125,7 @@ HTTP hooks send the input payload as a JSON `POST` to a URL.
123
125
|-------|------|----------|-------------|
124
126
|`allowedEnvVars`| string[]| No | Environment variable names that may be expanded inside `headers` values. When set, `url` must use `https://`. |
125
127
|`headers`| object | No | Request headers to include. |
128
+
|`timeout`| number | No | Alias for `timeoutSec`, in seconds. Used only when `timeoutSec` is absent; `timeoutSec` takes precedence when both are present. |
126
129
|`timeoutSec`| number | No | Timeout in seconds. Default: `30`. |
127
130
|`type`|`"http"`| Yes | Must be `"http"`. |
128
131
|`url`| string | Yes | Target URL. Must use `http:` or `https:`. For `preToolUse` and `permissionRequest`, must use `https://` because the response can grant tool permissions. |
@@ -382,6 +385,9 @@ When configured with the PascalCase event name `PreToolUse`, the payload uses sn
382
385
383
386
### `subagentStart`
384
387
388
+
> [!NOTE]
389
+
> The built-in `general-purpose` agent does not emit `subagentStart` or `subagentStop` events.
0 commit comments