Skip to main content

GitHub Copilot CLI command reference

Find commands and keyboard shortcuts to help you use Copilot CLI effectively.

Command-line commands

CommandPurpose
copilotLaunch the interactive user interface.
copilot help [topic]Display help information. Help topics include: config, commands, environment, logging, and permissions.
copilot initInitialize Copilot custom instructions for this repository.
copilot updateDownload and install the latest version.
copilot versionDisplay version information and check for updates.
copilot loginAuthenticate with Copilot via the OAuth device flow. Accepts --host HOST to specify the GitHub host URL (default: https://github.com).
copilot logoutSign out of GitHub and remove stored credentials.
copilot pluginManage plugins and plugin marketplaces.

Global shortcuts in the interactive interface

ShortcutPurpose
@ FILENAMEInclude file contents in the context.
Ctrl+X then /After you have started typing a prompt, this allows you to run a slash command—for example, if you want to change the model without having to retype your prompt.
EscCancel the current operation.
! COMMANDExecute a command in your local shell, bypassing Copilot.
Ctrl+CCancel operation / clear input. Press twice to exit.
Ctrl+DShutdown.
Ctrl+LClear the screen.
Shift+TabCycle between standard, plan, and autopilot mode.

Timeline shortcuts in the interactive interface

ShortcutPurpose
ctrl+oWhile there is nothing in the prompt input, this expands recent items in Copilot's response timeline to show more details.
ctrl+eWhile there is nothing in the prompt input, this expands all items in Copilot's response timeline.
ctrl+tExpand/collapse display of reasoning in responses.
ShortcutPurpose
Ctrl+AMove to beginning of the line (when typing).
Ctrl+BMove to the previous character.
Ctrl+EMove to end of the line (when typing).
Ctrl+FMove to the next character.
Ctrl+GEdit the prompt in an external editor.
Ctrl+HDelete the previous character.
Ctrl+KDelete from cursor to end of the line.
Ctrl+UDelete from cursor to beginning of the line.
Ctrl+WDelete the previous word.
HomeMove to the start of the current line.
EndMove to the end of the current line.
Ctrl+HomeMove to the start of the text.
Ctrl+EndMove to the end of the text.
Meta+/Move the cursor by a word.
/Navigate the command history.

Slash commands in the interactive interface

CommandPurpose
/add-dir PATHAdd a directory to the allowed list for file access.
/agentBrowse and select from available agents (if any).
/allow-all, /yoloEnable all permissions (tools, paths, and URLs).
/clear, /newClear the conversation history.
/compactSummarize the conversation history to reduce context window usage.
/contextShow the context window token usage and visualization.
/cwd, /cd [PATH]Change the working directory or display the current directory.
/delegate [PROMPT]Delegate changes to a remote repository with an AI-generated pull request.
/diffReview the changes made in the current directory.
/exit, /quitExit the CLI.
/experimental [on|off]Toggle or turn on/off experimental features.
/feedbackProvide feedback about the CLI.
/fleet [PROMPT]Enable parallel subagent execution of parts of a task. See Running tasks in parallel with the /fleet command.
/helpShow the help for interactive commands.
/ideConnect to an IDE workspace.
/initInitialize Copilot custom instructions and agentic features for this repository.
/list-dirsDisplay all of the directories for which file access has been allowed.
/loginLog in to Copilot.
/logoutLog out of Copilot.
/lsp [show|test|reload|help] [SERVER-NAME]Manage the language server configuration.
/mcp [show|add|edit|delete|disable|enable] [SERVER-NAME]Manage the MCP server configuration.
/model, /models [MODEL]Select the AI model you want to use.
/plan [PROMPT]Create an implementation plan before coding.
/plugin [marketplace|install|uninstall|update|list] [ARGS...]Manage plugins and plugin marketplaces.
/rename NAMERename the current session (alias for /session rename).
/reset-allowed-toolsReset the list of allowed tools.
/resume [SESSION-ID]Switch to a different session by choosing from a list (optionally specify a session ID).
/review [PROMPT]Run the code review agent to analyze changes.
/session [checkpoints [n]|files|plan|rename NAME]Show session information and a workspace summary. Use the subcommands for details.
/share [file|gist] [PATH]Share the session to a Markdown file or GitHub gist.
/skills [list|info|add|remove|reload] [ARGS...]Manage skills for enhanced capabilities.
/terminal-setupConfigure the terminal for multiline input support (Shift+Enter and Ctrl+Enter).
/theme [show|set|list] [auto|THEME-ID]View or configure the terminal theme.
/usageDisplay session usage metrics and statistics.
/user [show|list|switch]Manage the current GitHub user.

For a complete list of available slash commands enter /help in the CLI's interactive interface.

Command-line options

OptionPurpose
--acpStart the Agent Client Protocol server.
--add-dir PATHAdd a directory to the allowed list for file access (can be used multiple times).
--add-github-mcp-tool TOOLAdd a tool to enable for the GitHub MCP server, instead of the default CLI subset (can be used multiple times). Use * for all tools.
--add-github-mcp-toolset TOOLSETAdd a toolset to enable for the GitHub MCP server, instead of the default CLI subset (can be used multiple times). Use all for all toolsets.
--additional-mcp-config JSONAdd an MCP server for this session only. The server configuration can be supplied as a JSON string or a file path (prefix with @). Augments the configuration from ~/.copilot/mcp-config.json. Overrides any installed MCP server configuration with the same name.
--agent AGENTSpecify a custom agent to use.
--allow-allEnable all permissions (equivalent to --allow-all-tools --allow-all-paths --allow-all-urls).
--allow-all-pathsDisable file path verification and allow access to any path.
--allow-all-toolsAllow all tools to run automatically without confirmation. Required when using the CLI programmatically (env: COPILOT_ALLOW_ALL).
--allow-all-urlsAllow access to all URLs without confirmation.
--allow-tool [TOOLS...]Tools the CLI has permission to use. Will not prompt for permission.
--allow-url [URLS...]Allow access to specific URLs or domains.
--alt-screen [VALUE]Use the terminal alternate screen buffer (on or off).
--autopilotEnable autopilot continuation in prompt mode. See Allowing GitHub Copilot CLI to work autonomously.
--available-tools [TOOLS...]Only these tools will be available to the model.
--bannerShow the startup banner.
--bash-env [VALUE]Enable BASH_ENV support for bash shells (on or off).
--config-dir PATHSet the configuration directory (default: ~/.copilot).
--continueResume the most recent session.
--deny-tool [TOOLS...]Tools the CLI does not have permission to use. Will not prompt for permission.
--deny-url [URLS...]Deny access to specific URLs or domains, takes precedence over --allow-url.
--disable-builtin-mcpsDisable all built-in MCP servers (currently: github-mcp-server).
--disable-mcp-server SERVER-NAMEDisable a specific MCP server (can be used multiple times).
--disable-parallel-tools-executionDisable parallel execution of tools (LLM can still make parallel tool calls, but they will be executed sequentially).
--disallow-temp-dirPrevent automatic access to the system temporary directory.
--enable-all-github-mcp-toolsEnable all GitHub MCP server tools, instead of the default CLI subset. Overrides the --add-github-mcp-toolset and --add-github-mcp-tool options.
--excluded-tools [TOOLS...]These tools will not be available to the model.
--experimentalEnable experimental features (use --no-experimental to disable).
-h, --helpDisplay help.
-i PROMPT, --interactive PROMPTStart an interactive session and automatically execute this prompt.
--log-dir DIRECTORYSet the log file directory (default: ~/.copilot/logs/).
--log-level LEVELSet the log level