Copilot Cli Guide

Copilot CLI Guide

Quick reference for GitHub Copilot CLI — the terminal-native AI coding agent.

When to use this skill

• User asks about Copilot CLI features or capabilities
• User needs help with slash commands or keyboard shortcuts
• User wants to understand modes (interactive, plan, autopilot)
• User asks about context management or session handling

Getting Started

# Install (macOS/Linux)
curl -fsSL https://gh.io/copilot-install | bash

# Install (Homebrew)
brew install copilot-cli

# Install (npm, cross-platform)
npm install -g @github/copilot

# Install (Windows)
winget install GitHub.Copilot

# Launch
copilot

Keyboard Shortcuts

Global

| Shortcut | Action | |----------|--------| | @ | Mention files, include contents in context | | # | Include a GitHub issue or pull request in context | | ! | Execute shell command directly (bypass Copilot) | | ? | Open quick help on an empty prompt | | Esc | Cancel current operation | | Ctrl+C | Cancel operation / clear input; press twice to exit | | Ctrl+D | Shutdown | | Ctrl+Enter / Ctrl+Q | Queue a message while the agent is busy | | Ctrl+G | Edit prompt in external editor | | Ctrl+L | Clear the screen | | Ctrl+R | Reverse search command history | | Ctrl+V | Paste from clipboard as an attachment | | Ctrl+X then / | Run a slash command after typing a prompt | | Ctrl+X then e | Edit the prompt in an external editor | | Ctrl+X then o | Open the most recent link from the timeline | | Shift+Enter / Option+Enter | Insert a newline in the input | | Shift+Tab | Cycle modes (standard → plan → autopilot) |

Timeline

| Shortcut | Action | |----------|--------| | Ctrl+T | Expand/collapse reasoning display | | Ctrl+O | Expand recent timeline items when prompt is empty | | Ctrl+E | Expand all timeline items when prompt is empty | | Page Up / Page Down | Scroll the timeline |

Editing

| Shortcut | Action | |----------|--------| | Ctrl+A | Move to beginning of line | | Ctrl+E | Move to end of line | | Ctrl+H | Delete previous character | | Ctrl+W | Delete previous word | | Ctrl+U | Delete from cursor to beginning of line | | Ctrl+K | Delete from cursor to end of line | | Alt+← / Alt+→ | Move cursor by word on Windows/Linux | | Option+← / Option+→ | Move cursor by word on macOS | | ↑ / ↓ | Navigate command history | | Tab / Ctrl+Y | Accept inline completion suggestion |

Slash Commands

Agent & Customization

| Command | Purpose | |---------|---------| | /init | Initialize Copilot instructions and agentic features for this repository | | /agent | Browse and select from available agents | | /skills | Manage skills for enhanced capabilities | | /mcp | Manage MCP server configuration | | /plugin | Manage plugins and plugin marketplaces | | /instructions | View and toggle custom instruction files | | /env | Show loaded instructions, MCP servers, skills, agents, plugins, LSPs, and extensions |

Models & Subagents

| Command | Purpose | |---------|---------| | /model | Select AI model to use | | /fleet | Enable fleet mode for parallel subagent execution | | /tasks | View and manage background tasks |

Code & Review

| Command | Purpose | |---------|---------| | /ide | Connect to an IDE workspace | | /diff | Review changes made in current directory | | /pr | View, create, fix, or automate pull requests | | /review | Run code review agent | | /lsp | Manage language server configuration | | /plan | Create implementation plan before coding | | /research | Run deep research investigation | | /delegate | Delegate changes to a remote repository with an AI-generated pull request |

Permissions

| Command | Purpose | |---------|---------| | /allow-all, /yolo | Enable, disable, or show all permissions | | /add-dir | Add a directory to allowed list | | /list-dirs | Display all allowed directories | | /cwd, /cd | Change working directory | | /reset-allowed-tools | Reset allowed tools |

Session

