diff --git a/website/src/content/docs/learning-hub/cli-for-beginners/01-setup-and-first-steps.md b/website/src/content/docs/learning-hub/cli-for-beginners/01-setup-and-first-steps.md index 42cce797e..dc6141a31 100644 --- a/website/src/content/docs/learning-hub/cli-for-beginners/01-setup-and-first-steps.md +++ b/website/src/content/docs/learning-hub/cli-for-beginners/01-setup-and-first-steps.md @@ -3,7 +3,7 @@ title: '01 · First Steps' description: 'Experience your first GitHub Copilot CLI demos and learn the three main interaction modes.' authors: - GitHub Copilot Learning Hub Team -lastUpdated: 2026-03-20 +lastUpdated: 2026-06-19 --- ![Chapter 01: First Steps](/images/learning-hub/copilot-cli-for-beginners/01/chapter-header.png) @@ -393,6 +393,7 @@ That's it for getting started! As you become comfortable, you can explore additi | `/agent` | Browse and select from available agents | | `/skills` | Manage skills for enhanced capabilities | | `/mcp` | Manage MCP server configuration | +| `/settings` | Open an interactive dialog to browse and edit all user settings in one place | > 💡 Skills are covered in detail in [Chapter 05](../05-skills/). MCP servers are covered in [Chapter 06](../06-mcp-servers/). @@ -442,6 +443,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 | | `/help` | Show all available commands | | `/changelog` | Display changelog for CLI versions | | `/feedback` | Submit feedback to GitHub | diff --git a/website/src/content/docs/learning-hub/cli-for-beginners/04-agents-and-custom-instructions.md b/website/src/content/docs/learning-hub/cli-for-beginners/04-agents-and-custom-instructions.md index 0327a96a6..088b120c1 100644 --- a/website/src/content/docs/learning-hub/cli-for-beginners/04-agents-and-custom-instructions.md +++ b/website/src/content/docs/learning-hub/cli-for-beginners/04-agents-and-custom-instructions.md @@ -3,7 +3,7 @@ title: '04 · Create Specialized AI Assistants' description: 'Mirror the source chapter on custom agents and custom instructions for GitHub Copilot CLI.' authors: - GitHub Copilot Learning Hub Team -lastUpdated: 2026-05-08 +lastUpdated: 2026-06-19 --- ![Chapter 04: Agents and Custom Instructions](/images/learning-hub/copilot-cli-for-beginners/04/chapter-header.png) @@ -430,6 +430,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/website/src/content/docs/learning-hub/cli-for-beginners/06-mcp-servers.md b/website/src/content/docs/learning-hub/cli-for-beginners/06-mcp-servers.md index 7def53198..8922332ba 100644 --- a/website/src/content/docs/learning-hub/cli-for-beginners/06-mcp-servers.md +++ b/website/src/content/docs/learning-hub/cli-for-beginners/06-mcp-servers.md @@ -3,7 +3,7 @@ title: '06 · Connect to GitHub, Databases & APIs' description: 'Mirror the source chapter on MCP servers and external integrations for GitHub Copilot CLI.' authors: - GitHub Copilot Learning Hub Team -lastUpdated: 2026-03-20 +lastUpdated: 2026-06-19 --- ![Chapter 06: MCP Servers](/images/learning-hub/copilot-cli-for-beginners/06/chapter-header.png) @@ -133,7 +133,9 @@ Now that you've seen MCP in action, let's set up additional servers. This sectio ## MCP Configuration File -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). +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. ```json { @@ -341,7 +343,7 @@ Here's a full `mcp-config.json` with filesystem and Context7 servers: } ``` -Save this as `~/.copilot/mcp-config.json` for global access or `.vscode/mcp.json` for project-specific configuration. +Save this as `~/.copilot/mcp-config.json` for global access or `.mcp.json` in the project root for project-specific configuration. --- @@ -848,7 +850,7 @@ Ready to go deeper? Follow the [Custom MCP Server Guide](https://github.com/gith | Mistake | What Happens | Fix | |---------|--------------|-----| | 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" | -| 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` | +| 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` or `.github/mcp.json` | | Invalid JSON in config file | MCP servers fail to load | Use `/mcp show` to check configuration; validate JSON syntax | | Forgetting to authenticate MCP servers | "Authentication failed" errors | Some MCPs need separate auth. Check each server's requirements |