Skip to content

Commit 6614dd0

Browse files
docs-botgithub-actions[bot]hubwriterCopilot
authored
docs: update copilot-cli content from source docs (#61360)
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: hubwriter <hubwriter@github.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
1 parent 542340d commit 6614dd0

4 files changed

Lines changed: 27 additions & 8 deletions

File tree

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

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -156,8 +156,10 @@ Sessions already open in another window float to the top in all non-relevance so
156156
| <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. |
157157
| <kbd>Ctrl</kbd>+<kbd>U</kbd> | Delete from cursor to beginning of the line. |
158158
| <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. |
161163
| <kbd>Alt</kbd>+<kbd>←</kbd>/<kbd>→</kbd> (Windows/Linux)<br><kbd>Option</kbd>+<kbd>←</kbd>/<kbd>→</kbd> (Mac) | Move the cursor by a word. |
162164
| <kbd>↑</kbd>/<kbd>↓</kbd> | Navigate the command history. |
163165
| <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
174176
| `/chronicle <standup\|tips\|improve\|reindex>` | Session history tools and insights. {% data reusables.copilot.experimental %} |
175177
| `/clear [PROMPT]`, `/new [PROMPT]`, `/reset [PROMPT]` | Start a new conversation. |
176178
| `/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). |
178182
| `/context` | Show the context window token usage and visualization. See [AUTOTITLE](/copilot/concepts/agents/copilot-cli/context-management#checking-your-context-usage). |
179183
| `/copy` | Copy the last response to the clipboard. |
180184
| `/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
183187
| `/downgrade <VERSION>` | Download and restart into a specific CLI version. Available for team accounts. |
184188
| `/env` | Show loaded environment details (instructions, MCP servers, skills, agents, plugins, LSPs, extensions). |
185189
| `/exit`, `/quit` | Exit the CLI. |
190+
| `/extensions [manage\|mode]`, `/extension` | Manage CLI extensions. |
186191
| `/experimental [on\|off\|show]` | Toggle, set, or show experimental features. |
187192
| `/feedback`, `/bug` | Provide feedback about the CLI. |
188193
| `/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
197202
| `/lsp [show\|test\|reload\|help] [SERVER-NAME]` | Manage the language server configuration. |
198203
| `/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). |
199204
| `/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. |
200206
| `/plan [PROMPT]` | Create an implementation plan before coding. |
201207
| `/plugin [marketplace\|install\|uninstall\|update\|list] [ARGS...]` | Manage plugins and plugin marketplaces. See [AUTOTITLE](/copilot/concepts/agents/copilot-cli/about-cli-plugins). |
202208
| `/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
207213
| `/restart` | Restart the CLI, preserving the current session. |
208214
| `/resume [SESSION-ID]`, `/continue [SESSION-ID]` | Switch to a different session by choosing from a list (optionally specify a session ID). |
209215
| `/review [PROMPT]` | Run the code review agent to analyze changes. See [AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli/agentic-code-review). |
216+
| `/sandbox [enable\|disable]` | Configure shell command sandboxing. |
210217
| `/search [QUERY]`, `/find [QUERY]` | Search the conversation timeline. {% data reusables.copilot.experimental %} |
211218
| `/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`. |
212219
| `/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. |
213220
| `/skills [list\|info\|add\|remove\|reload] [ARGS...]` | Manage skills for enhanced capabilities. See [AUTOTITLE](/copilot/how-tos/copilot-cli/customize-copilot/create-skills). |
214221
| `/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. |
215223
| `/tasks` | View and manage tasks (subagents and shell commands). |
216224
| `/terminal-setup` | Configure the terminal for multiline input support (<kbd>Shift</kbd>+<kbd>Enter</kbd> and <kbd>Ctrl</kbd>+<kbd>Enter</kbd>). |
217225
| `/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. |
218227
| `/undo`, `/rewind` | Rewind the last turn and revert file changes. |
219228
| `/update`, `/upgrade` | Update the CLI to the latest version. |
220229
| `/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
243252
| `--banner`, `--no-banner` | Show or hide the startup banner. |
244253
| `--bash-env` | Enable `BASH_ENV` support for bash shells. |
245254
| `--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 -->
246256
| `--continue` | Resume the most recent session in the current working directory, falling back to the globally most recent session. |
247257
| `--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. |
248258
| `--deny-url=URL ...` | Deny access to specific URLs or domains, takes precedence over `--allow-url`. For multiple URLs, use a quoted, comma-separated list. |

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

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,9 @@ You can use the following commands in the terminal to manage plugins for {% data
2525
| `copilot plugin install SPECIFICATION` | Install a plugin. See [Plugin specification for `install` command](#plugin-specification-for-install-command) below. |
2626
| `copilot plugin uninstall NAME` | Remove a plugin |
2727
| `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 |
2931
| `copilot plugin marketplace add SPECIFICATION` | Register a marketplace |
3032
| `copilot plugin marketplace list` | List registered marketplaces |
3133
| `copilot plugin marketplace browse NAME` | Browse marketplace plugins |
@@ -149,6 +151,7 @@ For more information, see [AUTOTITLE](/copilot/how-tos/copilot-cli/customize-cop
149151
| Hooks configuration | `hooks.json` or `hooks/hooks.json` |
150152
| MCP configuration | `.mcp.json`, `.github/mcp.json` |
151153
| 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. |
152155

153156
## Loading order and precedence
154157

content/copilot/reference/hooks-reference.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -88,19 +88,21 @@ Command hooks run shell scripts and are supported on all hook types.
8888
| Field | Type | Required | Description |
8989
|-------|------|----------|-------------|
9090
| `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. |
9292
| `cwd` | string | No | Working directory for the command (relative to repository root or absolute). |
9393
| `env` | object | No | Environment variables to set (supports variable expansion). |
9494
| `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. |
9596
| `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. |
9798

9899
### HTTP hooks
99100

100101
HTTP hooks send the input payload as a JSON `POST` to a URL.
101102

102103
> [!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.
104106
105107
```json
106108
{
@@ -123,6 +125,7 @@ HTTP hooks send the input payload as a JSON `POST` to a URL.
123125
|-------|------|----------|-------------|
124126
| `allowedEnvVars` | string[] | No | Environment variable names that may be expanded inside `headers` values. When set, `url` must use `https://`. |
125127
| `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. |
126129
| `timeoutSec` | number | No | Timeout in seconds. Default: `30`. |
127130
| `type` | `"http"` | Yes | Must be `"http"`. |
128131
| `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
382385

383386
### `subagentStart`
384387

388+
> [!NOTE]
389+
> The built-in `general-purpose` agent does not emit `subagentStart` or `subagentStop` events.
390+
385391
**Input:**
386392

387393
```typescript
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
cdbdb2fa932abc3687ab433aa87345d6f004ad85
1+
e7ee4ef1f3d09323d60d202f335cc24f94d71fa9

0 commit comments

Comments
 (0)