Skip to content

Commit 079d3e9

Browse files
DanWahlinCopilot
andauthored
Update course for Copilot CLI v1.0.22–v1.0.23 changes
- Fix outdated MCP config: replace .vscode/mcp.json with .mcp.json (removed in v1.0.22; CLI now only reads .mcp.json for project-level config) - Add migration note for users with existing .vscode/mcp.json files - Document --plan and --autopilot startup flags (added in v1.0.23) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent a9e32fe commit 079d3e9

File tree

2 files changed

+12
-5
lines changed

2 files changed

+12
-5
lines changed

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

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -272,10 +272,15 @@ Notice how each prompt builds on the previous answer. You're having a conversati
272272

273273
**Best for**: Complex tasks where you want to review the approach before execution. Similar to planning a route before a trip using GPS.
274274

275-
Plan mode helps you create a step-by-step plan before writing any code. Use the `/plan` command or press **Shift+Tab** to cycle into Plan Mode:
275+
Plan mode helps you create a step-by-step plan before writing any code. Use the `/plan` command, press **Shift+Tab** to cycle into Plan Mode, or use the `--plan` startup flag:
276276

277277
> 💡 **Tip**: **Shift+Tab** cycles between modes: Interactive → Plan → Autopilot. Press it anytime during an interactive session to switch modes without typing a command.
278278
279+
> 💡 **Startup shortcut**: You can launch the CLI directly in Plan mode from your terminal using the `--plan` flag — great when you already know what you want to plan:
280+
> ```bash
281+
> copilot --plan "Add a mark as read command to the book app"
282+
> ```
283+
279284
```bash
280285
copilot
281286
@@ -312,7 +317,7 @@ Proceed with implementation? [Y/n]
312317

313318
> 💡 **Want something more complex?** Try: `/plan Add search and filter capabilities to the book app`. Plan mode scales from simple features to full applications.
314319
315-
> 📚 **Autopilot mode**: You may have noticed Shift+Tab cycles through a third mode called **Autopilot**. In autopilot mode, Copilot works through an entire plan without waiting for your input after each step — like handing a task to a colleague and saying "let me know when you're finished." The typical workflow is plan → accept → autopilot, which means you need to be good at writing plans first. Get comfortable with Interactive and Plan modes, then see the [official docs](https://docs.github.com/copilot/concepts/agents/copilot-cli/autopilot) when you're ready.
320+
> 📚 **Autopilot mode**: You may have noticed Shift+Tab cycles through a third mode called **Autopilot**. In autopilot mode, Copilot works through an entire plan without waiting for your input after each step — like handing a task to a colleague and saying "let me know when you're finished." The typical workflow is plan → accept → autopilot, which means you need to be good at writing plans first. You can also launch directly into autopilot with `copilot --autopilot "Your task here"`. Get comfortable with Interactive and Plan modes first, then see the [official docs](https://docs.github.com/copilot/concepts/agents/copilot-cli/autopilot) when you're ready.
316321
317322
---
318323

06-mcp-servers/README.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -125,7 +125,9 @@ Now that you've seen MCP in action, let's set up additional servers. This sectio
125125

126126
## MCP Configuration File
127127

128-
MCP servers are configured in `~/.copilot/mcp-config.json` (user-level, applies to all projects) or `.vscode/mcp.json` (project-level, applies to just the current workspace).
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).
129+
130+
> ⚠️ **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.
129131
130132
```json
131133
{
@@ -333,7 +335,7 @@ Here's a full `mcp-config.json` with filesystem and Context7 servers:
333335
}
334336
```
335337
336-
Save this as `~/.copilot/mcp-config.json` for global access or `.vscode/mcp.json` for project-specific configuration.
338+
Save this as `~/.copilot/mcp-config.json` for global access or `.mcp.json` in the project root for project-specific configuration.
337339
338340
---
339341
@@ -840,7 +842,7 @@ Ready to go deeper? Follow the [Custom MCP Server Guide](mcp-custom-server.md) t
840842
| Mistake | What Happens | Fix |
841843
|---------|--------------|-----|
842844
| Not knowing GitHub MCP is built-in | Trying to install/configure it manually | GitHub MCP is included by default. Just try: "List the recent commits in this repo" |
843-
| Looking for config in wrong location | Can't find or edit MCP settings | User-level config is in `~/.copilot/mcp-config.json`, project-level is `.vscode/mcp.json` |
845+
| Looking for config in wrong location | Can't find or edit MCP settings | User-level config is in `~/.copilot/mcp-config.json`, project-level is `.mcp.json` in the project root |
844846
| Invalid JSON in config file | MCP servers fail to load | Use `/mcp show` to check configuration; validate JSON syntax |
845847
| Forgetting to authenticate MCP servers | "Authentication failed" errors | Some MCPs need separate auth. Check each server's requirements |
846848

0 commit comments

Comments
 (0)