| Command | Purpose | |---------|---------| | /resume, /continue | Resume a previous session | | /rename | Rename current session | | /context | Show context window token usage | | /usage | Display session usage metrics | | /compact | Summarize conversation to reduce context | | /share, /export | Share session or research to Markdown, HTML, or GitHub gist | | /copy | Copy last response to clipboard | | /session | Show session info |

Help & Feedback

| Command | Purpose | |---------|---------| | /help | Show help for interactive commands | | /changelog, /release-notes | Display changelog for CLI versions | | /feedback | Provide feedback about the CLI | | /theme | View or configure terminal theme | | /update | Update CLI to latest version | | /experimental | Manage experimental features | | /clear, /new, /reset | Start a new conversation | | /version | Display version information and check for updates |

Other

| Command | Purpose | |---------|---------| | /exit, /quit | Exit the CLI | | /login | Log in to Copilot | | /logout | Log out of Copilot | | /user | Manage GitHub user list | | /remote | Enable or end remote steering | | /undo, /rewind | Rewind the last turn and revert file changes | | /keep-alive | Prevent sleep while the CLI session is active or busy | | /terminal-setup | Configure terminal for multiline input (shift+enter) |

Modes

Standard Mode (default)

Standard chat mode. Copilot asks for approval before modifying files or executing tools unless permissions allow them.

Plan Mode

Press Shift+Tab to enter plan mode. Copilot creates an implementation plan before writing any code. Great for complex tasks.

Autopilot Mode (experimental)

Copilot continues working on tasks until completion with less manual intervention. Enable with --mode autopilot, --autopilot, or by cycling modes with Shift+Tab.

Context Management

Include files

Use @ followed by a relative path to include file contents:

Explain @config/ci/ci-required-checks.yml
Fix the bug in @src/app.js

Manage context window

/context    # Visual overview of token usage
/usage      # Detailed session statistics
/compact    # Compress conversation history

Copilot CLI automatically compresses history when approaching 95% of the token limit.

Working with directories

/add-dir /path/to/directory    # Add trusted directory
/cwd /path/to/directory        # Change working directory
/list-dirs                     # Show allowed directories

Session Management

# Resume previous session
/resume

# Resume most recent session from terminal
copilot --continue

# Start with a specific agent
copilot --agent=my-agent --prompt "Do something"

Built-in Agents

Use built-in agents before creating a custom project agent when the task matches their purpose.

| Agent | Purpose | |-------|---------| | explore | Fast read-only codebase exploration and focused answers | | research | Deeper investigation across code, GitHub, and web sources | | task | Build, test, lint, and command execution summaries | | code-review | High signal-to-noise review of diffs for bugs, security, and logic issues | | general-purpose | Complex multi-step work in a separate context window | | configure-copilot | Experimental configuration helper for MCP servers, agents, and skills | | rubber-duck | Experimental critique of plans, designs, implementations, or tests |

MCP Servers

Built-in MCP servers include GitHub, Playwright, fetch, and time. Additional MCP servers can be configured at repository, workspace, user, agent, or one-session scope.

/mcp show               # Show configured MCP servers
/mcp add                # Add a new MCP server interactively
copilot mcp list        # List servers from the shell
copilot mcp add NAME -- COMMAND ARGS...

Common config locations:

• .github/mcp.json for repository-level MCP config
• .mcp.json for workspace MCP config
• ~/.copilot/mcp-config.json for user-level MCP config
• --additional-mcp-config for a single session

Advanced MCP considerations:

• Use /mcp auth SERVER-NAME when a remote OAuth server needs re-authentication.
• Use filterMapping to control how MCP output is cleaned or formatted before it reaches the model.
• Use OIDC only when the server is designed to receive Copilot-issued identity tokens.
• Expect enterprise allowlists to block non-default servers until approved by policy.
• Migrate VS Code .vscode/mcp.json to .mcp.json by remapping servers to mcpServers.

LSP Configuration

For enhanced code intelligence, configure language servers:

