Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 6 additions & 2 deletions 01-setup-and-first-steps/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -363,17 +363,20 @@ copilot --allow-all -p "Review @myfile.py for issues"

## Essential Slash Commands

These commands work in interactive mode. **Start with just these six** - they cover 90% of daily use:
These commands are great to learn initially as you're getting started with Copilot CLI:

| Command | What It Does | When to Use |
|---------|--------------|-------------|
| `/ask` | Ask a quick question without it affecting your conversation history | When you want a quick answer without derailing your current task |
| `/clear` | Clear conversation and start fresh | When switching topics |
| `/help` | Show all available commands | When you forget a command |
| `/model` | Show or switch AI model | When you want to change the AI model |
| `/plan` | Plan your work out before coding | For more complex features |
| `/research` | Deep research using GitHub and web sources | When you need to investigate a topic before coding |
| `/exit` | End the session | When you're done |

> 💡 **`/ask` vs regular chat**: Normally every message you send becomes part of the ongoing conversation and affects future responses. `/ask` is an "off the record" shortcut — perfect for quick one-off questions like `/ask What does YAML mean?` without polluting your session context.

That's it for getting started! As you become comfortable, you can explore additional commands.

> 📚 **Official Documentation**: [CLI command reference](https://docs.github.com/copilot/reference/cli-command-reference) for the complete list of commands and flags.
Expand All @@ -388,6 +391,7 @@ That's it for getting started! As you become comfortable, you can explore additi
| Command | What It Does |
|---------|--------------|
| `/agent` | Browse and select from available agents |
| `/env` | Show loaded environment details — what instructions, MCP servers, skills, agents, and plugins are active |
| `/init` | Initialize Copilot instructions for your repository |
| `/mcp` | Manage MCP server configuration |
| `/skills` | Manage skills for enhanced capabilities |
Expand Down Expand Up @@ -653,7 +657,7 @@ The examples used `/plan` for a search feature and `-p` for batch reviews. Now t
1. **Interactive mode** is for exploration and iteration - context carries forward. It's like having a conversation with someone who remembers what you've said up to that point.
2. **Plan mode** is normally for more involved tasks. Review before implementation.
3. **Programmatic mode** is for automation. No interaction needed.
4. **Essential commands** (`/help`, `/clear`, `/plan`, `/research`, `/model`, `/exit`) cover most daily use.
4. **Essential commands** (`/ask`, `/help`, `/clear`, `/plan`, `/research`, `/model`, `/exit`) cover most daily use.

> 📋 **Quick Reference**: See the [GitHub Copilot CLI command reference](https://docs.github.com/en/copilot/reference/cli-command-reference) for a complete list of commands and shortcuts.

Expand Down
8 changes: 7 additions & 1 deletion 05-skills/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -546,7 +546,13 @@ copilot
# Install a plugin from the marketplace
```

Plugins can bundle multiple capabilities together - a single plugin might include related skills, agents, and MCP server configurations that work together.
To keep your local plugin catalog current, refresh it with:

```bash
copilot plugin marketplace update
```
Comment on lines +549 to +553
Copy link

Copilot AI Apr 15, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This command (copilot plugin marketplace update) is a terminal subcommand, but it appears immediately after an interactive-session snippet (copilot + > /plugin ...). Add a short note clarifying it should be run from your shell (outside the interactive Copilot prompt), otherwise beginners may try to paste it after > and get an error.

Copilot uses AI. Check for mistakes.

Plugins can bundle multiple capabilities together. A single plugin might include related skills, agents, and MCP server configurations that work together.

### Community Skill Repositories

Expand Down
20 changes: 18 additions & 2 deletions 06-mcp-servers/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -119,13 +119,29 @@ MCP makes Copilot aware of your actual development environment.

<img src="images/configuring-mcp-servers.png" alt="Hands adjusting knobs and sliders on a professional audio mixing board representing MCP server configuration" width="800"/>

Now that you've seen MCP in action, let's set up additional servers. This section covers the configuration file format and how to add new servers.
Now that you've seen MCP in action, let's set up additional servers. You can add servers in two ways: **from the built-in registry** (easiest — guided setup right in the CLI) or by **editing the config file** manually (more flexible). Start with the registry option if you're not sure which to choose.

---

## Installing MCP Servers from the Registry

The CLI has a built-in MCP server registry that lets you discover and install popular servers with a guided setup — no JSON editing required.

```bash
copilot

> /mcp search
```

Copilot opens an interactive picker showing available servers. Select one, and the CLI walks you through any required configuration (API keys, paths, etc.) and adds it to your config automatically.
Comment on lines +126 to +136
Copy link

Copilot AI Apr 15, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The section is titled "Installing MCP Servers from the Registry" but the example uses /mcp search. Later in this chapter's command reference the interactive add flow is documented as /mcp add (and the PR description mentions /mcp install). Please align the docs on the actual command(s) and naming so readers don’t follow a command that isn’t documented elsewhere in the chapter.

This issue also appears on line 144 of the same file.

Copilot uses AI. Check for mistakes.

> 💡 **Why use the registry?** It's the easiest way to get started — you don't need to know the npm package name, command arguments, or JSON structure. The CLI handles all of that for you.

---

## MCP Configuration File

MCP servers are configured in `~/.copilot/mcp-config.json` (user-level, applies to all projects) or `.mcp.json` (project-level, placed in the root of your project).
MCP servers are configured in `~/.copilot/mcp-config.json` (user-level, applies to all projects) or `.mcp.json` (project-level, placed in the root of your project). If you used `/mcp search` above, the CLI already created or updated this file for you, but it's useful to understand the format for customization.

> ⚠️ **Note**: `.vscode/mcp.json` is no longer supported as an MCP config source. If you have an existing `.vscode/mcp.json`, migrate it to `.mcp.json` in your project root. The CLI will show a migration hint if it detects an old config file.

Expand Down
Loading