Master (#1263)

* order change (#1260)

* AI-115: Add copilot assistant (#1262)

* AI-115: Add copilot assistant

* AI-115: Update Appcircle AI documentation to reflect broader support for AI assistants

---------

Co-authored-by: SarpBakis23 <167063711+SarpBakis23@users.noreply.github.com>
Co-authored-by: nurdincer <116206197+nurdincer@users.noreply.github.com>

Author: 3 people

docs/appcircle-ai/ai-assistants/appcircle-claude-assistant.md

@@ -11,7 +11,7 @@ The **Appcircle Claude Plugin** connects Claude to the Appcircle platform, bundl
 
 ## How to Use Appcircle Claude Assistant
 
-The plugin registers the [Appcircle MCP Server](/appcircle-ai/appcircle-mcp-server) and the following Appcircle-aware skills, automatically namespaced under `appcircle:`:
+The plugin registers the [Appcircle MCP Server](/appcircle-ai/appcircle-mcp-server) and the following Appcircle-aware skills, automatically namespaced under `appcircle`:
 
 | Skill | Purpose |
 |-------|---------|
@@ -29,7 +29,7 @@ Claude Code and claude.ai install the plugin differently, so follow the steps fo
    The MCP server reads this from the process environment, so it must be set before you launch `claude`; exporting it later in an already-running session has no effect until you restart.
 2. Add the Appcircle marketplace:
    ```shell
-   /plugin marketplace add appcircleio/appcircle-claude-plugin
+   /plugin marketplace add appcircleio/appcircle-ai-plugins
    ```
 3. Install the plugin:
    ```shell
@@ -45,22 +45,24 @@ Claude Code and claude.ai install the plugin differently, so follow the steps fo
 
 You can install this plugin's skills in claude.ai too. MCP tools remain Claude Code-only for now.
 
-1. Click **Customize > Create plugin > Add marketplace**.
+1. Click **Customize > Plugins > Add > Add marketplace**.
 
-   <img src="https://cdn.appcircle.io/docs/assets/claude-assistant-1.png" alt="Create plugin, Add marketplace" width="480" style={{display: 'block', margin: 0}} />
+   <img src="https://cdn.appcircle.io/docs/assets/AI-115-claude-plugin.png" alt="Create plugin, Add marketplace" width="480" style={{display: 'block', margin: 0}} />
 
 2. You will see the following screen.
 
    <img src="https://cdn.appcircle.io/docs/assets/claude-assistant-2.png" alt="Add marketplace screen" width="480" style={{display: 'block', margin: 0}} />
 
-3. Enter the repository URL: `https://github.com/appcircleio/appcircle-claude-plugin`
+3. Enter the repository URL: `https://github.com/appcircleio/appcircle-ai-plugins`
 
-   <img src="https://cdn.appcircle.io/docs/assets/claude-assistant-3.png" alt="Enter the repository URL" width="480" style={{display: 'block', margin: 0}} />
+   <img src="https://cdn.appcircle.io/docs/assets/AI-115-claude-plugin-2.png" alt="Enter the repository URL" width="480" style={{display: 'block', margin: 0}} />
 
-4. Click **Sync**.
+4. Click **Sync**, then click **+**.
 
-   <img src="https://cdn.appcircle.io/docs/assets/claude-assistant-4.png" alt="Click Sync" width="480" style={{display: 'block', margin: 0}} />
+   <img src="https://cdn.appcircle.io/docs/assets/AI-115-claude-plugin-3.png" alt="Click Sync" width="480" style={{display: 'block', margin: 0}} />
 
 5. Ask Claude an Appcircle question, for example *How do I set up automatic code signing for my iOS builds*, and Claude will use the `doc-assistant` skill to answer.
 
-To access the source code of this plugin, please use [this link](https://github.com/appcircleio/appcircle-claude-plugin).
+To access the source code of this plugin, please use the following link:
+
+https://github.com/appcircleio/appcircle-ai-plugins

docs/appcircle-ai/ai-assistants/appcircle-copilot-assistant.md

@@ -0,0 +1,53 @@
+---
+title: Appcircle Copilot Assistant
+description: Use the Appcircle Copilot Plugin to connect GitHub Copilot to the Appcircle platform with MCP tools and Appcircle-aware skills.
+tags: [appcircle ai, copilot, assistant]
+sidebar_position: 4
+---
+
+# Appcircle Copilot Assistant
+
+The **Appcircle Copilot Plugin** connects GitHub Copilot to the Appcircle platform, bundling the [Appcircle MCP Server](/appcircle-ai/appcircle-mcp-server) with Appcircle-aware skills so you can ask Copilot about your Appcircle organization or how to use Appcircle.
+
+## How to Use Appcircle Copilot Assistant
+
+The plugin registers the [Appcircle MCP Server](/appcircle-ai/appcircle-mcp-server) and the following Appcircle-aware skills:
+
+| Skill | Purpose |
+|-------|---------|
+| `doc-assistant` | Answers Appcircle questions using official sources (`docs.appcircle.io` and `appcircle.io`) |
+| `build-insights-report` | Renders a visual Build Insights Report (health & trends, root cause, workflow quality, artifact health, queue time, and CI maturity) from the `get_build_insights_report` MCP tool. See [Build Insights](/appcircle-ai/ai-insights/build-insights) for the full metric reference |
+
+### In GitHub Copilot CLI
+
+1. *(Optional, for MCP tools)* Before starting Copilot CLI, set your [Appcircle Access Token](https://github.com/appcircleio/appcircle-mcp/blob/main/docs/appcircle_access_token.md) in your shell so the MCP server can authenticate:
+   ```bash
+   export APPCIRCLE_ACCESS_TOKEN=<your-access-token>
+   ```
+   The MCP server reads this from the process environment, so it must be set before you launch `copilot`; exporting it later in an already-running session has no effect until you restart.
+2. Add the Appcircle marketplace:
+   ```shell
+   copilot plugin marketplace add appcircleio/appcircle-ai-plugins
+   ```
+3. Install the plugin:
+   ```shell
+   copilot plugin install appcircle@appcircle-ai-plugins
+   ```
+4. Ask Copilot an Appcircle question. For "how do I" or troubleshooting questions, for example "How do I set up automatic code signing for my iOS builds," Copilot uses the `doc-assistant` skill. For questions about your own organization, for example "List my build profiles," Copilot uses the Appcircle MCP tools, which requires step 1.
+
+### In VS Code
+
+1. *(Optional, for MCP tools)* Set your [Appcircle Access Token](https://github.com/appcircleio/appcircle-mcp/blob/main/docs/appcircle_access_token.md) so the bundled MCP server can authenticate. You can export it before launching VS Code, or supply it when prompted after installing the plugin.
+2. Click **Chat Settings** -> **Plugins** -> **Install Plugin from Source**.
+
+   <img src="https://cdn.appcircle.io/docs/assets/AI-115-vscode-plugin.png" alt="Enter the repository URL" width="480" style={{display: 'block', margin: 0}} />
+
+3. Enter the repository URL: `https://github.com/appcircleio/appcircle-ai-plugins`
+
+   <img src="https://cdn.appcircle.io/docs/assets/AI-115-vscode-plugin-2.png" alt="Enter the repository URL" width="480" style={{display: 'block', margin: 0}} />
+
+4. Open Copilot Chat and ask an Appcircle question, for example "How do I set up automatic code signing for my iOS builds" or "List my build profiles."
+
+To access the source code of this plugin, please use the following link:
+
+https://github.com/appcircleio/appcircle-ai-plugins

docs/appcircle-ai/ai-assistants/index.md

@@ -1,15 +1,15 @@
 ---
 title: AI Assistants
-description: Discover the Appcircle AI assistants available on ChatGPT and Claude for quick answers, step-by-step guidance, and troubleshooting support.
-tags: [appcircle ai, assistant, gpt, claude]
+description: Discover the Appcircle AI assistants available on ChatGPT, Claude, and GitHub Copilot for quick answers, step-by-step guidance, and troubleshooting support.
+tags: [appcircle ai, assistant, gpt, claude, copilot]
 sidebar_position: 1
 ---
 
 import ContentRef from '@site/src/components/ContentRef';
 
 # AI Assistants
 
-Appcircle provides AI assistants on both ChatGPT and Claude so you can get quick answers, step-by-step guidance, and troubleshooting support wherever you already work. 
+Appcircle provides AI assistants on ChatGPT, Claude, and GitHub Copilot so you can get quick answers, step-by-step guidance, and troubleshooting support wherever you already work. 
 
 ## [Appcircle GPT Assistant](/appcircle-ai/ai-assistants/appcircle-gpt-assistant)
 
@@ -22,3 +22,9 @@ Use the Appcircle GPT Assistant in the OpenAI Marketplace for quick answers, ste
 Use the Appcircle Claude Plugin to connect Claude to the Appcircle platform with MCP tools and Appcircle-aware skills for quick answers, step-by-step guidance, and troubleshooting support.
 
 <ContentRef url="/appcircle-ai/ai-assistants/appcircle-claude-assistant">Appcircle Claude Assistant</ContentRef>
+
+## [Appcircle Copilot Assistant](/appcircle-ai/ai-assistants/appcircle-copilot-assistant)
+
+Use the Appcircle Copilot Plugin to connect GitHub Copilot to the Appcircle platform with MCP tools and Appcircle-aware skills for quick answers, step-by-step guidance, and troubleshooting support.
+
+<ContentRef url="/appcircle-ai/ai-assistants/appcircle-copilot-assistant">Appcircle Copilot Assistant</ContentRef>

docs/appcircle-ai/ai-insights/build-insights.md

@@ -1,6 +1,6 @@
 ---
 title: Build Insights
-description: Understand the Appcircle Build Insights Report - every section and metric returned by the get_build_insights_report MCP tool, and how to generate the visual report with the Appcircle Claude Assistant.
+description: Understand the Appcircle Build Insights Report - every section and metric returned by the get_build_insights_report MCP tool, and how to generate the visual report with the Appcircle Claude Assistant or Appcircle Copilot Assistant.
 tags: [appcircle ai, ai insights, build insights]
 sidebar_position: 1
 ---
@@ -10,14 +10,19 @@ import Screenshot from '@site/src/components/Screenshot';
 
 # Build Insights Report
 
-The **Build Insights Report** gives you a snapshot of your CI health: build trends, failure root causes, workflow quality, artifact health, queue time, and an overall maturity score. Use the [Appcircle Claude Assistant](/appcircle-ai/ai-assistants/appcircle-claude-assistant) to get a visual report, or use the [Appcircle MCP client](/appcircle-ai/appcircle-mcp-server) directly.
+The **Build Insights Report** gives you a snapshot of your CI health: build trends, failure root causes, workflow quality, artifact health, queue time, and an overall maturity score. Use the [Appcircle Claude Assistant](/appcircle-ai/ai-assistants/appcircle-claude-assistant) or [Appcircle Copilot Assistant](/appcircle-ai/ai-assistants/appcircle-copilot-assistant) to get a visual report, or use the [Appcircle MCP client](/appcircle-ai/appcircle-mcp-server) directly.
 
 ## How to Generate a Report
 
 **With the Appcircle Claude Assistant**
 
 - Ask in natural language, for example *give me a build insights report for last month* or *how is our CI maturity*.
-- The `appcircle:build-insights-report` skill makes one call to `get_build_insights_report` and renders the response as a report.
+- The `build-insights-report` skill makes one call to `get_build_insights_report` and renders the response as a report.
+
+**With the Appcircle Copilot Assistant**
+
+- Ask in natural language, for example *give me a build insights report for last month* or *how is our CI maturity*.
+- The `build-insights-report` skill makes one call to `get_build_insights_report` and renders the response as a report.
 
 **With Any Other MCP Client**
 
@@ -113,9 +118,9 @@ How long builds waited before starting, tree-wide for the period:
 
 The last 30 days, compared against the 30 days before that for deltas. Pass `start_date` and `end_date` to the tool to use a different window; the tool compares it against a preceding period of the same length.
 
-### Can I Get This Report Outside the Appcircle Claude Assistant?
+### Can I Get This Report Outside the Appcircle Claude or Copilot Assistant?
 
-Yes, for the underlying data. Any MCP client can call `get_build_insights_report` and get the same metrics as JSON. The visual HTML report rendering shown on this page is produced by the `appcircle:build-insights-report` skill, which is currently exclusive to the [Appcircle Claude Assistant](/appcircle-ai/ai-assistants/appcircle-claude-assistant).
+Yes, for the underlying data. Any MCP client can call `get_build_insights_report` and get the same metrics as JSON. The visual HTML report rendering shown on this page is produced by the `build-insights-report` skill, which is currently exclusive to the [Appcircle Claude Assistant](/appcircle-ai/ai-assistants/appcircle-claude-assistant) and [Appcircle Copilot Assistant](/appcircle-ai/ai-assistants/appcircle-copilot-assistant).
 
 ### Why Is a Section Missing From My Report?
 

docs/appcircle-ai/ai-insights/index.md

@@ -11,7 +11,7 @@ import ContentRef from '@site/src/components/ContentRef';
 
 Turn your build history into answers. AI Insights reads your Appcircle CI data and turns it into clear, actionable reports: trends, root causes, and a maturity score at a glance, without building dashboards yourself.
 
-You generate these reports with the [Appcircle Claude Assistant](/appcircle-ai/ai-assistants/appcircle-claude-assistant) for a visual view, or through the [Appcircle MCP client](/appcircle-ai/appcircle-mcp-server) for the same data as structured JSON.
+You generate these reports with the [Appcircle Claude Assistant](/appcircle-ai/ai-assistants/appcircle-claude-assistant) or [Appcircle Copilot Assistant](/appcircle-ai/ai-assistants/appcircle-copilot-assistant) for a visual view, or through the [Appcircle MCP client](/appcircle-ai/appcircle-mcp-server) for the same data as structured JSON.
 
 ## [Build Insights Report](/appcircle-ai/ai-insights/build-insights)
 

docs/appcircle-ai/index.md

@@ -19,7 +19,7 @@ The Appcircle MCP Server exposes Appcircle platform capabilities through the Mod
 
 ## [AI Assistants](/appcircle-ai/ai-assistants)
 
-Use the Appcircle GPT Assistant and Appcircle Claude Assistant for quick answers, step-by-step guidance, and troubleshooting support.
+Appcircle supports a wide variety of AI assistants across multiple vendors for quick answers, step-by-step guidance, and troubleshooting support.
 
 <ContentRef url="/appcircle-ai/ai-assistants">AI Assistants</ContentRef>
 

docs/release-notes.md

@@ -20,9 +20,9 @@ import RedisDomainCaution from '@site/docs/self-hosted-appcircle/install-server/
 
 ### 🆕 New Features
 
-- [External Webhooks](/build/manage-the-connections/reconnect-change-provider#external-webhooks) have been introduced for Build profiles, enabling incoming webhook connections to be monitored from the Appcircle UI. <BuildBadge/> <CloudBadge/>
-- App Review Attachment upload support has been added for iOS Publish metadata, allowing review assets to be uploaded and managed as part of the publish flow. <PublishBadge/> <CloudBadge/>
 - [Manual certificate renewal](/signing-identities/apple-certificates#manual-renew-certificate) support has been added for Apple certificates in Signing Identities. <SigningIdentitiesBadge/> <CloudBadge/>
+- App Review Attachment upload support has been added for iOS Publish metadata, allowing review assets to be uploaded and managed as part of the publish flow. <PublishBadge/> <CloudBadge/>
+- [External Webhooks](/build/manage-the-connections/reconnect-change-provider#external-webhooks) have been introduced for Build profiles, enabling incoming webhook connections to be monitored from the Appcircle UI. <BuildBadge/> <CloudBadge/>
 - [Auth Activity Log](/account/my-organization/profile-and-team/auth-activity-log) support has been added to the Organization module, providing visibility into user login, logout, and organization switch events. <AccountBadge/> <CloudBadge/>
 - Introduced the [Appcircle Claude Assistant](/appcircle-ai/ai-assistants/appcircle-claude-assistant), a Claude plugin skill that provides answers about Appcircle, including step-by-step instructions and troubleshooting support, along with the new [Build Insights Report](/appcircle-ai/ai-insights) skill and MCP tool, which generates a CI health report covering maturity, trends, root cause, workflow quality, artifact health, and queue time. <CloudBadge/>
 

docs/tags.yml

@@ -3223,6 +3223,11 @@ quay:
   description: "Documentation related to Claude"
   permalink: "/claude"
 
+"copilot":
+  label: "copilot"
+  description: "Documentation related to GitHub Copilot"
+  permalink: "/copilot"
+
 "assistant":
   label: "assistant"
   description: "Documentation related to AI assistants"