From 1b15663c46736d82ad56600d0a0f5dd3842f1a88 Mon Sep 17 00:00:00 2001 From: Copilot <198982749+Copilot@users.noreply.github.com> Date: Fri, 6 Mar 2026 16:26:26 +1100 Subject: [PATCH] Update docs to reflect awesome-copilot as default plugin marketplace in CLI and VS Code (#901) * Initial plan * docs: update plugin discovery for default marketplace in CLI and VS Code Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com> * docs: revert README.md changes (covered by #900), update README.plugins.md Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com> * fix: update plugin template in constants.mjs so README.plugins.md survives rebuilds Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com> --- docs/README.plugins.md | 15 +++++--- eng/constants.mjs | 15 +++++--- .../installing-and-using-plugins.md | 19 ++++++++--- website/src/pages/plugins.astro | 34 +++++++++++++++++++ 4 files changed, 69 insertions(+), 14 deletions(-) diff --git a/docs/README.plugins.md b/docs/README.plugins.md index dd3afb0b..284d3c7e 100644 --- a/docs/README.plugins.md +++ b/docs/README.plugins.md @@ -1,6 +1,8 @@ # 🔌 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 +15,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 | | ---- | ----------- | ----- | ---- | diff --git a/eng/constants.mjs b/eng/constants.mjs index 50f85cb8..21a11053 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 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 94eb44d5..28bc8795 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 52bff369..c7f49fbf 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'; + +