From 18a4734b1eff5989983f2c1c4067b861e15239bb Mon Sep 17 00:00:00 2001 From: Aaron Powell Date: Fri, 12 Jun 2026 13:09:02 +1000 Subject: [PATCH 1/2] Add GitHub Copilot app learning hub page - Create new learning hub page covering Copilot app basics, features, and use cases - Include information about target audiences (developers, non-dev roles, teams with parallel work) - Highlight key features: My Work view, isolated worktrees, canvases, Agent Merge - Add installation and getting started instructions - Update learning hub index to include app in Getting Started section Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- .../docs/learning-hub/github-copilot-app.md | 225 ++++++++++++++++++ .../src/content/docs/learning-hub/index.md | 13 +- 2 files changed, 233 insertions(+), 5 deletions(-) create mode 100644 website/src/content/docs/learning-hub/github-copilot-app.md diff --git a/website/src/content/docs/learning-hub/github-copilot-app.md b/website/src/content/docs/learning-hub/github-copilot-app.md new file mode 100644 index 000000000..d844e7dcc --- /dev/null +++ b/website/src/content/docs/learning-hub/github-copilot-app.md @@ -0,0 +1,225 @@ +--- +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-06-12 +estimatedReadingTime: '8 minutes' +tags: + - copilot-app + - desktop + - agents + - parallel-work +relatedArticles: + - ./using-copilot-coding-agent.md + - ./agentic-workflows.md + - ./what-are-agents-skills-instructions.md +prerequisites: + - Understanding of GitHub Copilot agents + - Copilot Pro, Pro+, Business, or Enterprise plan +--- + +The GitHub Copilot app is a desktop experience built from the ground up for agent-native development. As agents become a central part of your development workflow, you need a place where you can see multiple agents working in parallel, inspect their progress, and take control when needed—all without context-switching between windows or losing track of what's running. + +This guide covers what the Copilot app is, its key features, and how to get started. + +## What Is the GitHub Copilot App? + +The Copilot app is a standalone desktop application that serves as a control center for agentic development. Instead of managing agents through GitHub.com pull requests, issues, and CLI windows, the Copilot app brings everything into one unified interface. + +Think of it as a command center where you can: +- See all your active work at a glance +- Spin up multiple agents working on different tasks simultaneously +- Inspect what each agent is doing in real time +- Redirect agents mid-task or approve their changes +- Let agents handle automation (like merging PRs) while you focus elsewhere + +The key difference from existing Copilot experiences is that the app is purpose-built for parallel agent work. It handles the complexity of managing multiple isolated environments, branches, and worktrees automatically, so you don't have to. + +## Key Features + +### My Work View + +The central hub of the Copilot app is the **My Work** view. This dashboard shows: + +- **Active sessions**: Each agent working on a task gets its own isolated session +- **Issues and PRs**: Your inbox of work items from connected repositories +- **Background automations**: Tasks running in the background, like Agent Merge handling your pull requests +- **Overall status**: A quick overview of what's in progress, what's done, and what's blocked + +Instead of checking GitHub, your CLI, and VS Code for updates, everything is in one place. + +### Isolated Worktrees for Parallel Work + +Each session the Copilot app creates runs in its own **git worktree**—a real, isolated copy of your branch. This is critical for parallel agent work: + +- Multiple agents can work on different tasks simultaneously without stepping on each other +- Each agent has its own branch, its own environment, and its own changes +- No manual branch juggling or cleanup required—the app handles it all +- You can pick up a session from any device, on any worktree + +This makes it easy to dispatch multiple agents and trust they won't interfere with each other. + +### Canvases + +**Canvases** are interactive work surfaces where you and agents collaborate. Instead of long chat threads, a canvas shows the actual work: + +- A canvas might display a plan, a pull request diff, a terminal output, or a live browser session +- Agents update the canvas as they work, and you can edit, approve, or redirect changes on the same surface +- This makes it easy to see exactly what an agent is doing and step in when needed + +Learn more about [working with canvases](/learning-hub/). + +### Agent Merge (Automations) + +**Agent Merge** is an automation feature that can carry your pull requests through the entire workflow: + +- Monitors CI/CD pipelines and waits for checks to pass +- Addresses failing tests or linting errors +- Tracks required reviewers and waits for approval +- Can automatically merge when all conditions are met + +You control the automation level—decide whether Agent Merge should just run CI, address feedback, or go all the way to merging. It's a way to let Copilot handle the tedious parts of the review and merge process. + +## 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: + +### Developers Who Want to Direct Multiple Agents + +If you're using agents regularly and need to manage parallel work, the Copilot app gives you a dedicated control center. Instead of checking multiple windows, you see everything in one place. + +### Team Members in Non-Developer Roles + +The Copilot app has a more accessible, desktop-first interface compared to developer-centric experiences like VS Code or the CLI. This makes it appealing to business analysts, product managers, and other technical team members who want to work with agents but find traditional developer tools overwhelming. + +### Teams Leveraging Parallel Agent Work + +The app's worktree architecture makes it natural to dispatch multiple agents on different tasks without coordination. If your team frequently has agents working on multiple initiatives simultaneously, the app is built for this workflow. + +### Developers Who Prefer a Graphical Interface + +While the CLI is powerful, some developers prefer a visual interface for common tasks. The Copilot app provides a GUI-first experience while still surfacing all the power of agents, hooks, skills, and custom instructions. + +### Comparison with Other Copilot Experiences + +| Experience | Best For | Strength | +|------------|----------|----------| +| **Copilot CLI** | Developers in the terminal | Raw power, scriptable, always available in your shell | +| **VS Code extension** | Coding and real-time AI assistance | Integrated with your editor, instant feedback | +| **GitHub.com** | Code review and PR management | Central hub for collaboration, always accessible on web | +| **Copilot App** | Directing parallel agents, visual workflow | Control center for agentic development, multi-agent management | + +The Copilot app complements these experiences—you'll still use VS Code for coding, the CLI for automation, and GitHub.com for collaboration. The Copilot app fills a specific gap: managing multiple agents in parallel with a unified interface. + +## Getting Started + +### Requirements + +To use the GitHub Copilot app, you need: + +- A **GitHub Copilot Pro, Pro+, Business, or Enterprise plan** +- A compatible operating system (macOS, Windows, or Linux) +- Connected GitHub repositories + +### Installation + +1. Visit [GitHub Copilot App](https://github.com/features/ai/github-app) and download the installer for your platform +2. Install and launch the app +3. Authenticate with your GitHub account +4. Connect your repositories + +### Creating Your First Session + +Once installed, you can create a session by: + +1. **From an issue**: Assign a GitHub issue to Copilot, and the app will create a session to work on it +2. **From a prompt**: Open the Copilot app and describe what you want done (e.g., "Fix the login bug" or "Add dark mode support") +3. **From your inbox**: The app syncs your GitHub inbox—click an issue and start a session for it + +Each session runs in its own worktree with its own isolated environment. You can run multiple sessions in parallel. + +### Understanding Session Workflow + +Here's what happens when you create a session: + +``` +1. You describe the work or assign an issue + ↓ +2. Copilot app creates an isolated worktree + ↓ +3. The agent reads your issue, instructions, and codebase + ↓ +4. It plans and implements a solution + ↓ +5. You can monitor progress in the My Work view + ↓ +6. You can redirect the agent or let it finish + ↓ +7. Changes are ready for review (either a PR or approval) +``` + +### Connecting Repositories + +To give Copilot access to your repositories: + +1. In the Copilot app, open **Settings** → **Connected Repositories** +2. Click **Add Repository** and select repositories from your GitHub account +3. Grant the necessary permissions +4. The app now has access to your code, issues, and pull requests + +## Using the Copilot App with Your Custom Configuration + +The Copilot app respects all your existing GitHub Copilot customizations: + +- **Custom agents** (`.agent.md` files in `.github/agents/`) +- **Skills** (specialized task guidance in `.github/skills/`) +- **Instructions** (coding standards in `.github/instructions/`) +- **Hooks** (automated checks and formatting in `.github/hooks/`) +- **Setup steps** (`.github/copilot-setup-steps.yml`) + +When you create a session in the Copilot app, the agent automatically loads your repository's configuration and runs with your custom setup. No additional configuration needed. + +If you haven't set up custom agents, skills, or instructions yet, see [Copilot Configuration Basics](../copilot-configuration-basics/) to get started. + +## Common Workflows + +### Parallel Bug Fixes + +Create multiple sessions to fix different bugs simultaneously: + +1. Open the Copilot app +2. Create a session for "Fix login timeout issue" +3. While that's running, create another session for "Fix dark mode button styling" +4. Monitor both in the My Work view +5. Review and merge each PR independently + +### Parallel Feature Development + +Assign multiple features to agents on different sprints: + +1. Connect your issue tracker +2. Let Copilot pull features from your backlog +3. Create a session for each feature +4. Each agent works independently in its own worktree +5. PRs land without interfering with each other + +### Automated PR Merge with Agent Merge + +Enable Agent Merge to automate routine PR workflows: + +1. Configure Agent Merge in the Copilot app settings +2. Specify what automations to enable (run CI, address feedback, merge) +3. Create a session to implement a feature +4. When the PR is created, Agent Merge monitors it +5. It runs CI, waits for reviews, addresses feedback, and merges when ready + +## Next Steps + +- **Set Up Your Repository**: [Copilot Configuration Basics](../copilot-configuration-basics/) — Add custom agents, skills, and instructions +- **Create Specialized Agents**: [Building Custom Agents](../building-custom-agents/) — Design agents for specific types of work +- **Understand Agent Skills**: [Creating Effective Skills](../creating-effective-skills/) — Build reusable task guidance +- **Automate with Hooks**: [Automating with Hooks](../automating-with-hooks/) — Add guardrails to autonomous work +- **Learn About Agentic Workflows**: [Agentic Workflows](../agentic-workflows/) — Orchestrate complex multi-agent tasks + +--- diff --git a/website/src/content/docs/learning-hub/index.md b/website/src/content/docs/learning-hub/index.md index 3cfe85bf9..8b35f34ec 100644 --- a/website/src/content/docs/learning-hub/index.md +++ b/website/src/content/docs/learning-hub/index.md @@ -4,6 +4,14 @@ description: "Curated articles, walkthroughs, and reference material to help you tableOfContents: false --- +## Getting Started + +New to GitHub Copilot? Start here to understand the tools available to you. + +**Desktop App**: Explore the [GitHub Copilot App](github-copilot-app/) — a control center for directing multiple agents in parallel. Perfect for agent-native development and parallel work with isolated worktrees. + +**Terminal**: Looking for a guided path into GitHub Copilot from the terminal? Explore the [Copilot CLI for Beginners](cli-for-beginners/) with a text-based experience or the [YouTube video series](https://www.youtube.com/watch?v=BDxRhhs36ns&list=PL0lo9MOBetEHvO-spzKBAITkkTqv4RvNl). + ## Fundamentals Essential concepts to tailor GitHub Copilot beyond its default experience. Start with @@ -22,8 +30,3 @@ for definitions of common terms and concepts. Interactive samples and recipes to learn by doing. Jump into the [Cookbook](cookbook/) for code samples, recipes, and examples you can use right away. - -## Copilot CLI for Beginners - -Looking for a guided path into GitHub Copilot from the terminal? Explore Copilot CLI for Beginners! You can work through a -[text based experience](cli-for-beginners/) for a text-based experience, or the [YouTube video series](https://www.youtube.com/watch?v=BDxRhhs36ns&list=PL0lo9MOBetEHvO-spzKBAITkkTqv4RvNl). From 4dbb133a07905bec7ca4798019d31cea13187095 Mon Sep 17 00:00:00 2001 From: Aaron Powell Date: Fri, 12 Jun 2026 13:32:28 +1000 Subject: [PATCH 2/2] Refine GitHub Copilot app learning hub page - Add the app to the learning hub navigation - Tighten the page copy around audiences, features, and getting started - Keep canvases and automations high level as requested Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- website/astro.config.mjs | 36 ++++++++++--------- .../docs/learning-hub/github-copilot-app.md | 24 ++++++------- 2 files changed, 32 insertions(+), 28 deletions(-) diff --git a/website/astro.config.mjs b/website/astro.config.mjs index bec1e33bb..644babf4f 100644 --- a/website/astro.config.mjs +++ b/website/astro.config.mjs @@ -62,30 +62,19 @@ export default defineConfig({ }, }, ], - customCss: ["./src/styles/starlight-overrides.css", "./src/styles/global.css"], + customCss: [ + "./src/styles/starlight-overrides.css", + "./src/styles/global.css", + ], editLink: { baseUrl: "https://github.com/github/awesome-copilot/edit/staged/website/", }, sidebar: [ - { - label: "Browse Resources", - items: [ - { label: "Home", link: "/" }, - { label: "Agents", link: "/agents/" }, - { label: "Instructions", link: "/instructions/" }, - { label: "Skills", link: "/skills/" }, - { label: "Hooks", link: "/hooks/" }, - { label: "Workflows", link: "/workflows/" }, - { label: "Canvas Extensions", link: "/extensions/" }, - { label: "Plugins", link: "/plugins/" }, - { label: "Tools", link: "/tools/" }, - { label: "Contributors", link: "/contributors/" }, - ], - }, { label: "Fundamentals", items: [ + "learning-hub/github-copilot-app", "learning-hub/what-are-agents-skills-instructions", "learning-hub/agents-and-subagents", "learning-hub/understanding-copilot-context", @@ -131,6 +120,21 @@ export default defineConfig({ }, ], }, + { + label: "Browse Resources", + items: [ + { label: "Home", link: "/" }, + { label: "Agents", link: "/agents/" }, + { label: "Instructions", link: "/instructions/" }, + { label: "Skills", link: "/skills/" }, + { label: "Hooks", link: "/hooks/" }, + { label: "Workflows", link: "/workflows/" }, + { label: "Canvas Extensions", link: "/extensions/" }, + { label: "Plugins", link: "/plugins/" }, + { label: "Tools", link: "/tools/" }, + { label: "Contributors", link: "/contributors/" }, + ], + }, ], disable404Route: true, // pagefind: true is required so Starlight renders the search UI. diff --git a/website/src/content/docs/learning-hub/github-copilot-app.md b/website/src/content/docs/learning-hub/github-copilot-app.md index d844e7dcc..340bc6df5 100644 --- a/website/src/content/docs/learning-hub/github-copilot-app.md +++ b/website/src/content/docs/learning-hub/github-copilot-app.md @@ -1,5 +1,5 @@ --- -title: 'Getting Started with the GitHub Copilot App' +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 @@ -19,11 +19,11 @@ prerequisites: - Copilot Pro, Pro+, Business, or Enterprise plan --- -The GitHub Copilot app is a desktop experience built from the ground up for agent-native development. As agents become a central part of your development workflow, you need a place where you can see multiple agents working in parallel, inspect their progress, and take control when needed—all without context-switching between windows or losing track of what's running. +The GitHub Copilot app is a desktop experience built from the ground up for agent-native development. As agents become a central part of your development workflow, you need a place where you can see multiple agents working in parallel, inspect their progress, and take control when needed, all without context-switching between windows or losing track of what's running. This guide covers what the Copilot app is, its key features, and how to get started. -## What Is the GitHub Copilot App? +## What Is the GitHub Copilot app? The Copilot app is a standalone desktop application that serves as a control center for agentic development. Instead of managing agents through GitHub.com pull requests, issues, and CLI windows, the Copilot app brings everything into one unified interface. @@ -49,6 +49,12 @@ The central hub of the Copilot app is the **My Work** view. This dashboard shows Instead of checking GitHub, your CLI, and VS Code for updates, everything is in one place. +### Automations + +The Copilot app includes built-in automations that can run scheduled tasks for you using the same agentic technology. You can use templates out of the box or create your own. + +Automations run in the context of a repository, so they can access issues, pull requests, and code. You can also choose whether they run as a plan, an interactive session, or on autopilot. + ### Isolated Worktrees for Parallel Work Each session the Copilot app creates runs in its own **git worktree**—a real, isolated copy of your branch. This is critical for parallel agent work: @@ -68,11 +74,9 @@ This makes it easy to dispatch multiple agents and trust they won't interfere wi - Agents update the canvas as they work, and you can edit, approve, or redirect changes on the same surface - This makes it easy to see exactly what an agent is doing and step in when needed -Learn more about [working with canvases](/learning-hub/). +### Agent Merge -### Agent Merge (Automations) - -**Agent Merge** is an automation feature that can carry your pull requests through the entire workflow: +**Agent Merge** is a feature that can carry your pull requests through the entire workflow: - Monitors CI/CD pipelines and waits for checks to pass - Addresses failing tests or linting errors @@ -81,7 +85,7 @@ Learn more about [working with canvases](/learning-hub/). You control the automation level—decide whether Agent Merge should just run CI, address feedback, or go all the way to merging. It's a way to let Copilot handle the tedious parts of the review and merge process. -## Who Is the Copilot App For? +## 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: @@ -178,8 +182,6 @@ The Copilot app respects all your existing GitHub Copilot customizations: - **Hooks** (automated checks and formatting in `.github/hooks/`) - **Setup steps** (`.github/copilot-setup-steps.yml`) -When you create a session in the Copilot app, the agent automatically loads your repository's configuration and runs with your custom setup. No additional configuration needed. - If you haven't set up custom agents, skills, or instructions yet, see [Copilot Configuration Basics](../copilot-configuration-basics/) to get started. ## Common Workflows @@ -217,9 +219,7 @@ Enable Agent Merge to automate routine PR workflows: ## Next Steps - **Set Up Your Repository**: [Copilot Configuration Basics](../copilot-configuration-basics/) — Add custom agents, skills, and instructions -- **Create Specialized Agents**: [Building Custom Agents](../building-custom-agents/) — Design agents for specific types of work - **Understand Agent Skills**: [Creating Effective Skills](../creating-effective-skills/) — Build reusable task guidance - **Automate with Hooks**: [Automating with Hooks](../automating-with-hooks/) — Add guardrails to autonomous work -- **Learn About Agentic Workflows**: [Agentic Workflows](../agentic-workflows/) — Orchestrate complex multi-agent tasks ---