Skip to content

Commit 235f574

Browse files
docs: update Learning Hub for CLI v1.0.11-v1.0.13 changes (#1229)
- copilot-configuration-basics: add /session rename auto-name feature, note that /clear preserves MCP servers in new session - understanding-mcp-servers: add Authentication section documenting OAuth, Microsoft Entra ID (no repeat consent screens), API keys, and non-standard Dynamic Client Registration support - installing-and-using-plugins: note that uninstalling a plugin removes its cached data from disk Sources: - https://github.com/github/copilot-cli/releases/tag/v1.0.13 - https://github.com/github/copilot-cli/releases/tag/v1.0.12 - https://github.com/github/copilot-cli/releases/tag/v1.0.11 Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent 4a68581 commit 235f574

3 files changed

Lines changed: 25 additions & 5 deletions

File tree

website/src/content/docs/learning-hub/copilot-configuration-basics.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: 'Copilot Configuration Basics'
33
description: 'Learn how to configure GitHub Copilot at user, workspace, and repository levels to optimize your AI-assisted development experience.'
44
authors:
55
- GitHub Copilot Learning Hub Team
6-
lastUpdated: 2026-03-28
6+
lastUpdated: 2026-03-30
77
estimatedReadingTime: '10 minutes'
88
tags:
99
- configuration
@@ -412,10 +412,19 @@ GitHub Copilot CLI has two commands for managing session state, with distinct be
412412
| Command | Behaviour |
413413
|---------|-----------|
414414
| `/new [prompt]` | Starts a fresh conversation while keeping the current session backgrounded. You can switch back to backgrounded sessions. |
415-
| `/clear [prompt]` | Abandons the current session entirely and starts a new one. Backgrounded sessions are not affected. |
415+
| `/clear [prompt]` | Abandons the current session entirely and starts a new one. Backgrounded sessions are not affected. MCP servers configured in your project are preserved in the new session. |
416416

417417
Both commands accept an optional prompt argument to seed the new session with an opening message, for example `/new Add error handling to the login flow`.
418418

419+
The `/session rename` command renames the current session. When called **without a name argument**, it automatically generates a session name based on the conversation history:
420+
421+
```
422+
/session rename # auto-generate a name from conversation history
423+
/session rename "My feature" # set a specific name
424+
```
425+
426+
Auto-generated names help you find sessions quickly when switching between multiple backgrounded sessions.
427+
419428
The `/rewind` command opens a timeline picker that lets you roll back the conversation to any earlier point in history, reverting both the conversation and any file changes made after that point. You can also trigger it by pressing **double-Esc**:
420429

421430
```

website/src/content/docs/learning-hub/installing-and-using-plugins.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: 'Installing and Using Plugins'
33
description: 'Learn how to find, install, and manage plugins that extend GitHub Copilot CLI with reusable agents, skills, hooks, and integrations.'
44
authors:
55
- GitHub Copilot Learning Hub Team
6-
lastUpdated: 2026-03-22
6+
lastUpdated: 2026-03-30
77
estimatedReadingTime: '8 minutes'
88
tags:
99
- plugins
@@ -258,7 +258,7 @@ A: Yes. You can create a private plugin marketplace in an internal GitHub reposi
258258

259259
**Q: What happens if I uninstall a plugin?**
260260

261-
A: The plugin's agents, skills, and hooks are removed from Copilot. Any work already done with those tools is unaffected — only future sessions lose access.
261+
A: The plugin's agents, skills, and hooks are removed from Copilot, and any cached plugin data stored on disk is also cleaned up. Any work already done with those tools is unaffected — only future sessions lose access.
262262

263263
## Next Steps
264264

website/src/content/docs/learning-hub/understanding-mcp-servers.md

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: 'Understanding MCP Servers'
33
description: 'Learn how Model Context Protocol servers extend GitHub Copilot with access to external tools, databases, and APIs.'
44
authors:
55
- GitHub Copilot Learning Hub Team
6-
lastUpdated: 2026-03-27
6+
lastUpdated: 2026-03-30
77
estimatedReadingTime: '8 minutes'
88
tags:
99
- mcp
@@ -139,6 +139,17 @@ Example `.mcp.json` or `.vscode/mcp.json`:
139139

140140
> **Security tip**: Use `${input:variableName}` for sensitive values. VS Code will prompt for these at runtime rather than storing them in the file.
141141
142+
### Authentication
143+
144+
Some MCP servers require authentication to connect to protected resources. GitHub Copilot CLI supports several authentication approaches:
145+
146+
- **OAuth**: MCP servers can use the OAuth flow to authenticate with external services. The CLI handles the browser redirect and token storage automatically. This also works when running in ACP (Agent Coordination Protocol) mode.
147+
- **Microsoft Entra ID (Azure AD)**: MCP servers that authenticate via Microsoft Entra ID are fully supported. Once you complete the initial login, the CLI caches the authentication and **will not show the consent screen on subsequent connections** — you authenticate once per session rather than every time the server reconnects.
148+
- **API keys via environment variables**: Pass secrets through the `env` field in the MCP server configuration (see examples above). Never hardcode credentials in `.mcp.json`.
149+
- **`${input:variableName}` prompts**: VS Code will prompt for these values at runtime, keeping secrets out of committed files.
150+
151+
> **Tip**: If your MCP server uses OAuth with Dynamic Client Registration but hosts its authorization metadata at a non-standard URL (as some enterprise servers like Atlassian Rovo do), Copilot CLI handles this automatically.
152+
142153
## How Agents Use MCP Tools
143154

144155
When an agent declares an MCP server in its `tools` array, Copilot can invoke that server's capabilities during conversation:

0 commit comments

Comments
 (0)