Skip to content

Commit 6d5127d

Browse files
DanWahlinCopilot
andauthored
docs: add /mcp list command and @-style imports for instruction files
- Chapter 06: Add /mcp list to the slash commands reference table. Released in v1.0.69-1 (2026-07-04), /mcp list shows currently attached MCP servers and can be run while Copilot is working, complementing the existing /mcp show command. - Chapter 04: Add @-style imports section under Custom Instruction Files. Released in v1.0.66 (2026-06-30), users can now reference other files inside AGENTS.md or instruction files with @filepath syntax, letting teams keep instructions modular and well-organized. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent d9be63d commit 6d5127d

2 files changed

Lines changed: 17 additions & 0 deletions

File tree

04-agents-custom-instructions/README.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -486,6 +486,22 @@ Here are some common patterns:
486486

487487
> 💡 **Tip**: Wrap the glob pattern in quotes (e.g., `"**/*.py"`) to ensure it is interpreted correctly across all operating systems and shells.
488488

489+
#### Importing Other Files with `@`
490+
491+
You can reference another file inside `AGENTS.md` or any instruction file using `@filepath` syntax. Copilot expands the reference and includes that file's content automatically, so you can keep your main file short while storing the details elsewhere:
492+
493+
```markdown
494+
<!-- AGENTS.md -->
495+
# Project Instructions
496+
497+
@.github/instructions/python-standards.instructions.md
498+
@.github/instructions/test-standards.instructions.md
499+
```
500+
501+
This is handy when your instructions grow large. Split them into focused files and `@`-import them from a single `AGENTS.md`. The same syntax works inside `.github/copilot-instructions.md` and other instruction files too.
502+
503+
> 💡 **Tip**: Use `@`-imports to share a common base file across multiple instruction files. For example, you could have a `@.github/instructions/shared-rules.md` that every other instruction file pulls in.
504+
489505
**Finding community instruction files**: Browse [github/awesome-copilot](https://github.com/github/awesome-copilot) for pre-made instruction files covering .NET, Angular, Azure, Python, Docker, and many more technologies.
490506
491507
### Disabling Custom Instructions

06-mcp-servers/README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -924,6 +924,7 @@ These work when you're already inside `copilot`:
924924
| Command | What It Does |
925925
|---------|--------------|
926926
| `/mcp show` | Show all configured MCP servers and their status |
927+
| `/mcp list` | Show currently attached MCP servers and their status; can be run while Copilot is working |
927928
| `/mcp add` | Interactive setup for adding a new server |
928929
| `/mcp edit <server-name>` | Edit an existing server configuration |
929930
| `/mcp enable <server-name>` | Enable a disabled server (persists across sessions) |

0 commit comments

Comments
 (0)