Acp Go Sdk

ACP Go SDK

Go library for the Agent Client Protocol (ACP) - a standardized communication protocol between code editors and AI‑powered coding agents.

Learn more about the protocol itself at .

Installation

go get github.com/coder/acp-go-sdk@v0.13.5

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/coder/acp-go-sdk/tree/main/example) contains simple implementations of both Agents and Clients in Go. You can run them from your terminal or connect to external ACP agents.

• go run ./example/agent starts a minimal ACP agent over stdio.
• go run ./example/claude-code demonstrates bridging to Claude Code.
• go run ./example/client connects to a running agent and streams a sample turn.
• go run ./example/gemini bridges to the Gemini CLI in ACP mode (flags: -model, -sandbox, -debug, -gemini /path/to/gemini).

You can watch the interaction by running `go run ./example/client` locally.

Explore the API

Browse the Go package docs on pkg.go.dev for detailed API documentation:

• https://pkg.go.dev/github.com/coder/acp-go-sdk

If you're building an [Agent](https://agentclientprotocol.com/protocol/overview#agent):

• Implement the acp.Agent interface (and optionally acp.AgentLoader for session/load).
• Create a connection with acp.NewAgentSideConnection(agent, os.Stdout, os.Stdin).
• Send updates and make client requests using the returned connection.

If you're building a [Client](https://agentclientprotocol.com/protocol/overview#client):

• Implement the acp.Client interface