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
+3-5Lines changed: 3 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -74,7 +74,7 @@ redirect_from:
74
74
|`/add-dir PATH`| Add a directory to the allowed list for file access. |
75
75
|`/agent`| Browse and select from available agents (if any). |
76
76
|`/allow-all`, `/yolo`| Enable all permissions (tools, paths, and URLs). |
77
-
|`/clear`, `/new`| Clear the conversation history. |
77
+
|`/clear [PROMPT]`, `/new [PROMPT]`| Start a new conversation. |
78
78
|`/compact`| Summarize the conversation history to reduce context window usage. |
79
79
|`/context`| Show the context window token usage and visualization. |
80
80
|`/cwd`, `/cd [PATH]`| Change the working directory or display the current directory. |
@@ -125,7 +125,6 @@ For a complete list of available slash commands enter `/help` in the CLI's inter
125
125
|`--allow-all-urls`| Allow access to all URLs without confirmation. |
126
126
|`--allow-tool=TOOL ...`| Tools the CLI has permission to use. Will not prompt for permission. For multiple tools, use a quoted, comma-separated list. |
127
127
|`--allow-url=URL ...`| Allow access to specific URLs or domains. For multiple URLs, use a quoted, comma-separated list. |
128
-
|`--alt-screen=VALUE`| Use the terminal alternate screen buffer (`on` or `off`). |
129
128
|`--autopilot`| Enable autopilot continuation in prompt mode. See [AUTOTITLE](/copilot/concepts/agents/copilot-cli/autopilot). |
130
129
|`--available-tools=TOOL ...`| Only these tools will be available to the model. For multiple tools, use a quoted, comma-separated list. |
131
130
|`--banner`| Show the startup banner. |
@@ -147,7 +146,6 @@ For a complete list of available slash commands enter `/help` in the CLI's inter
147
146
|`--log-level=LEVEL`| Set the log level (choices: `none`, `error`, `warning`, `info`, `debug`, `all`, `default`). |
148
147
|`--max-autopilot-continues=COUNT`| Maximum number of continuation messages in autopilot mode (default: unlimited). See [AUTOTITLE](/copilot/concepts/agents/copilot-cli/autopilot). |
149
148
|`--model=MODEL`| Set the AI model you want to use. |
150
-
|`--no-alt-screen`| Disable the terminal alternate screen buffer. |
151
149
|`--no-ask-user`| Disable the `ask_user` tool (the agent works autonomously without asking questions). |
|`bash_env`|`boolean`|`false`| Enable `BASH_ENV` support for bash shells. |
@@ -400,6 +397,8 @@ Prompt hooks auto-submit text as if the user typed it. They are only supported o
400
397
|`postToolUse`| After each tool completes. | No |
401
398
|`agentStop`| The main agent finishes a turn. | Yes — can block and force continuation. |
402
399
|`subagentStop`| A subagent completes. | Yes — can block and force continuation. |
400
+
|`subagentStart`| A subagent is spawned (before it runs). Returns `additionalContext` prepended to the subagent's prompt. Supports `matcher` to filter by agent name. | No — cannot block creation. |
401
+
|`preCompact`| Context compaction is about to begin (manual or automatic). Supports `matcher` to filter by trigger (`"manual"` or `"auto"`). | No — notification only. |
403
402
|`errorOccurred`| An error occurs during execution. | No |
404
403
405
404
### `preToolUse` decision control
@@ -536,7 +535,6 @@ Skills are loaded from these locations in priority order (first found wins for d
536
535
|`~/.copilot/skills/`| Personal | Personal skills for all projects. |
537
536
|`~/.agents/skills/`| Personal | Agent skills shared across all projects. |
538
537
|`~/.claude/skills/`| Personal | Claude-compatible personal location. |
539
-
|`~/.agents/skills/`| Personal | Alternative personal location. |
|`render_markdown`| boolean | Render markdown in responses (default: `true`) |
@@ -70,7 +69,7 @@ Common settings include:
70
69
For a full list of configuration settings, enter `copilot help config` in your terminal.
71
70
72
71
> [!TIP]
73
-
> Some settings can also be set using command-line flags. For example, `--alt-screen` and `--no-alt-screen` set the`alt_screen` value and persist it to `config.json`. The`/model` slash command writes your model selection to this file so it persists across sessions.
72
+
> Some settings can also be set using command-line flags. For example, the `/model` slash command writes your model selection to this file so it persists across sessions.
0 commit comments