Add bespoke landing page for Copilot CLI (#59428)

steveward · SiaraMist · Copilot · web-flow · commit 35522a7230c5 · 2026-02-23T23:45:53.000Z
Co-authored-by: SiaraMist &lt;siaramist@github.com&gt;
Co-authored-by: Siara &lt;108543037+SiaraMist@users.noreply.github.com&gt;
Co-authored-by: Copilot &lt;175728472+Copilot@users.noreply.github.com&gt;
Co-authored-by: hubwriter &lt;hubwriter@github.com&gt;
diff --git a/content/copilot/concepts/agents/about-agent-skills.md b/content/copilot/concepts/agents/about-agent-skills.md
@@ -9,6 +9,7 @@ topics:
   - Copilot
 category:
   - Learn about Copilot
+  - Learn about Copilot CLI
 ---
 
 > [!NOTE]
diff --git a/content/copilot/concepts/agents/copilot-cli/about-cli-plugins.md b/content/copilot/concepts/agents/copilot-cli/about-cli-plugins.md
@@ -10,7 +10,8 @@ topics:
   - Copilot
 contentType: concepts
 category:
-  - Learn about Copilot
+  - Learn about Copilot # Copilot discovery page
+  - Learn about Copilot CLI # Copilot CLI bespoke page
 ---
 
 Plugins provide a way to distribute custom CLI functionality. You can use a plugin to add a preconfigured set of capabilities to {% data variables.copilot.copilot_cli_short %}.
diff --git a/content/copilot/concepts/agents/copilot-cli/about-copilot-cli.md b/content/copilot/concepts/agents/copilot-cli/about-copilot-cli.md
@@ -10,7 +10,8 @@ topics:
   - Copilot
 contentType: concepts
 category:
-  - Learn about Copilot
+  - Learn about Copilot # Copilot discovery page
+  - Learn about Copilot CLI # Copilot CLI bespoke page
 redirect_from:
   - /copilot/concepts/agents/about-copilot-cli
 ---
diff --git a/content/copilot/concepts/agents/copilot-cli/autopilot.md b/content/copilot/concepts/agents/copilot-cli/autopilot.md
@@ -9,7 +9,8 @@ topics:
   - CLI
 contentType: concepts
 category:
-  - Learn about Copilot CLI
+  - Learn about Copilot CLI # Copilot CLI bespoke page
+  - Learn about Copilot # Copilot discovery page
 ---
 
 ## Overview
diff --git a/content/copilot/concepts/agents/copilot-cli/comparing-cli-features.md b/content/copilot/concepts/agents/copilot-cli/comparing-cli-features.md
@@ -9,7 +9,8 @@ topics:
   - Copilot
 contentType: concepts
 category:
-  - Learn about Copilot
+  - Learn about Copilot # Copilot discovery page
+  - Learn about Copilot CLI # Copilot CLI bespoke page
 ---
 
 ## Introduction
diff --git a/content/copilot/how-tos/copilot-cli/cli-best-practices.md b/content/copilot/how-tos/copilot-cli/cli-best-practices.md
@@ -9,8 +9,9 @@ topics:
   - Copilot
 contentType: get-started
 category:
-  - Learn about Copilot
-  - Author and optimize with Copilot
+  - Build with Copilot CLI # Copilot CLI bespoke page
+  - Copilot in the CLI # Copilot CLI bespoke page
+  - Author and optimize with Copilot # Copilot discovery page
 ---
 
 ## Introduction
diff --git a/content/copilot/how-tos/copilot-cli/cli-getting-started.md b/content/copilot/how-tos/copilot-cli/cli-getting-started.md
@@ -10,8 +10,9 @@ topics:
   - Copilot
 contentType: get-started
 category:
-  - Learn about Copilot
-  - Author and optimize with Copilot
+  - Build with Copilot CLI # Copilot CLI bespoke page
+  - Quickstarts # Copilot CLI bespoke page
+  - Author and optimize with Copilot # Copilot discovery page
 ---
 
 ## Introduction
diff --git a/content/copilot/how-tos/copilot-cli/customize-copilot/add-custom-instructions.md b/content/copilot/how-tos/copilot-cli/customize-copilot/add-custom-instructions.md
@@ -6,6 +6,9 @@ versions:
   feature: copilot
 topics:
   - Copilot
+category:
+  - Configure Copilot # Copilot discovery page
+  - Configure Copilot CLI # Copilot CLI bespoke page
 redirect_from:
   - /copilot/how-tos/copilot-cli/add-repository-instructions
   - /copilot/how-tos/copilot-cli/add-custom-instructions
diff --git a/content/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli.md b/content/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli.md
@@ -8,8 +8,9 @@ versions:
 topics:
   - Copilot
 category:
-  - Configure Copilot
-  - Author and optimize with Copilot
+  - Configure Copilot # Copilot discovery page
+  - Author and optimize with Copilot # Copilot discovery page
+  - Configure Copilot CLI # Copilot CLI bespoke page
 contentType: how-tos
 ---
 
diff --git a/content/copilot/how-tos/copilot-cli/customize-copilot/create-skills.md b/content/copilot/how-tos/copilot-cli/customize-copilot/create-skills.md
@@ -9,8 +9,9 @@ topics:
   - Copilot
 contentType: how-tos
 category:
-  - Configure Copilot
-  - Author and optimize with Copilot
+  - Configure Copilot # Copilot discovery page
+  - Author and optimize with Copilot # Copilot discovery page
+  - Configure Copilot CLI # Copilot CLI bespoke page
 ---
 
 Agent skills are folders of instructions, scripts, and resources that {% data variables.product.prodname_copilot_short %} can load when relevant to improve its performance in specialized tasks. For more information, see [AUTOTITLE](/copilot/concepts/agents/about-agent-skills).
diff --git a/content/copilot/how-tos/copilot-cli/customize-copilot/plugins-creating.md b/content/copilot/how-tos/copilot-cli/customize-copilot/plugins-creating.md
@@ -8,8 +8,9 @@ versions:
 topics:
   - Copilot
 category:
-  - Configure Copilot
-  - Author and optimize with Copilot
+  - Configure Copilot # Copilot discovery page
+  - Author and optimize with Copilot # Copilot discovery page
+  - Configure Copilot CLI # Copilot CLI bespoke page
 contentType: how-tos
 ---
 
diff --git a/content/copilot/how-tos/copilot-cli/customize-copilot/plugins-finding-installing.md b/content/copilot/how-tos/copilot-cli/customize-copilot/plugins-finding-installing.md
@@ -8,8 +8,9 @@ versions:
 topics:
   - Copilot
 category:
-  - Configure Copilot
-  - Author and optimize with Copilot
+  - Configure Copilot # Copilot discovery page
+  - Author and optimize with Copilot # Copilot discovery page
+  - Configure Copilot CLI # Copilot CLI bespoke page
 contentType: how-tos
 ---
 
diff --git a/content/copilot/how-tos/copilot-cli/customize-copilot/plugins-marketplace.md b/content/copilot/how-tos/copilot-cli/customize-copilot/plugins-marketplace.md
@@ -8,8 +8,9 @@ versions:
 topics:
   - Copilot
 category:
-  - Configure Copilot
-  - Author and optimize with Copilot
+  - Configure Copilot # Copilot discovery page
+  - Author and optimize with Copilot # Copilot discovery page
+  - Configure Copilot CLI # Copilot CLI bespoke page
 contentType: how-tos
 ---
 
diff --git a/content/copilot/how-tos/copilot-cli/customize-copilot/quickstart-for-customizing.md b/content/copilot/how-tos/copilot-cli/customize-copilot/quickstart-for-customizing.md
@@ -9,7 +9,8 @@ topics:
   - Copilot
 contentType: how-tos
 category:
-  - Configure Copilot
+  - Configure Copilot # Copilot discovery page
+  - Configure Copilot CLI # Copilot CLI bespoke page
 ---
 
 You can download and install {% data variables.copilot.copilot_cli_short %}, and start using it straight away, without any additional configuration. However, you'll find that you can improve {% data variables.product.prodname_copilot_short %}'s responses if you spend a little time providing it with guidelines and context, and giving it access to tools that are relevant to your project. This article introduces the various ways in which you can customize {% data variables.copilot.copilot_cli_short %}.
diff --git a/content/copilot/how-tos/copilot-cli/customize-copilot/use-hooks.md b/content/copilot/how-tos/copilot-cli/customize-copilot/use-hooks.md
@@ -7,8 +7,9 @@ versions:
 topics:
   - Copilot
 contentType: how-tos
-category:
-  - Configure Copilot
+category: 
+  - Author and optimize with Copilot # Copilot discovery page
+  - Build with Copilot CLI # Copilot CLI bespoke page
 redirect_from:
   - /copilot/how-tos/copilot-cli/use-hooks
 ---
diff --git a/content/copilot/how-tos/copilot-cli/index.md b/content/copilot/how-tos/copilot-cli/index.md
@@ -1,15 +1,60 @@
 ---
-title: GitHub Copilot CLI
-shortTitle: Copilot CLI
-intro: Learn how to use {% data variables.product.prodname_copilot %} in your terminal.
+title: '{% data variables.copilot.copilot_cli %}'
+shortTitle: '{% data variables.copilot.copilot_cli_short %}'
+intro: 'Use {% data variables.product.prodname_copilot_short %} directly from your terminal to answer questions, write and debug code, and interact with {% data variables.product.github %}.'
 versions:
   feature: copilot
+topics:
+  - Copilot
+contentType: landing
+layout: bespoke-landing
+heroImage: /assets/images/banner-images/hero-4
+sidebarLink:
+  text: All articles
+  href: /copilot/how-tos/copilot-cli
+introLinks:
+  overview: /copilot/concepts/agents/copilot-cli/about-copilot-cli
+  quickstart: /copilot/how-tos/copilot-cli/cli-getting-started
 children:
+  # Top-level articles and sub-categories in the Copilot How-to's are listed at the top of this list. 
+  # This sets the order we show them in the side nav.
+  # All content from other directories and in any sub-directories can be added in any order underneath.
   - /cli-getting-started
   - /cli-best-practices
   - /set-up-copilot-cli
   - /customize-copilot
   - /use-copilot-cli
   - /automate-with-actions
-contentType: how-tos
+  - /content/copilot/concepts/agents/copilot-cli/about-copilot-cli
+  - /content/copilot/concepts/agents/copilot-cli/comparing-cli-features
+  - /content/copilot/concepts/agents/copilot-cli/about-cli-plugins
+  - /content/copilot/concepts/agents/copilot-cli/autopilot
+  - /set-up-copilot-cli/install-copilot-cli
+  - /set-up-copilot-cli/configure-copilot-cli
+  - /customize-copilot/add-custom-instructions
+  - /customize-copilot/create-custom-agents-for-cli
+  - /customize-copilot/create-skills
+  - /customize-copilot/plugins-creating
+  - /customize-copilot/plugins-finding-installing
+  - /customize-copilot/plugins-marketplace
+  - /customize-copilot/quickstart-for-customizing
+  - /customize-copilot/use-hooks
+  - /content/copilot/concepts/agents/about-agent-skills
+  - /content/copilot/reference/cli-command-reference
+  - /content/copilot/reference/hooks-configuration
+  - /content/copilot/reference/cli-plugin-reference
+  - /content/copilot/reference/acp-server
+  - /content/copilot/tutorials/copilot-cli-hooks
+  - /content/copilot/responsible-use/copilot-cli
+carousels:
+  recommended:
+    - /copilot/how-tos/copilot-cli/use-copilot-cli
+    - /copilot/how-tos/copilot-cli/cli-best-practices
+    - /copilot/reference/cli-command-reference
+includedCategories:
+  - Quickstarts
+  - Learn about Copilot CLI
+  - Configure Copilot CLI
+  - Build with Copilot CLI
+  - Administer Copilot CLI
 ---
diff --git a/content/copilot/how-tos/copilot-cli/set-up-copilot-cli/configure-copilot-cli.md b/content/copilot/how-tos/copilot-cli/set-up-copilot-cli/configure-copilot-cli.md
@@ -9,7 +9,8 @@ topics:
   - CLI
 contentType: how-tos
 category:
-  - Configure Copilot
+  - Configure Copilot # Copilot discovery page
+  - Configure Copilot CLI # Copilot CLI bespoke page
 ---
 
 {% data reusables.cli.preview-note-cli %}
diff --git a/content/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli.md b/content/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli.md
@@ -20,7 +20,8 @@ redirect_from:
   - /copilot/how-tos/copilot-cli/install-copilot-cli
 contentType: how-tos
 category:
-  - Configure Copilot
+  - Configure Copilot # Copilot discovery page
+  - Configure Copilot CLI # Copilot CLI bespoke page
 ---
 
 {% data reusables.cli.preview-note-cli %}
diff --git a/content/copilot/how-tos/copilot-cli/use-copilot-cli.md b/content/copilot/how-tos/copilot-cli/use-copilot-cli.md
@@ -13,7 +13,8 @@ topics:
   - CLI
 contentType: how-tos
 category:
-  - Author and optimize with Copilot
+  - Author and optimize with Copilot # Copilot discovery page
+  - Build with Copilot CLI # Copilot CLI bespoke page
 ---
 
 The command-line interface (CLI) for {% data variables.product.prodname_copilot %} allows you to use {% data variables.product.prodname_copilot_short %} directly from your terminal. For more information, see [AUTOTITLE](/copilot/concepts/agents/about-copilot-cli).
diff --git a/content/copilot/index.md b/content/copilot/index.md
@@ -33,4 +33,5 @@ includedCategories:
   - Track Copilot usage
   - Troubleshooting Copilot
   - Responsible use
+  - Copilot in the CLI
 ---
diff --git a/content/copilot/reference/acp-server.md b/content/copilot/reference/acp-server.md
@@ -7,7 +7,8 @@ versions:
 topics:
   - Copilot
 category:
-  - Configure Copilot
+  - Configure Copilot # Copilot discovery page
+  - Configure Copilot CLI # Copilot CLI bespoke page
 contentType: reference
 ---
 
diff --git a/content/copilot/reference/cli-command-reference.md b/content/copilot/reference/cli-command-reference.md
@@ -5,9 +5,10 @@ intro: 'Find commands and keyboard shortcuts to help you use {% data variables.c
 versions:
   feature: copilot
 category:
-  - Author and optimize with Copilot
+  - Author and optimize with Copilot # Copilot discovery page
+  - Build with Copilot CLI # Copilot CLI bespoke landing page
 topics:
-  - Copilot
+  - Copilot 
 contentType: reference
 ---
 
diff --git a/content/copilot/reference/cli-plugin-reference.md b/content/copilot/reference/cli-plugin-reference.md
@@ -5,7 +5,8 @@ intro: 'Find commands and configuration details for CLI plugins.'
 versions:
   feature: copilot
 category:
-  - Author and optimize with Copilot
+  - Author and optimize with Copilot # Copilot discovery page
+  - Configure Copilot CLI # Copilot CLI bespoke page
 topics:
   - Copilot
 contentType: reference
diff --git a/content/copilot/reference/hooks-configuration.md b/content/copilot/reference/hooks-configuration.md
@@ -9,6 +9,7 @@ topics:
 contentType: reference
 category:
   - Configure Copilot
+  - Configure Copilot CLI
 ---
 
 This reference article describes the available hook types with examples, including their input and output formats, script best practices, and advanced patterns for logging, security enforcement, and external integrations. For general information about creating hooks, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/use-hooks). For a tutorial on creating hooks for the CLI, see [AUTOTITLE](/copilot/tutorials/copilot-cli-hooks).