• User-level: ~/.copilot/lsp-config.json
• Repository-level: .github/lsp.json

{
  "lspServers": {
    "typescript": {
      "command": "typescript-language-server",
      "args": ["--stdio"],
      "fileExtensions": {
        ".ts": "typescript",
        ".tsx": "typescript"
      }
    }
  }
}

Custom Instructions Locations

Copilot CLI reads instructions from these locations (in order):

1. CLAUDE.md (git root & cwd)
2. GEMINI.md (git root & cwd)
3. AGENTS.md (git root & cwd)
4. .github/instructions/**/*.instructions.md (git root & cwd)
5. .github/copilot-instructions.md
6. $HOME/.copilot/copilot-instructions.md
7. COPILOT_CUSTOM_INSTRUCTIONS_DIRS (additional directories via env var)

Path-specific instruction files require applyTo frontmatter and can include comma-separated glob patterns.

Useful CLI Flags

copilot --banner          # Show animated banner
copilot --experimental    # Enable experimental features
copilot --mode plan       # Start in plan mode
copilot --mode autopilot  # Start in autopilot mode
copilot --plan            # Shorthand for --mode plan
copilot --autopilot       # Enable autopilot in prompt mode
copilot --continue        # Resume most recent session
copilot --resume SESSION  # Resume specific session
copilot --agent=NAME      # Use specific agent
copilot --prompt "..."    # Start with a prompt
copilot --interactive "..." # Start interactive mode and run a prompt
copilot --allow-all       # Enable all permissions
copilot --yolo            # Alias for --allow-all
copilot --available-tools=read,grep,edit # Restrict tools available to the model
copilot --allow-tool='shell(git:*)'      # Pre-approve matching tool calls
copilot --deny-tool='shell(git push)'    # Deny matching tool calls
copilot --add-dir=/path/to/project       # Allow access to another directory
copilot --config-dir=/path/to/config     # Use a different config directory

Programmatic Usage

Use prompt mode for scripts, CI helpers, or repeatable local automation. In non-interactive contexts, provide explicit tool and path permissions so the run does not stop for approval prompts.

copilot --prompt "Update the changelog" --allow-tool=read,grep,edit --add-dir="$PWD"
copilot --prompt "Review this branch" --output-format=json --silent
copilot --prompt "Run the test task" --share=./copilot-session.md

Token environment variables are checked in this order: COPILOT_GITHUB_TOKEN, GH_TOKEN, then GITHUB_TOKEN. Prefer fine-grained tokens with the minimum required permissions for automation.

Permission Patterns

Permission flags accept broad tool names or structured patterns. Deny rules take precedence over allow rules.

copilot --allow-tool='shell(git:*)' --deny-tool='shell(git push)'
copilot --allow-url='https://github.com' --deny-url='https://example.com/private'
copilot --allow-tool='MyMCP(create_issue)'
copilot --allow-tool='MyMCP'

Common pattern kinds include read, write, shell, url, memory, and MCP server names.

OpenTelemetry Monitoring

Copilot CLI can export traces and metrics for agent turns, LLM requests, tool calls, token usage, and errors. Monitoring is off by default and activates when an OpenTelemetry endpoint or file exporter is configured.

export COPILOT_OTEL_ENABLED=true
export OTEL_EXPORTER_OTLP_ENDPOINT=https://otel.example.com/v1/traces
export OTEL_SERVICE_NAME=github-copilot

Do not enable full content capture in shared or untrusted environments. It may record prompts, code, tool arguments, and tool results.

Reference Documentation

• About Copilot CLI
• Using Copilot CLI
• CLI Best Practices
• CLI Command Reference
• CLI Programmatic Reference
• CLI Plugin Reference
• CLI Configuration Directory
• Custom Instructions
• Custom Agents
• Agent Skills
• MCP Servers

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: trsdn
• Source: trsdn/github-copilot-cli
• License: MIT

Install and usage instructions live in the source repository linked above.