Skip to main content

Documentation Index

Fetch the complete documentation index at: https://lab.pollack.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.18.0Maven Central

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.

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