Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -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-09-07
lastUpdated: 2026-09-08
estimatedReadingTime: '10 minutes'
tags:
- configuration
Expand Down Expand Up @@ -431,9 +431,12 @@ CLI settings use **camelCase** naming. Key settings added in recent releases:
| `stayInAutopilot` | Keep the CLI in autopilot mode after an autopilot task completes, instead of returning to interactive mode (v1.0.69+) |
| `defaultMode` | Startup mode for new interactive sessions (e.g., `interactive`, `autopilot`, `plan`) (v1.0.81+) |
| `defaultPermissionMode` | Default approval behaviour for new interactive sessions, independent from `defaultMode` (v1.0.81+) |
| `editorMode` | Set to `vim` for modal editing (normal/insert modes) in the composer (v1.0.84+) |

> **Note**: Older snake_case names (e.g., `include_gitignored`, `auto_updates_channel`) are still accepted for backward compatibility, but camelCase is now the preferred format.

> **Vim mode (v1.0.84+)**: Toggle modal editing in the prompt composer with `/vim`, or set `editorMode` to `vim` in your configuration to enable it by default. The current mode (normal or insert) is shown while you type.

> **Session restore after a crash (v1.0.81+)**: If the CLI is interrupted unexpectedly — a crash or a machine restart — startup now offers to restore any sessions that were still open, so you don't have to reopen each terminal by hand.

> **Piping an auth token (v1.0.81+)**: Use `copilot login --with-token` to read an authentication token from stdin instead of going through the interactive browser or device-code flow — useful for scripted or containerized setups where a token is already available in the environment.
Expand Down
10 changes: 9 additions & 1 deletion website/src/content/docs/learning-hub/github-copilot-app.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: 'Getting Started with the GitHub Copilot app'
description: 'Learn about the GitHub Copilot app, a desktop experience built for agent-native development. Understand its key features and who it''s for.'
authors:
- GitHub Copilot Learning Hub Team
lastUpdated: 2026-09-02
lastUpdated: 2026-09-08
estimatedReadingTime: '8 minutes'
tags:
- copilot-app
Expand Down Expand Up @@ -92,6 +92,10 @@ For a hands-on guide to building canvases with `/create-canvas`, see [Working wi

This makes Customize a good starting point if you want to extend the app's capabilities but don't need the full `copilot plugin` CLI workflow described in [Installing and Using Plugins](../installing-and-using-plugins/).

> **Install MCP servers via deep link (v1.1.15+)**: An MCP server deep link opens a prefilled review form in Customize so you can confirm the server's configuration before adding it — useful for sharing a one-click setup link with teammates instead of walking them through manual configuration.

The connector catalog continues to grow — for example, a **Power BI MCP server** (v1.1.15+) is now available with both a hosted remote connection and a local server option, alongside existing connectors like Azure DevOps and Figma.

### Agent Merge

**Agent Merge** is a feature that can carry your pull requests through the entire workflow:
Expand All @@ -109,6 +113,8 @@ Agent Merge also understands **stacked pull requests**: it shows a stack summary

From the app, you can request a Copilot code review on a pull request—and re-request a review even from reviewers who already responded—without leaving the session. This keeps the review loop inside the same workspace where the change was made.

You can also attach images and videos to pull request descriptions by pasting, dragging, or selecting files (v1.1.15+), in addition to the existing link action—useful for adding screenshots or screen recordings that show a UI change in action.

## Who is the Copilot app for?

The Copilot app isn't a replacement for existing Copilot experiences—it's another tool in the toolbox. Here's who it serves best:
Expand Down Expand Up @@ -167,6 +173,8 @@ Once installed, you can create a session by:

Each session runs in its own worktree with its own isolated environment. You can run multiple sessions in parallel.

> **The `/goal` command (v1.1.15+)**: Set a persistent objective for autopilot to work towards in a local session with `/goal`. Instead of re-stating your intent after every autopilot continuation, the goal stays attached to the session so the agent keeps making progress toward it across multiple automatic turns.

### Launching Sessions from the Terminal with Deep Links

> **New (v1.0.81+)**: Run `copilot app` from GitHub Copilot CLI to open the GitHub Copilot app directly in the current directory — a quicker alternative to constructing a deep link by hand when you just want to hand off your current working directory to the desktop app.
Expand Down