This Spring AI library reimplements core Claude Code features as reusable tools and agent skills for Java developers. It enables sophisticated agentic workflows, offering file operations, shell execution, web access, task management, and extensible skills within the Spring AI ecosystem, simplifying the creation of advanced AI applications.

How It Works

The project translates Claude Code's powerful agent capabilities into Spring AI tools. It provides core utilities like AgentEnvironment for context, FileSystemTools for file manipulation, ShellTools for command execution, and SkillsTool for composable knowledge modules defined in Markdown. Advanced features include TaskTools for sub-agent delegation and AutoMemoryTools for persistent, file-based long-term memory, inspired by Claude Code's memory patterns. This approach integrates robust agentic functionality directly into Java applications via the Spring AI framework.

Quick Start & Requirements

• Install: Add the spring-ai-agent-utils-bom or spring-ai-agent-utils Maven dependency.
• Prerequisites: Java 17+, Spring Boot 3.x/4.x, Spring AI 2.0.0-M4+, Maven 3.6+.
• Build/Run: Execute mvn clean install for the project. Run examples via mvn spring-boot:run after navigating to the respective example directory (e.g., examples/code-agent-demo).
• Links: GitHub Repository, Issue Tracker, Spring AI Documentation, Claude Code Documentation.

Highlighted Details

• Claude Code Reimplementation: Core features like file operations, shell execution, and agent skills are adapted from Claude Code.
• Extensible Skills System: SkillsTool allows defining reusable agent capabilities using Markdown files.
• Persistent Memory: AutoMemoryTools enables long-term, file-based memory storage and retrieval across conversations.
• Task Orchestration: TaskTools facilitates complex workflows by delegating tasks to specialized sub-agents.
• Comprehensive Toolset: Includes utilities for environment info, file system access, shell commands, code searching (GrepTool), web fetching, and user interaction.

Maintenance & Community

Contributions are welcomed via GitHub issues and pull requests. The primary community links are the GitHub Repository and its Issue Tracker.

Licensing & Compatibility

• License: Apache License 2.0.
• Compatibility: The Apache 2.0 license permits commercial use and integration into closed-source projects.

Limitations & Caveats

The project relies on specific versions of Spring AI (e.g., 2.0.0-M4) and may require external API keys (like BRAVE_API_KEY) for certain tools. Some advanced features, such as memory consolidation via AutoAutoMemoryToolsAdvisor, may necessitate manual configuration or setup. The project appears to be under active development, indicated by its pre-release versioning and example focus.