mirror of
https://github.com/github/awesome-copilot.git
synced 2026-05-04 14:15:55 +00:00
Update Learning Hub: v1.0.36-v1.0.40 CLI changes (#1588)
- Add /chronicle command (GA in v1.0.40): session history and file tracking - Add --max-autopilot-continues flag for autopilot mode configuration - Add COPILOT_HOME env var and deprecation notice for --config-dir - Add client_credentials OAuth grant type for headless MCP authentication - Add Azure DevOps auto-disable GitHub MCP server FAQ entry Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
committed by
GitHub
parent
c7b2aecb94
commit
1c6ef8dc7e
@@ -3,7 +3,7 @@ title: 'Copilot Configuration Basics'
|
||||
description: 'Learn how to configure GitHub Copilot at user, workspace, and repository levels to optimize your AI-assisted development experience.'
|
||||
authors:
|
||||
- GitHub Copilot Learning Hub Team
|
||||
lastUpdated: 2026-04-30
|
||||
lastUpdated: 2026-05-01
|
||||
estimatedReadingTime: '10 minutes'
|
||||
tags:
|
||||
- configuration
|
||||
@@ -479,6 +479,16 @@ The `/share html` command exports the current session — including conversation
|
||||
|
||||
The exported file contains everything needed to view the session without a network connection and can be shared with teammates or stored for later reference. This complements `/share` (which shares via URL) for cases where an offline or attached format is preferred.
|
||||
|
||||
The `/chronicle` command opens an interactive timeline of everything the agent has done in the current session. It shows file changes, tool calls, and conversation turns in chronological order, letting you review the full arc of the session at a glance:
|
||||
|
||||
```
|
||||
/chronicle
|
||||
```
|
||||
|
||||
Chronicle tracks which files were created, modified, or deleted during the session alongside the conversation that led to those changes. Use it to review what happened before a `/rewind`, audit what the agent changed, or share a summary of session activity with teammates.
|
||||
|
||||
> **Note**: Session history, file tracking, and the `/chronicle` command were previously experimental features. As of v1.0.40, they are available to all users without enabling experimental mode.
|
||||
|
||||
**Keyboard shortcuts for queuing messages**: Use **Ctrl+Q** or **Ctrl+Enter** to queue a message (send it while the agent is still working). **Ctrl+D** no longer queues messages — it now has its default terminal behavior. If you have muscle memory for Ctrl+D queuing, switch to Ctrl+Q.
|
||||
|
||||
**Background running tasks**: Press **Ctrl+X → B** to move the current running task or shell command to the background. The task continues executing while you can type a new message or review earlier output. This is useful for long-running commands where you want to interact with the agent while waiting for the result.
|
||||
@@ -563,6 +573,27 @@ copilot --plan # start in plan mode (propose without executing)
|
||||
|
||||
This is useful in scripts or CI pipelines where you want the CLI to immediately begin working in a specific mode without an interactive prompt.
|
||||
|
||||
The `--max-autopilot-continues` flag controls how many times Copilot can automatically continue in autopilot mode before pausing for confirmation. The default is 5:
|
||||
|
||||
```bash
|
||||
copilot --autopilot --max-autopilot-continues 10 "Refactor the authentication module"
|
||||
```
|
||||
|
||||
Set it higher for long-running tasks, or lower for tasks where you want more frequent checkpoints. Setting it to `0` disables automatic continuation entirely.
|
||||
|
||||
The `COPILOT_HOME` environment variable sets the Copilot CLI configuration directory. It is the preferred replacement for the `--config-dir` flag, which is deprecated:
|
||||
|
||||
```bash
|
||||
# Preferred — set via environment variable
|
||||
export COPILOT_HOME=~/.my-copilot-config
|
||||
copilot
|
||||
|
||||
# Deprecated — use COPILOT_HOME instead
|
||||
copilot --config-dir ~/.my-copilot-config
|
||||
```
|
||||
|
||||
Set `COPILOT_HOME` in your shell profile to use a custom config directory across all sessions. This is especially useful when running multiple Copilot configurations for different projects or teams.
|
||||
|
||||
### Shell Completion
|
||||
|
||||
The `copilot completion` subcommand generates a static shell completion script for subcommands, flags, and known option values. Once installed, pressing Tab auto-completes Copilot CLI commands in your terminal.
|
||||
|
||||
@@ -3,7 +3,7 @@ title: 'Understanding MCP Servers'
|
||||
description: 'Learn how Model Context Protocol servers extend GitHub Copilot with access to external tools, databases, and APIs.'
|
||||
authors:
|
||||
- GitHub Copilot Learning Hub Team
|
||||
lastUpdated: 2026-04-16
|
||||
lastUpdated: 2026-05-01
|
||||
estimatedReadingTime: '8 minutes'
|
||||
tags:
|
||||
- mcp
|
||||
@@ -179,6 +179,7 @@ These are especially useful for plugins and installer scripts that need to self-
|
||||
Some MCP servers require authentication to connect to protected resources. GitHub Copilot CLI supports several authentication approaches:
|
||||
|
||||
- **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.
|
||||
- **`client_credentials` grant type**: For fully headless environments where no browser is available and no user interaction is possible (such as server-to-server automation or CI pipelines), MCP servers can authenticate using the OAuth `client_credentials` grant type. This enables machine-to-machine authentication without any browser redirect or device code prompt.
|
||||
- **Device code flow (RFC 8628)**: When the CLI runs in a **headless or CI environment** where a browser redirect is not possible, it automatically falls back to the device code flow. You'll see a URL and a code to enter on another device to complete authentication.
|
||||
- **`/mcp auth`**: If a token expires or you need to switch accounts, run `/mcp auth` inside a session. This opens the re-authentication UI for any OAuth-enabled MCP server and supports account switching. You can re-authenticate without restarting the session.
|
||||
- **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.
|
||||
@@ -296,6 +297,10 @@ A: MCP servers run with the same permissions as your user account. Follow least-
|
||||
|
||||
A: There's no hard limit, but each server is a running process. Configure only the servers you actively use. Most projects use 1–3 servers.
|
||||
|
||||
**Q: I'm using an Azure DevOps repository. Will the GitHub MCP server interfere?**
|
||||
|
||||
A: No. Copilot CLI automatically detects Azure DevOps repositories and disables the built-in GitHub MCP server for those sessions. This prevents irrelevant GitHub API calls when your project is hosted on Azure DevOps. Other MCP servers you have configured are unaffected.
|
||||
|
||||
## Next Steps
|
||||
|
||||
- **Build Agents**: [Building Custom Agents](../building-custom-agents/) — Create agents that leverage MCP tools
|
||||
|
||||
Reference in New Issue
Block a user