From a6ab44b08fa5c50bdbdb87ac771790024c457d1c Mon Sep 17 00:00:00 2001 From: Dan Wahlin Date: Mon, 15 Jun 2026 06:45:28 -0700 Subject: [PATCH 1/2] docs: add /settings, /app commands and new config locations from v1.0.61-62 - Add /settings slash command to Chapter 01's Agent Environment table (interactive dialog to browse and edit all user settings) - Add /app slash command to Chapter 01's Help and Feedback table (opens GitHub app or browser fallback from the CLI) - Update Chapter 06 MCP Configuration File section to mention .github/mcp.json as a new workspace-level config location (auto-loaded alongside .mcp.json) - Add ~/.copilot/instructions/**/*.instructions.md to Chapter 04's Instruction File Formats table as a user-level instruction location that applies across all projects Features from GitHub Copilot CLI v1.0.61 (2026-06-09) and v1.0.62 (2026-06-13). Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- 01-setup-and-first-steps/README.md | 2 ++ 04-agents-custom-instructions/README.md | 1 + 06-mcp-servers/README.md | 2 +- 3 files changed, 4 insertions(+), 1 deletion(-) diff --git a/01-setup-and-first-steps/README.md b/01-setup-and-first-steps/README.md index 485002ab..eeccc369 100644 --- a/01-setup-and-first-steps/README.md +++ b/01-setup-and-first-steps/README.md @@ -407,6 +407,7 @@ That's it for getting started! As you become comfortable, you can explore additi | `/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 | +| `/settings` | Open an interactive dialog to browse and edit all user settings in one place | | `/skills` | Manage skills for enhanced capabilities | > 💡 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). @@ -471,6 +472,7 @@ That's it for getting started! As you become comfortable, you can explore additi | Command | What It Does | |---------|--------------| +| `/app` | Open the GitHub app (or browser fallback) directly from the CLI | | `/changelog` | Display changelog for CLI versions | | `/feedback` | Submit feedback to GitHub | | `/help` | Show all available commands | diff --git a/04-agents-custom-instructions/README.md b/04-agents-custom-instructions/README.md index 81232e2e..610afb2e 100644 --- a/04-agents-custom-instructions/README.md +++ b/04-agents-custom-instructions/README.md @@ -433,6 +433,7 @@ Copilot will scan your project and create tailored instruction files. You can ed | `AGENTS.md` | Project root or nested | **Cross-platform standard** - works with Copilot and other AI assistants | | `.github/copilot-instructions.md` | Project | GitHub Copilot specific | | `.github/instructions/*.instructions.md` | Project | Granular, topic-specific instructions | +| `~/.copilot/instructions/**/*.instructions.md` | User (all projects) | Personal instructions that apply everywhere, across all your repos | | `CLAUDE.md`, `GEMINI.md` | Project root | Supported for compatibility | > 🎯 **Just getting started?** Use `AGENTS.md` for project instructions. You can explore the other formats later as needed. diff --git a/06-mcp-servers/README.md b/06-mcp-servers/README.md index 6ddc8fb0..9be12dbb 100644 --- a/06-mcp-servers/README.md +++ b/06-mcp-servers/README.md @@ -152,7 +152,7 @@ Copilot opens an interactive picker showing available servers. Select one, and t ## 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). 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. +MCP servers are configured in `~/.copilot/mcp-config.json` (user-level, applies to all projects), `.mcp.json` (project-level, placed in the root of your project), or `.github/mcp.json` (workspace-level, automatically loaded alongside `.mcp.json`). 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. From 05493b8b493becf1e072c4a61b56f74c2cf5532c Mon Sep 17 00:00:00 2001 From: Dan Wahlin Date: Mon, 15 Jun 2026 15:16:44 -0700 Subject: [PATCH 2/2] Update README.md --- 06-mcp-servers/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/06-mcp-servers/README.md b/06-mcp-servers/README.md index 9be12dbb..abac856c 100644 --- a/06-mcp-servers/README.md +++ b/06-mcp-servers/README.md @@ -152,7 +152,7 @@ Copilot opens an interactive picker showing available servers. Select one, and t ## MCP Configuration File -MCP servers are configured in `~/.copilot/mcp-config.json` (user-level, applies to all projects), `.mcp.json` (project-level, placed in the root of your project), or `.github/mcp.json` (workspace-level, automatically loaded alongside `.mcp.json`). 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. +MCP servers can be configured at the user level in `~/.copilot/mcp-config.json`, which applies across projects, at the project level in `.mcp.json`, or in the workspace config file `.github/mcp.json`. `.github/mcp.json` is auto-loaded alongside `.mcp.json`. If you used `/mcp search`, the CLI created or updated your user-level `~/.copilot/mcp-config.json`, but understanding the JSON format is useful when you want to customize or share project-level MCP configuration. > ⚠️ **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.