Skip to content

Commit 1b700b4

Browse files
DanWahlinCopilot
andauthored
docs: add /ask, /env, MCP registry install, and plugin marketplace update
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>
1 parent 1779126 commit 1b700b4

File tree

3 files changed

+34
-4
lines changed

3 files changed

+34
-4
lines changed

01-setup-and-first-steps/README.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -363,17 +363,20 @@ copilot --allow-all -p "Review @myfile.py for issues"
363363

364364
## Essential Slash Commands
365365

366-
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:
367367

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

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+
377380
That's it for getting started! As you become comfortable, you can explore additional commands.
378381

379382
> 📚 **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
388391
| Command | What It Does |
389392
|---------|--------------|
390393
| `/agent` | Browse and select from available agents |
394+
| `/env` | Show loaded environment details — what instructions, MCP servers, skills, agents, and plugins are active |
391395
| `/init` | Initialize Copilot instructions for your repository |
392396
| `/mcp` | Manage MCP server configuration |
393397
| `/skills` | Manage skills for enhanced capabilities |
394398

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+
395401
> 💡 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).
396402
397403
### Models and Subagents
@@ -653,7 +659,7 @@ The examples used `/plan` for a search feature and `-p` for batch reviews. Now t
653659
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.
654660
2. **Plan mode** is normally for more involved tasks. Review before implementation.
655661
3. **Programmatic mode** is for automation. No interaction needed.
656-
4. **Essential commands** (`/help`, `/clear`, `/plan`, `/research`, `/model`, `/exit`) cover most daily use.
662+
4. **Essential commands** (`/ask`, `/help`, `/clear`, `/plan`, `/research`, `/model`, `/exit`) cover most daily use.
657663
658664
> 📋 **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.
659665

05-skills/README.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -546,6 +546,14 @@ copilot
546546
# Install a plugin from the marketplace
547547
```
548548

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+
549557
Plugins can bundle multiple capabilities together - a single plugin might include related skills, agents, and MCP server configurations that work together.
550558

551559
### Community Skill Repositories

06-mcp-servers/README.md

Lines changed: 18 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -119,13 +119,29 @@ MCP makes Copilot aware of your actual development environment.
119119

120120
<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"/>
121121

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.
123139
124140
---
125141

126142
## MCP Configuration File
127143

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.
129145

130146
> ⚠️ **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.
131147

0 commit comments

Comments
 (0)