Skip to main content
Spring Boot autoconfiguration for the ACP Java SDK. Provides auto-configured clients, agents, and transports with property-driven configuration.

Quick Start

Add the starter dependency:

Client

Configure the transport in application.properties and inject the client:

Agent

Annotate a Spring bean with @AcpAgent and add handler methods:
For stdio agents, redirect logging to stderr and keep the JVM alive:

Configuration Properties

Client

PropertyDefaultDescription
spring.acp.client.request-timeout30sRequest timeout
spring.acp.client.transport.typeauto-detectstdio or websocket
spring.acp.client.transport.stdio.commandCommand to launch agent process
spring.acp.client.transport.stdio.argsCommand arguments (comma-separated)
spring.acp.client.transport.stdio.env.*Environment variables for the process
spring.acp.client.transport.websocket.uriWebSocket URI (e.g. ws://localhost:8080/acp)
spring.acp.client.transport.websocket.connect-timeout10sWebSocket connection timeout
spring.acp.client.capabilities.read-text-filetrueAdvertise file read capability
spring.acp.client.capabilities.write-text-filetrueAdvertise file write capability
spring.acp.client.capabilities.terminalfalseAdvertise terminal capability

Agent

PropertyDefaultDescription
spring.acp.agent.enabledtrueEnable agent autoconfiguration
spring.acp.agent.request-timeout60sRequest processing timeout
spring.acp.agent.transport.typestdioTransport type

Transport Selection

The client transport is selected automatically based on which properties are set:
  • Set spring.acp.client.transport.stdio.command → stdio transport
  • Set spring.acp.client.transport.websocket.uri → WebSocket transport
  • Set spring.acp.client.transport.type → explicit selection (takes precedence)
The agent defaults to stdio transport. Set spring.acp.agent.enabled=false to disable.

Overriding Beans

All auto-configured beans back off when you provide your own. Define a custom AcpClientTransport, AcpSyncClient, AcpAsyncClient, or AcpAgentTransport bean and the autoconfiguration will use yours instead.

Tutorial

Spring Boot Agent

Build an ACP agent as a Spring Boot application

Spring Boot Client

Use the autoconfigured ACP client in Spring Boot

Requirements

  • Java 21+
  • Spring Boot 4.0+
  • ACP Java SDK 0.14.0+

Resources