From eb9893e712d809ff5e585989a482cbc8ae53cfe2 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 6 Mar 2026 04:59:36 +0000 Subject: [PATCH 1/4] Initial plan From 8f9c5c427be2f4a73df518110c90c74e3960f147 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 6 Mar 2026 05:03:28 +0000 Subject: [PATCH 2/4] docs: update plugin discovery for default marketplace in CLI and VS Code Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com> --- README.md | 18 ++++++---- .../installing-and-using-plugins.md | 19 ++++++++--- website/src/pages/plugins.astro | 34 +++++++++++++++++++ 3 files changed, 60 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 9c374261b..afe6fe958 100644 --- a/README.md +++ b/README.md @@ -65,22 +65,26 @@ An [`llms.txt`](https://awesome-copilot.github.com/llms.txt) file following the Plugins are installable packages that bundle related agents and skills, making it easy to install a curated set of resources. -#### Installing Plugins +#### Browsing Plugins -First, add the Awesome Copilot marketplace to your Copilot CLI: +**Awesome Copilot is a default plugin marketplace** — no setup required in Copilot CLI or VS Code. -```bash -copilot plugin marketplace add github/awesome-copilot +**GitHub Copilot CLI** — browse from within an interactive session: + +``` +/plugin marketplace browse awesome-copilot ``` -Then install any plugin: +**VS Code** — use the Extensions search view with `@agentPlugins`, or open the Command Palette and run `Chat: Plugins`. + +#### Installing Plugins + +Install any plugin directly by name: ```bash copilot plugin install @awesome-copilot ``` -Alternatively, you can use the `/plugin` command within a Copilot chat session to browse and install plugins interactively. - ### 🤖 Custom Agents Custom agents can be used in Copilot coding agent (CCA), VS Code, and Copilot CLI (coming soon). For CCA, when assigning an issue to Copilot, select the custom agent from the provided list. In VS Code, you can activate the custom agent in the agents session, alongside built-in agents like Plan and Agent. diff --git a/website/src/content/learning-hub/installing-and-using-plugins.md b/website/src/content/learning-hub/installing-and-using-plugins.md index 94eb44d53..28bc87955 100644 --- a/website/src/content/learning-hub/installing-and-using-plugins.md +++ b/website/src/content/learning-hub/installing-and-using-plugins.md @@ -94,12 +94,12 @@ Plugins are especially valuable when you want to: ## Finding Plugins -Plugins are collected in **marketplaces** — registries you can browse and install from. Copilot CLI comes with two marketplaces registered by default: +Plugins are collected in **marketplaces** — registries you can browse and install from. Both Copilot CLI and VS Code come with two marketplaces registered by default — **no setup required**: - **`copilot-plugins`** — Official GitHub Copilot plugins - **`awesome-copilot`** — Community-contributed plugins from this repository -### Browsing a Marketplace +### Browsing in Copilot CLI List your registered marketplaces: @@ -121,6 +121,13 @@ Or from within an interactive Copilot session: > **Tip**: You can also browse plugins on this site's [Plugins Directory](../../plugins/) to see descriptions, included agents, and skills before installing. +### Browsing in VS Code + +Because `awesome-copilot` is a default marketplace in VS Code, you can discover plugins without any configuration: + +- Open the **Extensions** search view and type **`@agentPlugins`** to see all available plugins +- Or open the **Command Palette** (`Ctrl+Shift+P` / `Cmd+Shift+P`) and run **Chat: Plugins** + ### Adding More Marketplaces Register additional marketplaces from GitHub repositories: @@ -137,9 +144,9 @@ copilot plugin marketplace add /path/to/local-marketplace ## Installing Plugins -### From a Registered Marketplace +### From Copilot CLI -The most common way to install a plugin — reference it by name and marketplace: +Reference a plugin by name and marketplace: ```bash copilot plugin install database-data-management@awesome-copilot @@ -151,6 +158,10 @@ Or from an interactive session: /plugin install database-data-management@awesome-copilot ``` +### From VS Code + +Browse to the plugin via `@agentPlugins` in the Extensions search view or via **Chat: Plugins** in the Command Palette, then click **Install**. + ## Managing Plugins Once installed, plugins are managed with a few simple commands: diff --git a/website/src/pages/plugins.astro b/website/src/pages/plugins.astro index 52bff369f..c7f49fbf5 100644 --- a/website/src/pages/plugins.astro +++ b/website/src/pages/plugins.astro @@ -11,6 +11,15 @@ import PageHeader from '../components/PageHeader.astro';
+
+

Awesome Copilot is a default plugin marketplace — no setup required. Access it directly from your tools:

+
    +
  • GitHub Copilot CLI: Type /plugin marketplace browse awesome-copilot in a Copilot session
    • +
  • VS Code: Type @agentPlugins in the Extensions search view, or open the Command Palette and run Chat: Plugins
    • +
+

Install any plugin with: copilot plugin install <plugin-name>@awesome-copilot

+
+
@@ -44,4 +53,29 @@ import PageHeader from '../components/PageHeader.astro'; + + From 2849d91704d0081d40ab1bedb139945e304e1161 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 6 Mar 2026 05:14:23 +0000 Subject: [PATCH 3/4] docs: revert README.md changes (covered by #900), update README.plugins.md Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com> --- README.md | 18 +++++++----------- docs/README.plugins.md | 16 +++++++++++----- 2 files changed, 18 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index afe6fe958..9c374261b 100644 --- a/README.md +++ b/README.md @@ -65,26 +65,22 @@ An [`llms.txt`](https://awesome-copilot.github.com/llms.txt) file following the Plugins are installable packages that bundle related agents and skills, making it easy to install a curated set of resources. -#### Browsing Plugins - -**Awesome Copilot is a default plugin marketplace** — no setup required in Copilot CLI or VS Code. +#### Installing Plugins -**GitHub Copilot CLI** — browse from within an interactive session: +First, add the Awesome Copilot marketplace to your Copilot CLI: -``` -/plugin marketplace browse awesome-copilot +```bash +copilot plugin marketplace add github/awesome-copilot ``` -**VS Code** — use the Extensions search view with `@agentPlugins`, or open the Command Palette and run `Chat: Plugins`. - -#### Installing Plugins - -Install any plugin directly by name: +Then install any plugin: ```bash copilot plugin install @awesome-copilot ``` +Alternatively, you can use the `/plugin` command within a Copilot chat session to browse and install plugins interactively. + ### 🤖 Custom Agents Custom agents can be used in Copilot coding agent (CCA), VS Code, and Copilot CLI (coming soon). For CCA, when assigning an issue to Copilot, select the custom agent from the provided list. In VS Code, you can activate the custom agent in the agents session, alongside built-in agents like Plan and Agent. diff --git a/docs/README.plugins.md b/docs/README.plugins.md index dd3afb0be..b2d678b89 100644 --- a/docs/README.plugins.md +++ b/docs/README.plugins.md @@ -1,6 +1,9 @@ # 🔌 Plugins -Curated plugins of related agents and skills organized around specific themes, workflows, or use cases. Plugins can be installed directly via GitHub Copilot CLI. +Curated plugins of related agents and skills organized around specific themes, workflows, or use cases. Plugins can be installed directly via GitHub Copilot CLI or VS Code. + +> **Awesome Copilot is a default plugin marketplace** — no setup required in either Copilot CLI or VS Code. + ### How to Contribute See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-plugins) for guidelines on how to contribute new plugins, improve existing ones, and share your use cases. @@ -13,10 +16,13 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-plugins) for guidelines on how t - Each plugin includes agents and skills for specific workflows - Plugins make it easy to adopt comprehensive toolkits for particular scenarios -**Install Plugins:** -- Use \`copilot plugin install @awesome-copilot\` to install a plugin -- Or browse to the individual files to copy content manually -- Plugins help you discover related customizations you might have missed +**Find & Install in Copilot CLI:** +- Browse the marketplace from within an interactive Copilot session: `/plugin marketplace browse awesome-copilot` +- Install a plugin: `copilot plugin install @awesome-copilot` + +**Find & Install in VS Code:** +- Open the Extensions search view and type `@agentPlugins` to browse available plugins +- Or open the Command Palette and run `Chat: Plugins` | Name | Description | Items | Tags | | ---- | ----------- | ----- | ---- | From 0e5645028cf819c7c06940ade307e2c08532d63c Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 6 Mar 2026 05:24:34 +0000 Subject: [PATCH 4/4] fix: update plugin template in constants.mjs so README.plugins.md survives rebuilds Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com> --- docs/README.plugins.md | 9 ++++----- eng/constants.mjs | 15 ++++++++++----- 2 files changed, 14 insertions(+), 10 deletions(-) diff --git a/docs/README.plugins.md b/docs/README.plugins.md index b2d678b89..284d3c7ed 100644 --- a/docs/README.plugins.md +++ b/docs/README.plugins.md @@ -3,7 +3,6 @@ Curated plugins of related agents and skills organized around specific themes, workflows, or use cases. Plugins can be installed directly via GitHub Copilot CLI or VS Code. > **Awesome Copilot is a default plugin marketplace** — no setup required in either Copilot CLI or VS Code. - ### How to Contribute See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-plugins) for guidelines on how to contribute new plugins, improve existing ones, and share your use cases. @@ -17,12 +16,12 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-plugins) for guidelines on how t - Plugins make it easy to adopt comprehensive toolkits for particular scenarios **Find & Install in Copilot CLI:** -- Browse the marketplace from within an interactive Copilot session: `/plugin marketplace browse awesome-copilot` -- Install a plugin: `copilot plugin install @awesome-copilot` +- Browse the marketplace from within an interactive Copilot session: \`/plugin marketplace browse awesome-copilot\` +- Install a plugin: \`copilot plugin install @awesome-copilot\` **Find & Install in VS Code:** -- Open the Extensions search view and type `@agentPlugins` to browse available plugins -- Or open the Command Palette and run `Chat: Plugins` +- Open the Extensions search view and type \`@agentPlugins\` to browse available plugins +- Or open the Command Palette and run \`Chat: Plugins\` | Name | Description | Items | Tags | | ---- | ----------- | ----- | ---- | diff --git a/eng/constants.mjs b/eng/constants.mjs index 50f85cb8b..21a11053b 100644 --- a/eng/constants.mjs +++ b/eng/constants.mjs @@ -27,7 +27,9 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-instructions) for guidelines on pluginsSection: `## 🔌 Plugins -Curated plugins of related agents and skills organized around specific themes, workflows, or use cases. Plugins can be installed directly via GitHub Copilot CLI.`, +Curated plugins of related agents and skills organized around specific themes, workflows, or use cases. Plugins can be installed directly via GitHub Copilot CLI or VS Code. + +> **Awesome Copilot is a default plugin marketplace** — no setup required in either Copilot CLI or VS Code.`, pluginsUsage: `### How to Contribute @@ -41,10 +43,13 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-plugins) for guidelines on how t - Each plugin includes agents and skills for specific workflows - Plugins make it easy to adopt comprehensive toolkits for particular scenarios -**Install Plugins:** -- Use \\\`copilot plugin install @awesome-copilot\\\` to install a plugin -- Or browse to the individual files to copy content manually -- Plugins help you discover related customizations you might have missed`, +**Find & Install in Copilot CLI:** +- Browse the marketplace from within an interactive Copilot session: \\\`/plugin marketplace browse awesome-copilot\\\` +- Install a plugin: \\\`copilot plugin install @awesome-copilot\\\` + +**Find & Install in VS Code:** +- Open the Extensions search view and type \\\`@agentPlugins\\\` to browse available plugins +- Or open the Command Palette and run \\\`Chat: Plugins\\\``, featuredPluginsSection: `## 🌟 Featured Plugins