diff --git a/content/copilot/responsible-use/copilot-cli.md b/content/copilot/responsible-use/copilot-cli.md
@@ -16,6 +16,7 @@ redirect_from:
 contentType: rai
 category: 
   - Responsible use
+  - Learn about Copilot CLI
 ---
 
 {% data reusables.cli.preview-note-cli %}
diff --git a/content/copilot/tutorials/copilot-cli-hooks.md b/content/copilot/tutorials/copilot-cli-hooks.md
@@ -8,8 +8,9 @@ versions:
   feature: copilot
 contentType: tutorials
 category:
-  - Accelerate PR velocity
-  - Author and optimize with Copilot
+  - Accelerate PR velocity # Copilot tutorials bespoke page
+  - Author and optimize with Copilot # Copilot discovery page
+  - Administer Copilot CLI # Copilot CLI bespoke page
 allowTitleToDifferFromFilename: true
 ---
 
diff --git a/content/index.md b/content/index.md
@@ -111,11 +111,11 @@ childGroups:
     children:
       - copilot
       - copilot/get-started/plans
-      - copilot/how-tos/get-code-suggestions/get-ide-code-suggestions
       - copilot/how-tos/use-copilot-agents/coding-agent
       - copilot/tutorials
       - copilot/tutorials/copilot-chat-cookbook
       - copilot/tutorials/customization-library
+      - copilot/how-tos/copilot-cli
   - name: CI/CD and DevOps
     octicon: GearIcon
     children:
