Skip to main content
This project has moved from spring-ai-community/agent-client to markpollack/agent-client. The Maven groupId changed from org.springaicommunity.agents to io.github.markpollack.
Portable Java API for autonomous CLI agents. No Spring Boot required — build a model, create a client, run a goal. Optional Spring Boot starters for auto-configuration. Agent Client is the bridge between raw SDK calls (Claude Agent SDK) and higher-level orchestration (Agent Workflow). Version 0.21.0 — Maven Central 0.21.0 highlights: Portable reasoning effort (low/medium/high) via AgentOptions.getEffort(), with provider-native overrides for Claude (--effort, up to max) and Codex (model_reasoning_effort, up to xhigh). Provider Parity TCK made real; Codex added to the CI runtime image; weekly CLI canary. Dependency: claude-code-sdk 1.3.0.

​
Architecture

Three layers, each usable independently:
LayerModuleFramework Deps
Core APIagent-client-coreNone — plain Java
Spring Boot Auto-Configagent-client-spring-boot-autoconfigureSpring Boot
Startersagent-starter-claude, etc.Spring Boot
// Plain Java — no Spring Boot needed
ClaudeAgentModel model = ClaudeAgentModel.builder()
    .defaultOptions(ClaudeAgentOptions.builder().yolo(true).build())
    .build();
AgentClient client = AgentClient.create(model);
AgentClientResponse response = client.run("Create hello.txt");

​
Providers

Claude Code, Codex (OpenAI), Gemini CLI, Amazon Q, Amp. Provider selection at construction time — everything after AgentClient.create(model) is portable.

​
LOOSE / STRICT Modes

AgentClientMode controls default permissiveness. LOOSE (default) bypasses sandbox restrictions and git checks for frictionless evaluation. STRICT requires explicit opt-in.

​
Documentation

Getting Started

Plain Java quick start — create your first agent task

Tutorial

Step-by-step lessons from first task to multi-provider

Claude Reference

18 configuration options, trace files, authentication

Portable Options

Configuration precedence, LOOSE/STRICT modes

​
Source

GitHub

Source code, examples, and getting started guide

Agent Sandbox

Isolated execution — local, Docker, or E2B cloud

Agent Workflow

Uses Agent Client for ClaudeStep and AgentClientStep