# @agentclientprotocol/sdk

> 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).

Latest version **1.4.0** (published 2026-08-20) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @agentclientprotocol/sdk
pnpm add @agentclientprotocol/sdk
yarn add @agentclientprotocol/sdk
bun add @agentclientprotocol/sdk
```

## Health

**Score 75/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 1.4.0 |
| Published | 2026-08-20 |
| First published | 2025-10-10 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 5.3 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 254 |
| Author | Zed Industries |
| Maintainers | benbrandt, aguzubiaga, cirwin |

## Links

- npm: https://www.npmjs.com/package/@agentclientprotocol/sdk
- Repository: https://github.com/agentclientprotocol/typescript-sdk
- Homepage: https://github.com/agentclientprotocol/typescript-sdk#readme
- Issues: https://github.com/agentclientprotocol/typescript-sdk/issues
- npm.io page: https://npm.io/package/@agentclientprotocol/sdk

## Recent versions

- 1.4.0 (latest) — 2026-08-20
- 1.3.0 — 2026-07-21
- 1.2.1 — 2026-07-07
- 1.2.0 — 2026-07-06
- 1.1.0 — 2026-06-29
- 1.0.0 — 2026-06-24
- 0.29.0 — 2026-06-22
- 0.28.1 — 2026-06-19
- 0.28.0 — 2026-06-18
- 0.27.1 — 2026-06-18
- 0.27.0 — 2026-06-18
- 0.26.0 — 2026-06-16
- 0.25.1 — 2026-06-13
- 0.25.0 — 2026-06-05
- 0.24.0 — 2026-06-02
- … 35 more at https://npm.io/package/@agentclientprotocol/sdk/versions

## README

<a href="https://agentclientprotocol.com/" >
  <img alt="Agent Client Protocol" src="https://zed.dev/img/acp/banner-dark.webp">
</a>

# ACP TypeScript Library

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

## Installation

```bash
npm install @agentclientprotocol/sdk
```

## Experimental ACP v2

> **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:

```ts
import * as acp from "@agentclientprotocol/sdk/experimental/v2";
```

Browse the [experimental v2 TypeScript API reference](https://agentclientprotocol.github.io/typescript-sdk/v2/)
and the [draft ACP v2 protocol documentation](https://agentclientprotocol.com/protocol/v2/draft/overview)
for the current SDK and protocol designs.

## Get Started

### Understand the Protocol

Start by reading the [official ACP documentation](https://agentclientprotocol.com) to understand the core concepts and protocol specification.

### Try the Examples

The [examples directory](https://github.com/agentclientprotocol/typescript-sdk/tree/main/src/examples) 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](https://zed.dev), making them great starting points for your own integration!

### Explore the API

Browse the [TypeScript library reference](https://agentclientprotocol.github.io/typescript-sdk) for detailed API documentation.

If you're building an [Agent](https://agentclientprotocol.com/protocol/overview#agent), start with `agent({ name })`, register handlers such as `initialize(...)`, `newSession(...)`, and `prompt(...)`, then call `connect(stream)`.

If you're building a [Client](https://agentclientprotocol.com/protocol/overview#client), start with `client({ name })`, register client-side handlers such as `requestPermission(...)` and `sessionUpdate(...)`, then run your agent workflow with `connectWith(stream, async (ctx) => ...)`.

### Study a Production Implementation

For a complete, production-ready implementation, check out the [Gemini CLI Agent](https://github.com/google-gemini/gemini-cli/blob/main/packages/cli/src/zed-integration/zedIntegration.ts).

## Resources

- [Library docs](https://agentclientprotocol.github.io/typescript-sdk)
- [Examples](https://github.com/agentclientprotocol/typescript-sdk/tree/main/src/examples)
- [Protocol Documentation](https://agentclientprotocol.com)
- [GitHub Repository](https://github.com/agentclientprotocol/typescript-sdk)
- [NPM Package](https://www.npmjs.com/package/@agentclientprotocol/sdk)

## Contributing

See the main [repository](https://github.com/agentclientprotocol/typescript-sdk) for contribution guidelines.

### License

By contributing, you agree that your contributions will be licensed under the Apache 2.0 License.

---
_Source: https://npm.io/package/@agentclientprotocol/sdk · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._