@agentclientprotocol/sdk
Advanced tools
The Agent Client Protocol (ACP) is a protocol that standardizes communication between *code editors* (interactive programs for viewing and editing source code) and *coding agents* (programs that use generative AI to autonomously modify code).
The official TypeScript implementation of the Agent Client Protocol (ACP) — a standardized communication protocol between code editors and AI-powered coding agents.
Learn more at https://agentclientprotocol.com
npm install @agentclientprotocol/sdk
Warning: ACP v2 is still a draft. Its wire protocol and this TypeScript API may change incompatibly in any SDK release. Use it only if you are prepared to track the draft as it evolves.
The stable package entry point remains ACP v1. ACP v2 requires an explicit experimental import:
import * as acp from "@agentclientprotocol/sdk/experimental/v2";
Browse the experimental v2 TypeScript API reference and the draft ACP v2 protocol documentation for the current SDK and protocol designs.
Start by reading the official ACP documentation to understand the core concepts and protocol specification.
The examples directory contains simple implementations of both Agents and Clients in TypeScript. These examples can be run from your terminal or from an ACP Client like Zed, making them great starting points for your own integration!
Browse the TypeScript library reference for detailed API documentation.
If you're building an Agent, start with agent({ name }), register handlers such as initialize(...), newSession(...), and prompt(...), then call connect(stream).
If you're building a Client, start with client({ name }), register client-side handlers such as requestPermission(...) and sessionUpdate(...), then run your agent workflow with connectWith(stream, async (ctx) => ...).
For a complete, production-ready implementation, check out the Gemini CLI Agent.
See the main repository for contribution guidelines.
By contributing, you agree that your contributions will be licensed under the Apache 2.0 License.
FAQs
The Agent Client Protocol (ACP) is a protocol that standardizes communication between *code editors* (interactive programs for viewing and editing source code) and *coding agents* (programs that use generative AI to autonomously modify code).
The npm package @agentclientprotocol/sdk receives a total of 6,291,815 weekly downloads. As such, @agentclientprotocol/sdk popularity was classified as popular.
We found that @agentclientprotocol/sdk demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 3 open source maintainers collaborating on the project.
Security News
arXiv now limits authors to two submissions a month as AI slop overwhelms moderators, delays good papers, and sparks debate over applying the limit to everyone.
Research
/Security News
A new GhostAction wave hits hundreds of GitHub repos, expanding CI/CD secret theft to cloud and AI credentials in source code and git history.
Research
/Security News
Tensorlake npm SDK version 0.5.144 was compromised in a ChainDrop / Shai-Hulud attack, delivering credential-stealing malware.