mia-code 0.2.0 → 0.3.0

package/references/copilot/acp/agents.md

@@ -0,0 +1,32 @@
+> ## Documentation Index
+> Fetch the complete documentation index at: https://agentclientprotocol.com/llms.txt
+> Use this file to discover all available pages before exploring further.
+
+# Agents
+
+> Agents implementing the Agent Client Protocol.
+
+The following agents can be used with an ACP Client:
+
+* [AgentPool](https://phil65.github.io/agentpool/advanced/acp-integration/)
+* [Augment Code](https://docs.augmentcode.com/cli/acp)
+* [Blackbox AI](https://docs.blackbox.ai/features/blackbox-cli/introduction)
+* [Claude Code](https://docs.anthropic.com/en/docs/claude-code/overview) (via [Zed's SDK adapter](https://github.com/zed-industries/claude-code-acp))
+* [Codex CLI](https://developers.openai.com/codex/cli) (via [Zed's adapter](https://github.com/zed-industries/codex-acp))
+* [Code Assistant](https://github.com/stippi/code-assistant?tab=readme-ov-file#configuration)
+* [Docker's cagent](https://github.com/docker/cagent)
+* [fast-agent](https://fast-agent.ai/acp)
+* [Gemini CLI](https://github.com/google-gemini/gemini-cli)
+* [GitHub Copilot](https://github.com/features/copilot) (in [public preview](https://github.blog/changelog/2026-01-28-acp-support-in-copilot-cli-is-now-in-public-preview/))
+* [Goose](https://block.github.io/goose/docs/guides/acp-clients)
+* [JetBrains Junie *(coming soon)*](https://www.jetbrains.com/junie/)
+* [Kimi CLI](https://github.com/MoonshotAI/kimi-cli)
+* [Minion Code](https://github.com/femto/minion-code)
+* [Mistral Vibe](https://github.com/mistralai/mistral-vibe)
+* [OpenCode](https://github.com/sst/opencode)
+* [OpenHands](https://docs.openhands.dev/openhands/usage/run-openhands/acp)
+* [Pi](https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent) (via [pi-acp adapter](https://github.com/svkozak/pi-acp))
+* [Qoder CLI](https://docs.qoder.com/cli/acp)
+* [Qwen Code](https://github.com/QwenLM/qwen-code)
+* [Stakpak](https://github.com/stakpak/agent?tab=readme-ov-file#agent-client-protocol-acp)
+* [VT Code](https://github.com/vinhnx/vtcode/blob/main/README.md#zed-ide-integration-agent-client-protocol)

package/references/copilot/acp/architecture.md

@@ -0,0 +1,37 @@
+> ## Documentation Index
+> Fetch the complete documentation index at: https://agentclientprotocol.com/llms.txt
+> Use this file to discover all available pages before exploring further.
+
+# Architecture
+
+> Overview of the Agent Client Protocol architecture.
+
+The Agent Client Protocol defines a standard interface for communication between AI agents and client applications. The architecture is designed to be flexible, extensible, and platform-agnostic.
+
+## Design Philosophy
+
+The protocol architecture follows several key principles:
+
+1. **MCP-friendly**: The protocol is built on JSON-RPC, and re-uses MCP types where possible so that integrators don't need to build yet-another representation for common data types.
+2. **UX-first**: It is designed to solve the UX challenges of interacting with AI agents; ensuring there's enough flexibility to render clearly the agents intent, but is no more abstract than it needs to be.
+3. **Trusted**: ACP works when you're using a code editor to talk to a model you trust. You still have controls over the agent's tool calls, but the code editor gives the agent access to local files and MCP servers.
+
+## Setup
+
+When the user tries to connect to an agent, the editor boots the agent sub-process on demand, and all communication happens over stdin/stdout.
+
+Each connection can support several concurrent sessions, so you can have multiple trains of thought going on at once.
+
+<img src="https://mintcdn.com/zed-685ed6d6/FgcZrIi8cEeJJGHC/images/server-client.svg?fit=max&auto=format&n=FgcZrIi8cEeJJGHC&q=85&s=90242ce890be80f96c4c1a6166e3c057" alt="Server Client setup" data-og-width="579" width="579" data-og-height="455" height="455" data-path="images/server-client.svg" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/zed-685ed6d6/FgcZrIi8cEeJJGHC/images/server-client.svg?w=280&fit=max&auto=format&n=FgcZrIi8cEeJJGHC&q=85&s=bd917ddb677e6b23cdc2a19346390822 280w, https://mintcdn.com/zed-685ed6d6/FgcZrIi8cEeJJGHC/images/server-client.svg?w=560&fit=max&auto=format&n=FgcZrIi8cEeJJGHC&q=85&s=1d05c343199c6051ca57040276d3cd60 560w, https://mintcdn.com/zed-685ed6d6/FgcZrIi8cEeJJGHC/images/server-client.svg?w=840&fit=max&auto=format&n=FgcZrIi8cEeJJGHC&q=85&s=d60766a694ef1485b14044538777260d 840w, https://mintcdn.com/zed-685ed6d6/FgcZrIi8cEeJJGHC/images/server-client.svg?w=1100&fit=max&auto=format&n=FgcZrIi8cEeJJGHC&q=85&s=60a044b75725dd10573c2a5a9d10b103 1100w, https://mintcdn.com/zed-685ed6d6/FgcZrIi8cEeJJGHC/images/server-client.svg?w=1650&fit=max&auto=format&n=FgcZrIi8cEeJJGHC&q=85&s=c8755a1d971c8c0c374077a622ce2873 1650w, https://mintcdn.com/zed-685ed6d6/FgcZrIi8cEeJJGHC/images/server-client.svg?w=2500&fit=max&auto=format&n=FgcZrIi8cEeJJGHC&q=85&s=53540d5df78b7c0e400a33632b95ef8e 2500w" />
+
+ACP makes heavy use of JSON-RPC notifications to allow the agent to stream updates to the UI in real-time. It also uses JSON-RPC's bidirectional requests to allow the agent to make requests of the code editor: for example to request permissions for a tool call.
+
+## MCP
+
+Commonly the code editor will have user-configured MCP servers. When forwarding the prompt from the user, it passes configuration for these to the agent. This allows the agent to connect directly to the MCP server.
+
+<img src="https://mintcdn.com/zed-685ed6d6/FgcZrIi8cEeJJGHC/images/mcp.svg?fit=max&auto=format&n=FgcZrIi8cEeJJGHC&q=85&s=4208d22ec64bdf11af53b1778df72c8c" alt="MCP Server connection" data-og-width="689" width="689" data-og-height="440" height="440" data-path="images/mcp.svg" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/zed-685ed6d6/FgcZrIi8cEeJJGHC/images/mcp.svg?w=280&fit=max&auto=format&n=FgcZrIi8cEeJJGHC&q=85&s=9442d9a54ca427398580ae7a483cf4ad 280w, https://mintcdn.com/zed-685ed6d6/FgcZrIi8cEeJJGHC/images/mcp.svg?w=560&fit=max&auto=format&n=FgcZrIi8cEeJJGHC&q=85&s=44ab3b84da5c6b81bbf67d9228c7316b 560w, https://mintcdn.com/zed-685ed6d6/FgcZrIi8cEeJJGHC/images/mcp.svg?w=840&fit=max&auto=format&n=FgcZrIi8cEeJJGHC&q=85&s=fefa396575e4ad81ba6123284c394d5d 840w, https://mintcdn.com/zed-685ed6d6/FgcZrIi8cEeJJGHC/images/mcp.svg?w=1100&fit=max&auto=format&n=FgcZrIi8cEeJJGHC&q=85&s=80fddbbee7c96dcb961204e3fbb24507 1100w, https://mintcdn.com/zed-685ed6d6/FgcZrIi8cEeJJGHC/images/mcp.svg?w=1650&fit=max&auto=format&n=FgcZrIi8cEeJJGHC&q=85&s=28bc64ceb8091ec50d58903e8132bd6f 1650w, https://mintcdn.com/zed-685ed6d6/FgcZrIi8cEeJJGHC/images/mcp.svg?w=2500&fit=max&auto=format&n=FgcZrIi8cEeJJGHC&q=85&s=049676f3e8a20c01fd0e169032041fc8 2500w" />
+
+The code editor may itself also wish to export MCP based tools. Instead of trying to run MCP and ACP on the same socket, the code editor can provide its own MCP server as configuration. As agents may only support MCP over stdio, the code editor can provide a small proxy that tunnels requests back to itself:
+
+<img src="https://mintcdn.com/zed-685ed6d6/FgcZrIi8cEeJJGHC/images/mcp-proxy.svg?fit=max&auto=format&n=FgcZrIi8cEeJJGHC&q=85&s=ce25c0e525d70d48044da2d9841d6f83" alt="MCP connection to self" data-og-width="632" width="632" data-og-height="440" height="440" data-path="images/mcp-proxy.svg" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/zed-685ed6d6/FgcZrIi8cEeJJGHC/images/mcp-proxy.svg?w=280&fit=max&auto=format&n=FgcZrIi8cEeJJGHC&q=85&s=4fdf7e888ab64e9a77cda096c3115354 280w, https://mintcdn.com/zed-685ed6d6/FgcZrIi8cEeJJGHC/images/mcp-proxy.svg?w=560&fit=max&auto=format&n=FgcZrIi8cEeJJGHC&q=85&s=22e6dec61324e2a4f4ee82d9c0624563 560w, https://mintcdn.com/zed-685ed6d6/FgcZrIi8cEeJJGHC/images/mcp-proxy.svg?w=840&fit=max&auto=format&n=FgcZrIi8cEeJJGHC&q=85&s=0d7a261ba0002c913174de587490728f 840w, https://mintcdn.com/zed-685ed6d6/FgcZrIi8cEeJJGHC/images/mcp-proxy.svg?w=1100&fit=max&auto=format&n=FgcZrIi8cEeJJGHC&q=85&s=6dd1a0f7deb4d4da801ce6613dd4c180 1100w, https://mintcdn.com/zed-685ed6d6/FgcZrIi8cEeJJGHC/images/mcp-proxy.svg?w=1650&fit=max&auto=format&n=FgcZrIi8cEeJJGHC&q=85&s=a9927bfa96f59759d50525163732b511 1650w, https://mintcdn.com/zed-685ed6d6/FgcZrIi8cEeJJGHC/images/mcp-proxy.svg?w=2500&fit=max&auto=format&n=FgcZrIi8cEeJJGHC&q=85&s=711e54a4c2195fd9183baf3e021f719c 2500w" />

package/references/copilot/acp/clients.md

@@ -0,0 +1,31 @@
+> ## Documentation Index
+> Fetch the complete documentation index at: https://agentclientprotocol.com/llms.txt
+> Use this file to discover all available pages before exploring further.
+
+# Clients
+
+> Clients implementing the Agent Client Protocol.
+
+The following clients can be used with an ACP Agent:
+
+* [Agent Studio](https://github.com/sxhxliang/agent-studio)
+* [Agmente](https://agmente.halliharp.com) (iOS)
+* [AionUi](https://github.com/iOfficeAI/AionUi)
+* [aizen](https://aizen.win)
+* [DeepChat](https://github.com/ThinkInAIXYZ/deepchat)
+* DuckDB
+  * through the [sidequery/duckdb-acp](https://github.com/sidequery/duckdb-acp) extension
+* Emacs via [agent-shell.el](https://github.com/xenodium/agent-shell)
+* [JetBrains](https://www.jetbrains.com/help/ai-assistant/acp.html)
+* [marimo notebook](https://github.com/marimo-team/marimo)
+* [neovim](https://neovim.io)
+  * through the [CodeCompanion](https://github.com/olimorris/codecompanion.nvim) plugin
+  * through the [carlos-algms/agentic.nvim](https://github.com/carlos-algms/agentic.nvim) plugin
+  * through the [yetone/avante.nvim](https://github.com/yetone/avante.nvim) plugin
+* [Obsidian](https://obsidian.md)
+  * through the [Agent Client](https://github.com/RAIT-09/obsidian-agent-client) plugin
+* [Sidequery *(coming soon)*](https://sidequery.dev)
+* [Tidewave](https://tidewave.ai/)
+* [Toad](https://www.batrachian.ai/)
+* [Web Browser with AI SDK](https://github.com/mcpc-tech/ai-elements-remix-template) (powered by [@mcpc/acp-ai-provider](https://github.com/mcpc-tech/mcpc/tree/main/packages/acp-ai-provider))
+* [Zed](https://zed.dev/docs/ai/external-agents)

package/references/copilot/acp/introduction.md

@@ -0,0 +1,42 @@
+> ## Documentation Index
+> Fetch the complete documentation index at: https://agentclientprotocol.com/llms.txt
+> Use this file to discover all available pages before exploring further.
+
+# Introduction
+
+> Get started with the Agent Client Protocol.
+
+The Agent Client Protocol (ACP) standardizes communication between code editors/IDEs and coding agents and is suitable for both local and remote scenarios.
+
+## Why ACP?
+
+AI coding agents and editors are tightly coupled but interoperability isn't the default. Each editor must build custom integrations for every agent they want to support, and agents must implement editor-specific APIs to reach users.
+This creates several problems:
+
+* Integration overhead: Every new agent-editor combination requires custom work
+* Limited compatibility: Agents work with only a subset of available editors
+* Developer lock-in: Choosing an agent often means accepting their available interfaces
+
+ACP solves this by providing a standardized protocol for agent-editor communication, similar to how the [Language Server Protocol (LSP)](https://microsoft.github.io/language-server-protocol/) standardized language server integration.
+
+Agents that implement ACP work with any compatible editor. Editors that support ACP gain access to the entire ecosystem of ACP-compatible agents.
+This decoupling allows both sides to innovate independently while giving developers the freedom to choose the best tools for their workflow.
+
+## Overview
+
+ACP assumes that the user is primarily in their editor, and wants to reach out and use agents to assist them with specific tasks.
+
+ACP is suitable for both local and remote scenarios:
+
+* **Local agents** run as sub-processes of the code editor, communicating via JSON-RPC over stdio.
+* **Remote agents** can be hosted in the cloud or on separate infrastructure, communicating over HTTP or WebSocket
+
+<Info>
+  Full support for remote agents is a work in progress. We are actively
+  collaborating with agentic platforms to ensure the protocol addresses the
+  specific requirements of cloud-hosted and remote deployment scenarios.
+</Info>
+
+The protocol re-uses the JSON representations used in MCP where possible, but includes custom types for useful agentic coding UX elements, like displaying diffs.
+
+The default format for user-readable text is Markdown, which allows enough flexibility to represent rich formatting without requiring that the code editor is capable of rendering HTML.

package/references/copilot/acp/registry.md

@@ -0,0 +1,339 @@
+> ## Documentation Index
+> Fetch the complete documentation index at: https://agentclientprotocol.com/llms.txt
+> Use this file to discover all available pages before exploring further.
+
+# ACP Registry
+
+> The easiest way to find and install ACP-compatible agents.
+
+<style>
+  {`
+    .agent-icon {
+    width: 20px;
+    height: 20px;
+    color: currentColor;
+    }
+    `}
+</style>
+
+## Overview
+
+The ACP Registry is an easy way for developers to distribute their ACP-compatible agents to any client that speaks the protocol.
+
+At the moment, this is a curated set of agents, including only the ones that [support authentication](/rfds/auth-methods).
+
+Visit [the registry repository on GitHub](https://github.com/agentclientprotocol/registry) to learn more about it.
+
+<Warning>
+  The registry is under active development, so expect its format and contents to
+  change.
+</Warning>
+
+## Available Agents
+
+<CardGroup cols={3}>
+  <Card
+    title="Auggie CLI"
+    href="https://github.com/augmentcode/auggie-zed-extension"
+    icon={
+    <svg
+      width="20"
+      height="20"
+      className="agent-icon"
+      aria-hidden="true"
+      focusable="false"
+      xmlns="http://www.w3.org/2000/svg"
+      fill="none"
+      viewBox="0 0 16 16"
+    >
+      <path
+        fill="currentColor"
+        d="M9.972 13.193h2.577q.187 0 .277-.09t.091-.294V10.47q0-.324.133-.59.135-.27.36-.424a1 1 0 0 1 .099-.06 1 1 0 0 1-.1-.058 1.1 1.1 0 0 1-.359-.424 1.3 1.3 0 0 1-.133-.59v-2.33q0-.202-.091-.293t-.277-.089H9.972a.38.38 0 0 1-.294-.124.4.4 0 0 1-.108-.281q.002-.176.131-.293a.46.46 0 0 1 .313-.111h2.775c.36 0 .642.097.836.288q.293.29.294.832V8.24q0 .39.152.562.148.168.555.178a.4.4 0 0 1 .27.128.41.41 0 0 1 .104.287.44.44 0 0 1-.1.282.34.34 0 0 1-.277.132c-.266.006-.452.066-.55.177q-.151.174-.152.573v2.318c0 .235-.043.44-.128.607a.85.85 0 0 1-.389.387 1.3 1.3 0 0 1-.534.124V14h-2.854a.45.45 0 0 1-.315-.118.38.38 0 0 1-.129-.286q0-.164.109-.282a.38.38 0 0 1 .293-.123zM1.103 9.108a.4.4 0 0 1 .276-.128q.4-.008.55-.177.15-.173.151-.562V5.923q.002-.543.294-.832c.195-.191.477-.288.836-.288h2.775q.188 0 .313.111a.37.37 0 0 1 .131.293.4.4 0 0 1-.108.281.38.38 0 0 1-.293.123H3.45q-.186 0-.277.09t-.092.292v2.33c0 .213-.044.413-.133.59a1.1 1.1 0 0 1-.359.424 1 1 0 0 1-.1.059 1 1 0 0 1 .1.059q.225.156.359.423t.133.59v2.34q0 .203.092.293.088.09.277.089h2.577a.38.38 0 0 1 .294.123q.108.12.108.281a.38.38 0 0 1-.13.286.45.45 0 0 1-.314.118l-2.775-.003a1.4 1.4 0 0 1-.613-.126.87.87 0 0 1-.388-.387 1.34 1.34 0 0 1-.129-.608v-2.318q0-.4-.151-.572-.151-.168-.55-.177a.35.35 0 0 1-.278-.132.42.42 0 0 1-.102-.28q0-.173.103-.287"
+      />
+      <path
+        fill="currentColor"
+        d="M5.437 10.36a.986.986 0 0 1-.994-.975c0-.538.446-.976.994-.976s.994.438.994.976a.986.986 0 0 1-.994.976M10.562 8.41c.548 0 .994.437.994.975a.986.986 0 0 1-.994.976.986.986 0 0 1-.994-.976c0-.538.446-.976.994-.976M8.74 2c.37 0 .446.15.446.275v.034q0 .034-.009.201-.01.162-.017.549-.018.378-.044 1.06c0 .106-.065.233-.375.233-.311 0-.376-.126-.376-.23l-.07-1.835v-.003c0-.13.078-.284.446-.284M7.256 2c.369 0 .446.15.446.275v.034q0 .034-.01.201-.007.162-.017.549-.017.378-.043 1.06c0 .106-.065.233-.376.233-.31 0-.375-.126-.375-.23l-.07-1.835v-.003C6.81 2.154 6.887 2 7.256 2"
+      />
+    </svg>
+  }
+  >
+    <p class="text-xs mt-3">
+      <code>0.15.0</code>
+    </p>
+  </Card>
+
+  <Card
+    title="Claude Code"
+    href="https://github.com/zed-industries/claude-code-acp"
+    icon={
+    <svg
+      width="20"
+      height="20"
+      className="agent-icon"
+      aria-hidden="true"
+      focusable="false"
+      xmlns="http://www.w3.org/2000/svg"
+      viewBox="0 0 1200 1200"
+    >
+      <path
+        fill="currentColor"
+        d="M 233.959793 800.214905 L 468.644287 668.536987 L 472.590637 657.100647 L 468.644287 650.738403 L 457.208069 650.738403 L 417.986633 648.322144 L 283.892639 644.69812 L 167.597321 639.865845 L 54.926208 633.825623 L 26.577238 627.785339 L 3.3e-05 592.751709 L 2.73832 575.27533 L 26.577238 559.248352 L 60.724873 562.228149 L 136.187973 567.382629 L 249.422867 575.194763 L 331.570496 580.026978 L 453.261841 592.671082 L 472.590637 592.671082 L 475.328857 584.859009 L 468.724915 580.026978 L 463.570557 575.194763 L 346.389313 495.785217 L 219.543671 411.865906 L 153.100723 363.543762 L 117.181267 339.060425 L 99.060455 316.107361 L 91.248367 266.01355 L 123.865784 230.093994 L 167.677887 233.073853 L 178.872513 236.053772 L 223.248367 270.201477 L 318.040283 343.570496 L 441.825592 434.738342 L 459.946411 449.798706 L 467.194672 444.64447 L 468.080597 441.020203 L 459.946411 427.409485 L 392.617493 305.718323 L 320.778564 181.932983 L 288.80542 130.630859 L 280.348999 99.865845 C 277.369171 87.221436 275.194641 76.590698 275.194641 63.624268 L 312.322174 13.20813 L 332.8591 6.604126 L 382.389313 13.20813 L 403.248352 31.328979 L 434.013519 101.71814 L 483.865753 212.537048 L 561.181274 363.221497 L 583.812134 407.919434 L 595.892639 449.315491 L 600.40271 461.959839 L 608.214783 461.959839 L 608.214783 454.711609 L 614.577271 369.825623 L 626.335632 265.61084 L 637.771851 131.516846 L 641.718201 93.745117 L 660.402832 48.483276 L 697.530334 24.000122 L 726.52356 37.852417 L 750.362549 72 L 747.060486 94.067139 L 732.886047 186.201416 L 705.100708 330.52356 L 686.979919 427.167847 L 697.530334 427.167847 L 709.61084 415.087341 L 758.496704 350.174561 L 840.644348 247.490051 L 876.885925 206.738342 L 919.167847 161.71814 L 946.308838 140.29541 L 997.61084 140.29541 L 1035.38269 196.429626 L 1018.469849 254.416199 L 965.637634 321.422852 L 921.825562 378.201538 L 859.006714 462.765259 L 819.785278 530.41626 L 823.409424 535.812073 L 832.75177 534.92627 L 974.657776 504.724915 L 1051.328979 490.872559 L 1142.818848 475.167786 L 1184.214844 494.496582 L 1188.724854 514.147644 L 1172.456421 554.335693 L 1074.604126 578.496765 L 959.838989 601.449829 L 788.939636 641.879272 L 786.845764 643.409485 L 789.261841 646.389343 L 866.255127 653.637634 L 899.194702 655.409424 L 979.812134 655.409424 L 1129.932861 666.604187 L 1169.154419 692.537109 L 1192.671265 724.268677 L 1188.724854 748.429688 L 1128.322144 779.194641 L 1046.818848 759.865845 L 856.590759 714.604126 L 791.355774 698.335754 L 782.335693 698.335754 L 782.335693 703.731567 L 836.69812 756.885986 L 936.322205 846.845581 L 1061.073975 962.81897 L 1067.436279 991.490112 L 1051.409424 1014.120911 L 1034.496704 1011.704712 L 924.885986 929.234924 L 882.604126 892.107544 L 786.845764 811.48999 L 780.483276 811.48999 L 780.483276 819.946289 L 802.550415 852.241699 L 919.087341 1027.409424 L 925.127625 1081.127686 L 916.671204 1098.604126 L 886.469849 1109.154419 L 853.288696 1103.114136 L 785.073914 1007.355835 L 714.684631 899.516785 L 657.906067 802.872498 L 650.979858 806.81897 L 617.476624 1167.704834 L 601.771851 1186.147705 L 565.530212 1200 L 535.328857 1177.046997 L 519.302124 1139.919556 L 535.328857 1066.550537 L 554.657776 970.792053 L 570.362488 894.68457 L 584.536926 800.134277 L 592.993347 768.724976 L 592.429626 766.630859 L 585.503479 767.516968 L 514.22821 865.369263 L 405.825531 1011.865906 L 320.053711 1103.677979 L 299.516815 1111.812256 L 263.919525 1093.369263 L 267.221497 1060.429688 L 287.114136 1031.114136 L 405.825531 880.107361 L 477.422913 786.52356 L 523.651062 732.483276 L 523.328918 724.671265 L 520.590698 724.671265 L 205.288605 929.395935 L 149.154434 936.644409 L 124.993355 914.01355 L 127.973183 876.885986 L 139.409409 864.80542 L 234.201385 799.570435 L 233.879227 799.8927 Z"
+      />
+    </svg>
+  }
+  >
+    <p class="text-xs mt-3">
+      <code>0.13.2</code>
+    </p>
+  </Card>
+
+  <Card
+    title="Codex CLI"
+    href="https://github.com/zed-industries/codex-acp"
+    icon={
+    <svg
+      width="20"
+      height="20"
+      className="agent-icon"
+      aria-hidden="true"
+      focusable="false"
+      xmlns="http://www.w3.org/2000/svg"
+      viewBox="0 0 24 24"
+    >
+      <path
+        fill="currentColor"
+        d="M22.282 9.821a5.985 5.985 0 0 0-.516-4.91 6.046 6.046 0 0 0-6.51-2.9A6.065 6.065 0 0 0 4.981 4.18a5.985 5.985 0 0 0-3.998 2.9 6.046 6.046 0 0 0 .743 7.097 5.98 5.98 0 0 0 .51 4.911 6.051 6.051 0 0 0 6.515 2.9A5.985 5.985 0 0 0 13.26 24a6.056 6.056 0 0 0 5.772-4.206 5.99 5.99 0 0 0 3.997-2.9 6.056 6.056 0 0 0-.747-7.073zM13.26 22.43a4.476 4.476 0 0 1-2.876-1.04l.141-.081 4.779-2.758a.795.795 0 0 0 .392-.681v-6.737l2.02 1.168a.071.071 0 0 1 .038.052v5.583a4.504 4.504 0 0 1-4.494 4.494zM3.6 18.304a4.47 4.47 0 0 1-.535-3.014l.142.085 4.783 2.759a.771.771 0 0 0 .78 0l5.843-3.369v2.332a.08.08 0 0 1-.033.062L9.74 19.95a4.5 4.5 0 0 1-6.14-1.646zM2.34 7.896a4.485 4.485 0 0 1 2.366-1.973V11.6a.766.766 0 0 0 .388.676l5.815 3.355-2.02 1.168a.076.076 0 0 1-.071 0l-4.83-2.786A4.504 4.504 0 0 1 2.34 7.872zm16.597 3.855l-5.833-3.387L15.119 7.2a.076.076 0 0 1 .071 0l4.83 2.791a4.494 4.494 0 0 1-.676 8.105v-5.678a.79.79 0 0 0-.407-.667zm2.01-3.023l-.141-.085-4.774-2.782a.776.776 0 0 0-.785 0L9.409 9.23V6.897a.066.066 0 0 1 .028-.061l4.83-2.787a4.5 4.5 0 0 1 6.68 4.66zm-12.64 4.135l-2.02-1.164a.08.08 0 0 1-.038-.057V6.075a4.5 4.5 0 0 1 7.375-3.453l-.142.08L8.704 5.46a.795.795 0 0 0-.393.681zm1.097-2.365l2.602-1.5 2.607 1.5v2.999l-2.597 1.5-2.607-1.5z"
+      />
+    </svg>
+  }
+  >
+    <p class="text-xs mt-3">
+      <code>0.9.0</code>
+    </p>
+  </Card>
+
+  <Card
+    title="Factory Droid"
+    icon={
+    <svg
+      width="20"
+      height="20"
+      className="agent-icon"
+      aria-hidden="true"
+      focusable="false"
+      xmlns="http://www.w3.org/2000/svg"
+      viewBox="0 0 900 900"
+      fill="none"
+    >
+      <path
+        fill="currentColor"
+        d="M622.037 192.524a10.58 10.58 0 0 1-4.056-2.001 10.573 10.573 0 0 1-3.98-7.89 10.595 10.595 0 0 1 .804-4.452c20.214-49.194 29.134-88.555 14.74-105.033-38.123-43.716-191.004 43.219-239.75 72.663a10.596 10.596 0 0 1-10.841.041 10.576 10.576 0 0 1-4.396-5.07c-20.491-49.089-42.031-83.233-63.865-84.714-57.871-3.96-104.516 165.624-118.17 220.895a10.574 10.574 0 0 1-1.993 4.057 10.572 10.572 0 0 1-7.884 3.977 10.586 10.586 0 0 1-4.447-.802c-49.194-20.215-88.572-29.134-105.033-14.74-43.717 38.123 43.202 191.005 72.644 239.75a10.553 10.553 0 0 1 1.454 4.279 10.573 10.573 0 0 1-6.481 10.958c-49.072 20.491-83.216 42.031-84.715 63.864-3.944 57.871 165.624 104.516 220.913 118.171a10.566 10.566 0 0 1 5.658 3.601 10.57 10.57 0 0 1 2.355 6.281 10.58 10.58 0 0 1-.799 4.442c-20.214 49.194-29.134 88.572-14.739 105.033 38.121 43.717 191.021-43.202 239.767-72.644a10.566 10.566 0 0 1 15.238 5.027c20.489 49.072 42.013 83.216 63.862 84.715 57.871 3.944 104.516-165.624 118.153-220.913a10.603 10.603 0 0 1 9.895-8.021 10.566 10.566 0 0 1 4.449.808c49.193 20.214 88.553 29.116 105.032 14.738 43.718-38.121-43.219-191.022-72.663-239.767a10.602 10.602 0 0 1 1.326-12.655 10.604 10.604 0 0 1 3.703-2.582c49.089-20.49 83.233-42.031 84.714-63.863 3.96-57.871-165.624-104.516-220.895-118.153Zm-66.394-55.478c11.123 19.938-46.196 152.797-88.83 245.724a8.36 8.36 0 0 1-8.239 4.855 8.374 8.374 0 0 1-7.412-6.043c-17.219-60.42-36.899-131.411-57.957-191.675a10.557 10.557 0 0 1 4.924-12.759c52.586-28.721 142.568-66.86 157.514-40.102ZM303.635 153.49c21.953 6.233 75.365 140.709 110.92 236.564a8.364 8.364 0 0 1-2.394 9.249 8.364 8.364 0 0 1-9.504.978c-54.943-30.493-119.013-66.824-176.522-94.546a10.565 10.565 0 0 1-5.528-12.501c16.926-57.44 53.532-148.095 83.028-139.744ZM137.064 343.322c19.921-11.123 152.795 46.197 245.707 88.83a8.369 8.369 0 0 1-1.189 15.652c-60.401 17.219-131.411 36.899-191.675 57.957a10.552 10.552 0 0 1-12.742-4.925c-28.668-52.584-66.876-142.568-40.101-157.514Zm16.443 252.009c6.217-21.953 140.709-75.365 236.564-110.921a8.368 8.368 0 0 1 10.227 11.898c-30.511 54.945-66.842 119.014-94.563 176.507a10.548 10.548 0 0 1-5.229 5.075 10.544 10.544 0 0 1-7.271.468c-57.441-16.822-148.095-53.531-139.728-83.027ZM343.34 761.902c-11.14-19.922 46.197-152.796 88.829-245.707a8.383 8.383 0 0 1 5.713-4.66 8.38 8.38 0 0 1 7.182 1.664 8.371 8.371 0 0 1 2.758 4.184c17.217 60.403 36.898 131.412 57.957 191.675a10.558 10.558 0 0 1-4.942 12.743c-52.568 28.668-142.568 66.875-157.445 40.101h-.052Zm252.009-16.443c-21.971-6.216-75.383-140.709-110.939-236.564a8.37 8.37 0 0 1 11.916-10.228c54.926 30.494 119.014 66.842 176.506 94.563a10.538 10.538 0 0 1 5.527 12.502c-16.909 57.526-53.515 148.094-83.01 139.727Zm166.57-189.834c-19.938 11.141-152.796-46.197-245.724-88.83a8.367 8.367 0 0 1-2.993-12.892 8.378 8.378 0 0 1 4.182-2.759c60.419-17.218 131.41-36.899 191.675-57.958a10.577 10.577 0 0 1 12.758 4.943c28.652 52.568 66.86 142.569 40.102 157.496Zm-16.444-252.009c-6.232 21.971-140.709 75.383-236.562 110.94a8.371 8.371 0 0 1-10.229-11.917c30.495-54.926 66.825-119.012 94.547-176.505a10.555 10.555 0 0 1 12.5-5.528c57.441 16.909 148.096 53.516 139.744 83.01Z"
+      />
+    </svg>
+  }
+  >
+    <p class="text-xs mt-3">
+      <code>0.56.3</code>
+    </p>
+  </Card>
+
+  <Card
+    title="Gemini CLI"
+    href="https://github.com/google-gemini/gemini-cli"
+    icon={
+    <svg
+      width="20"
+      height="20"
+      className="agent-icon"
+      aria-hidden="true"
+      focusable="false"
+      xmlns="http://www.w3.org/2000/svg"
+      viewBox="0 0 24 24"
+    >
+      <path
+        fill="currentColor"
+        d="M11.04 19.32Q12 21.51 12 24q0-2.49.93-4.68.96-2.19 2.58-3.81t3.81-2.55Q21.51 12 24 12q-2.49 0-4.68-.93a12.3 12.3 0 0 1-3.81-2.58 12.3 12.3 0 0 1-2.58-3.81Q12 2.49 12 0q0 2.49-.96 4.68-.93 2.19-2.55 3.81a12.3 12.3 0 0 1-3.81 2.58Q2.49 12 0 12q2.49 0 4.68.96 2.19.93 3.81 2.55t2.55 3.81"
+      />
+    </svg>
+  }
+  >
+    <p class="text-xs mt-3">
+      <code>0.26.0</code>
+    </p>
+  </Card>
+
+  <Card
+    title="GitHub Copilot"
+    href="https://github.com/github/copilot-language-server-release"
+    icon={
+    <svg
+      width="20"
+      height="20"
+      className="agent-icon"
+      aria-hidden="true"
+      focusable="false"
+      viewBox="0 0 16 16"
+      fill="none"
+      xmlns="http://www.w3.org/2000/svg"
+    >
+      <path
+        fillRule="evenodd"
+        clipRule="evenodd"
+        d="M7.99816 14.2779C12.0678 14.2779 14.9997 11.6274 14.9997 10.9574V9.3189C14.939 8.77306 14.4165 7.82349 13.6074 7.48636C13.5959 7.42498 13.5859 7.36153 13.5756 7.29542C13.5506 7.13548 13.5231 6.95977 13.4649 6.75954C13.6409 6.31508 13.6873 5.81187 13.6873 5.31135C13.6873 4.54947 13.5757 3.76321 13.0811 3.13712C12.5745 2.4959 11.7737 2.15372 10.6972 2.03411C9.64215 1.91688 8.71828 2.06409 8.12157 2.70342C8.07827 2.74981 8.0345 2.79812 7.99655 2.84746C7.95861 2.79812 7.91805 2.74981 7.87475 2.70342C7.27804 2.06409 6.35416 1.91688 5.29908 2.03411C4.22263 2.15372 3.42181 2.4959 2.91521 3.13712C2.42057 3.76321 2.30905 4.54947 2.30905 5.31135C2.30905 5.81187 2.35539 6.31508 2.53142 6.75954C2.47323 6.95977 2.44574 7.13542 2.42072 7.29536C2.41037 7.3615 2.40044 7.42496 2.38893 7.48636C1.57983 7.82349 1.05728 8.77306 0.996582 9.3189V10.9574C0.996582 11.6274 3.92849 14.2779 7.99816 14.2779ZM10.5523 3.33859C9.63863 3.23707 9.25001 3.41798 9.0811 3.59896C8.90273 3.79007 8.76738 4.19254 8.86971 5.0112C8.94909 5.64627 9.13423 6.08757 9.41018 6.36929C9.67188 6.63645 10.0966 6.8426 10.8435 6.8426C11.6506 6.8426 11.9631 6.66867 12.1051 6.51046C12.2619 6.33577 12.3748 6.00462 12.3748 5.31135C12.3748 4.64141 12.2675 4.22455 12.0513 3.95077C11.8469 3.69214 11.4446 3.43773 10.5523 3.33859ZM6.91639 3.59896C6.74748 3.41798 6.35886 3.23707 5.44518 3.33859C4.55289 3.43773 4.15058 3.69214 3.94624 3.95077C3.72994 4.22455 3.62271 4.64141 3.62271 5.31135C3.62271 6.00462 3.73563 6.33577 3.89239 6.51046C4.03436 6.66867 4.34693 6.8426 5.15396 6.8426C5.90092 6.8426 6.32561 6.63645 6.58731 6.36929C6.86326 6.08757 7.0484 5.64627 7.12778 5.0112C7.23011 4.19254 7.09476 3.79007 6.91639 3.59896ZM7.99818 12.9788C9.99307 12.9788 12.0088 12.0076 12.3748 11.7248V8.00133L12.3546 7.90026C11.9257 8.08369 11.4142 8.1551 10.8435 8.1551C9.84049 8.1551 9.04148 7.86851 8.47257 7.28773C8.28092 7.09208 8.12536 6.87308 7.99978 6.6378C7.8742 6.87308 7.71544 7.09208 7.52378 7.28773C6.95488 7.86851 6.15587 8.1551 5.15283 8.1551C4.58212 8.1551 4.07068 8.08369 3.6418 7.90026L3.62158 8.00133V11.7248C3.98755 12.0076 6.00329 12.9788 7.99818 12.9788Z"
+        fill="currentColor"
+      />
+      <path
+        d="M6.46854 9.0301C6.83097 9.0301 7.12479 9.32391 7.12479 9.68635V10.9988C7.12479 11.3613 6.83097 11.6551 6.46854 11.6551C6.1061 11.6551 5.81229 11.3613 5.81229 10.9988V9.68635C5.81229 9.32391 6.1061 9.0301 6.46854 9.0301Z"
+        fill="currentColor"
+      />
+      <path
+        d="M10.1873 9.68635C10.1873 9.32391 9.89347 9.0301 9.53104 9.0301C9.1686 9.0301 8.87479 9.32391 8.87479 9.68635V10.9988C8.87479 11.3613 9.1686 11.6551 9.53104 11.6551C9.89347 11.6551 10.1873 11.3613 10.1873 10.9988V9.68635Z"
+        fill="currentColor"
+      />
+    </svg>
+  }
+  >
+    <p class="text-xs mt-3">
+      <code>1.418.0</code>
+    </p>
+  </Card>
+
+  <Card
+    title="Mistral Vibe"
+    href="https://github.com/mistralai/mistral-vibe"
+    icon={
+    <svg
+      width="20"
+      height="20"
+      className="agent-icon"
+      aria-hidden="true"
+      focusable="false"
+      viewBox="0 0 28 28"
+      fill="none"
+      xmlns="http://www.w3.org/2000/svg"
+    >
+      <path
+        d="M8.8147 5.35803H5.35791V8.46914H8.8147V5.35803Z"
+        fill="currentColor"
+      />
+      <path
+        d="M22.6419 5.35803H19.1851V8.46914H22.6419V5.35803Z"
+        fill="currentColor"
+      />
+      <path
+        d="M15.7283 15.7284H12.2715V18.8395H15.7283V15.7284Z"
+        fill="currentColor"
+      />
+      <path
+        d="M8.8147 15.7284H5.35791V18.8395H8.8147V15.7284Z"
+        fill="currentColor"
+      />
+      <path
+        d="M22.6419 15.7284H19.1851V18.8395H22.6419V15.7284Z"
+        fill="currentColor"
+      />
+      <path
+        d="M12.2715 8.81482H5.35791V11.9259H12.2715V8.81482Z"
+        fill="currentColor"
+      />
+      <path
+        d="M12.2718 19.1852H1.90137V22.2963H12.2718V19.1852Z"
+        fill="currentColor"
+      />
+      <path
+        d="M26.0989 19.1852H15.7285V22.2963H26.0989V19.1852Z"
+        fill="currentColor"
+      />
+      <path
+        d="M22.6419 12.2716H5.35791V15.3827H22.6419V12.2716Z"
+        fill="currentColor"
+      />
+      <path
+        d="M22.6421 8.81482H15.7285V11.9259H22.6421V8.81482Z"
+        fill="currentColor"
+      />
+    </svg>
+  }
+  >
+    <p class="text-xs mt-3">
+      <code>2.0.2</code>
+    </p>
+  </Card>
+
+  <Card
+    title="OpenCode"
+    href="https://github.com/sst/opencode"
+    icon={
+    <svg
+      width="20"
+      height="20"
+      className="agent-icon"
+      aria-hidden="true"
+      focusable="false"
+      viewBox="0 0 16 16"
+      fill="none"
+      xmlns="http://www.w3.org/2000/svg"
+    >
+      <path
+        fillRule="evenodd"
+        clipRule="evenodd"
+        d="M13 14H3V2H13V14ZM10.5 4.4H5.5V11.6H10.5V4.4Z"
+        fill="currentColor"
+      />
+    </svg>
+  }
+  >
+    <p class="text-xs mt-3">
+      <code>1.1.48</code>
+    </p>
+  </Card>
+
+  <Card
+    title="Qwen Code"
+    href="https://github.com/QwenLM/qwen-code"
+    icon={
+    <svg
+      width="20"
+      height="20"
+      className="agent-icon"
+      aria-hidden="true"
+      focusable="false"
+      xmlns="http://www.w3.org/2000/svg"
+      data-name="图层 2"
+      viewBox="0 0 141.38 140"
+    >
+      <path
+        fill="currentColor"
+        d="m140.93 85-16.35-28.33-1.93-3.34 8.66-15a3.323 3.323 0 0 0 0-3.34l-9.62-16.67c-.3-.51-.72-.93-1.22-1.22s-1.07-.45-1.67-.45H82.23l-8.66-15a3.33 3.33 0 0 0-2.89-1.67H51.43c-.59 0-1.17.16-1.66.45-.5.29-.92.71-1.22 1.22L32.19 29.98l-1.92 3.33H12.96c-.59 0-1.17.16-1.66.45-.5.29-.93.71-1.22 1.22L.45 51.66a3.323 3.323 0 0 0 0 3.34l18.28 31.67-8.66 15a3.32 3.32 0 0 0 0 3.34l9.62 16.67c.3.51.72.93 1.22 1.22s1.07.45 1.67.45h36.56l8.66 15a3.35 3.35 0 0 0 2.89 1.67h19.25a3.34 3.34 0 0 0 2.89-1.67l18.28-31.67h17.32c.6 0 1.17-.16 1.67-.45s.92-.71 1.22-1.22l9.62-16.67a3.323 3.323 0 0 0 0-3.34ZM51.44 3.33 61.07 20l-9.63 16.66h76.98l-9.62 16.66H45.67l-11.54-20zM57.21 120H22.58l9.63-16.67h19.25l-38.5-66.67h19.25l9.62 16.67L68.78 100l-11.55 20Zm61.59-33.34-9.62-16.67-38.49 66.67-9.63-16.67 9.63-16.66 26.94-46.67h23.1l17.32 30z"
+        data-name="图层 1"
+      />
+    </svg>
+  }
+  >
+    <p class="text-xs mt-3">
+      <code>0.8.2</code>
+    </p>
+  </Card>
+</CardGroup>
+
+## Using the Registry
+
+Clients can fetch the registry programmatically:
+
+```bash  theme={null}
+curl https://cdn.agentclientprotocol.com/registry/v1/latest/registry.json
+```
+
+The registry JSON contains all agent metadata including distribution information for automatic installation.
+
+## Submit your Agent
+
+To add your agent to the registry:
+
+1. Fork the [registry repository on GitHub](https://github.com/agentclientprotocol/registry)
+2. Create a folder with your agent's ID (lowercase, hyphens allowed)
+3. Add an `agent.json` file following [the schema](https://github.com/agentclientprotocol/registry/blob/main/agent.schema.json)
+4. Optionally add an `icon.svg` (16x16 recommended)
+5. Submit a pull request
+
+See the [contributing guide](https://github.com/agentclientprotocol/registry/blob/main/CONTRIBUTING.md) for details.

package/references/copilot/acp-server.md

@@ -0,0 +1,117 @@
+# Copilot CLI ACP server
+
+Learn about GitHub Copilot CLI's Agent Client Protocol server.
+
+> \[!NOTE]
+> ACP support in GitHub Copilot CLI is in public preview and subject to change.
+
+## Overview
+
+The Agent Client Protocol (ACP) is a protocol that standardizes communication between clients (such as code editors and IDEs) and coding agents (such as Copilot CLI). For more details about this protocol, see the [official introduction](https://agentclientprotocol.com/get-started/introduction).
+
+## Starting the ACP server
+
+GitHub Copilot CLI can be started as an ACP server using the `--acp` flag. The server supports two modes, `stdio` and `TCP`.
+
+### stdio mode (recommended for IDE integration)
+
+By default, when providing the `--acp` flag, `stdio` mode will be inferred. The `--stdio` flag can also be provided for disambiguation.
+
+```bash
+copilot --acp --stdio
+```
+
+### TCP mode
+
+If the `--port` flag is provided in combination with the `--acp` flag, the server is started in TCP mode.
+
+```bash
+copilot --acp --port 3000
+```
+
+## Integrating with the ACP server
+
+There is a growing ecosystem of libraries to programmatically interact with ACP servers. Given GitHub Copilot CLI is correctly installed and authenticated, the following example demonstrates using the [typescript](https://agentclientprotocol.com/libraries/typescript) client to send a single prompt and print the AI response.
+
+```typescript
+import * as acp from "@agentclientprotocol/sdk";
+import { spawn } from "node:child_process";
+import { Readable, Writable } from "node:stream";
+
+async function main() {
+  const executable = process.env.COPILOT_CLI_PATH ?? "copilot";
+
+  // ACP uses standard input/output (stdin/stdout) for transport; we pipe these for the NDJSON stream.
+  const copilotProcess = spawn(executable, ["--acp", "--stdio"], {
+    stdio: ["pipe", "pipe", "inherit"],
+  });
+
+  if (!copilotProcess.stdin || !copilotProcess.stdout) {
+    throw new Error("Failed to start Copilot ACP process with piped stdio.");
+  }
+
+  // Create ACP streams (NDJSON over stdio)
+  const output = Writable.toWeb(copilotProcess.stdin) as WritableStream<Uint8Array>;
+  const input = Readable.toWeb(copilotProcess.stdout) as ReadableStream<Uint8Array>;
+  const stream = acp.ndJsonStream(output, input);
+
+  const client: acp.Client = {
+    async requestPermission(params) {
+      // This example should not trigger tool calls; if it does, refuse.
+      return { outcome: { outcome: "cancelled" } };
+    },
+
+    async sessionUpdate(params) {
+      const update = params.update;
+
+      if (update.sessionUpdate === "agent_message_chunk" && update.content.type === "text") {
+        process.stdout.write(update.content.text);
+      }
+    },
+  };
+
+  const connection = new acp.ClientSideConnection((_agent) => client, stream);
+
+  await connection.initialize({
+    protocolVersion: acp.PROTOCOL_VERSION,
+    clientCapabilities: {},
+  });
+
+  const sessionResult = await connection.newSession({
+    cwd: process.cwd(),
+    mcpServers: [],
+  });
+
+  process.stdout.write("Session started!\n");
+  const promptText = "Hello ACP Server!";
+  process.stdout.write(`Sending prompt: '${promptText}'\n`);
+
+  const promptResult = await connection.prompt({
+    sessionId: sessionResult.sessionId,
+    prompt: [{ type: "text", text: promptText }],
+  });
+
+  process.stdout.write("\n");
+
+  if (promptResult.stopReason !== "end_turn") {
+    process.stderr.write(`Prompt finished with stopReason=${promptResult.stopReason}\n`);
+  }
+
+  // Best-effort cleanup
+  copilotProcess.stdin.end();
+  copilotProcess.kill("SIGTERM");
+  await new Promise<void>((resolve) => {
+    copilotProcess.once("exit", () => resolve());
+    setTimeout(() => resolve(), 2000);
+  });
+}
+
+main().catch((error) => {
+  console.error(error);
+  process.exitCode = 1;
+});
+```
+
+## Further reading
+
+* [Official ACP documentation](https://agentclientprotocol.com/protocol/overview)