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
Document new Copilot CLI features from releases v1.0.25–v1.0.27:
- Add /ask command to Essential Slash Commands (ask quick questions
without affecting conversation history)
- Add /env command to Additional Commands reference (shows active
instructions, MCP servers, skills, agents, and plugins)
- Document MCP server registry installation (/mcp install) in Chapter 06
as the beginner-friendly path before manual JSON configuration
- Add 'copilot plugin marketplace update' command to Chapter 05 plugin
section so learners can refresh stale plugin catalogs
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
These commands work in interactive mode. **Start with just these six** - they cover 90% of daily use:
366
+
These commands work in interactive mode. **Start with just these seven** - they cover 90% of daily use:
367
367
368
368
| Command | What It Does | When to Use |
369
369
|---------|--------------|-------------|
370
+
|`/ask`| Ask a quick question without it affecting your conversation history | When you want a quick answer without derailing your current task |
370
371
|`/clear`| Clear conversation and start fresh | When switching topics |
371
372
|`/help`| Show all available commands | When you forget a command |
372
373
|`/model`| Show or switch AI model | When you want to change the AI model |
373
374
|`/plan`| Plan your work out before coding | For more complex features |
374
375
|`/research`| Deep research using GitHub and web sources | When you need to investigate a topic before coding |
375
376
|`/exit`| End the session | When you're done |
376
377
378
+
> 💡 **`/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.
379
+
377
380
That's it for getting started! As you become comfortable, you can explore additional commands.
378
381
379
382
> 📚 **Official Documentation**: [CLI command reference](https://docs.github.com/copilot/reference/cli-command-reference) for the complete list of commands and flags.
@@ -388,10 +391,13 @@ That's it for getting started! As you become comfortable, you can explore additi
388
391
| Command | What It Does |
389
392
|---------|--------------|
390
393
|`/agent`| Browse and select from available agents |
394
+
|`/env`| Show loaded environment details — what instructions, MCP servers, skills, agents, and plugins are active |
391
395
|`/init`| Initialize Copilot instructions for your repository |
392
396
|`/mcp`| Manage MCP server configuration |
393
397
|`/skills`| Manage skills for enhanced capabilities |
394
398
399
+
> 💡 **`/env` tip**: Use `/env` whenever you want to confirm that Copilot has picked up your custom agents, skills, or MCP servers. It's a great first step if something isn't working as expected.
400
+
395
401
> 💡 Agents are covered in [Chapter 04](../04-agents-custom-instructions/README.md), skills are covered in [Chapter 05](../05-skills/README.md), and MCP servers are covered in [Chapter 06](../06-mcp-servers/README.md).
396
402
397
403
### Models and Subagents
@@ -653,7 +659,7 @@ The examples used `/plan` for a search feature and `-p` for batch reviews. Now t
653
659
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.
654
660
2. **Plan mode** is normally for more involved tasks. Review before implementation.
655
661
3. **Programmatic mode** is for automation. No interaction needed.
> 📋 **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.
Copy file name to clipboardExpand all lines: 05-skills/README.md
+8Lines changed: 8 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -546,6 +546,14 @@ copilot
546
546
# Install a plugin from the marketplace
547
547
```
548
548
549
+
To keep your local plugin catalog current, refresh it with:
550
+
551
+
```bash
552
+
copilot plugin marketplace update
553
+
```
554
+
555
+
> 💡 **When to run this**: If you notice that new plugins aren't appearing in `/plugin marketplace`, running this command fetches the latest catalog from the marketplace server.
556
+
549
557
Plugins can bundle multiple capabilities together - a single plugin might include related skills, agents, and MCP server configurations that work together.
Copy file name to clipboardExpand all lines: 06-mcp-servers/README.md
+18-2Lines changed: 18 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -119,13 +119,29 @@ MCP makes Copilot aware of your actual development environment.
119
119
120
120
<imgsrc="images/configuring-mcp-servers.png"alt="Hands adjusting knobs and sliders on a professional audio mixing board representing MCP server configuration"width="800"/>
121
121
122
-
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.
122
+
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.
123
+
124
+
---
125
+
126
+
## Installing MCP Servers from the Registry
127
+
128
+
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.
129
+
130
+
```bash
131
+
copilot
132
+
133
+
> /mcp install
134
+
```
135
+
136
+
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.
137
+
138
+
> 💡 **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.
123
139
124
140
---
125
141
126
142
## MCP Configuration File
127
143
128
-
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).
144
+
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 install` above, the CLI already created or updated this file for you — but it's useful to understand the format for advanced customization.
129
145
130
146
> ⚠️ **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.
0 commit comments