When AI meets code, and the essence of Claude Code meets the Solon AI framework—a smart terminal assistant truly belonging to the Java ecosystem is born.
Remember the shock when Claude Code CLI was released? That AI assistant capable of chatting in the terminal, generating videos, sending emails, writing code, and understanding project structures finally has a Java implementation!
Today, the Solon AI framework officially launches Solon Code CLI — a smart terminal tool that fully embraces the design philosophy of Claude Code CLI while deeply integrating with the Java ecosystem.
- Compatible with Claude Code Agent Skills specifications
- Compatible with CLAUDE.md specifications
1. This is Not a Simple “Wrapper”
Solon Code CLI does more than just mimic the surface features of Claude Code CLI. From its foundation (Solon AI) to its core logic and interaction patterns, it aligns with the Claude Code philosophy across the board and features deep optimizations for Java development scenarios. Licensed under the MIT Open Source License, it allows for arbitrary modification and customization.
2. Minimalist Interaction, Ultimate Experience
After modifying the LLM configuration in README.md (you can even give it a nickname like “Xiaohua”), run run.sh (Mac/Linux) or run.cmd (Windows) to enter a whole new world:
Xiaohua v0.0.12
/Users/yourname/projects/myapp/
User
>
No bloated command parameters, no complex configurations. Just like talking to an experienced programmer, you only need to state your requirements.
3. Intelligent Project Recognition
Like Claude Code CLI, Solon Code CLI uses the init command to automatically identify your project structure, technology stack, and local file index:
Xiaohua v0.0.12
/Users/yourname/projects/myapp/
User
> init
Re-initializing workspace...
Local index refreshed successfully! 172 files scanned and indexed in 154ms.
Verified project contract. (Maven(Root))
User
>
It generates a CLAUDE.md file in your project root—the heart of the Claude Code specification—recording build commands, testing methods, and coding standards. This file serves as a “living document” for both the AI and your team members.
4. True “Engineering-Grade” AI Capabilities
Solon Code CLI is not just a chatbot; it is an AI assistant that understands engineering and code.
a) Code Understanding and Search
Xiaohua v0.0.12
/Users/yourname/projects/myapp/
User
> init
Re-initializing workspace...
Local index refreshed successfully! 172 files scanned and indexed in 154ms.
Verified project contract. (Maven(Root))
User
> Local search server related code
Xiaohua
Users who want to find the server-specific code of the protocol need to search locally for the server-specific code. I should use full_text_search to search for server related content in the project.
❯ full_text_search query=server
Found 19 results (sorted by relevance) :
Path: acp-core/src/test/java/com/agentclientprotocol/sdk/spec/McpServerConfigurationTest.java (Score: 1.94, Line: ~22)
Preview: ...sertj.core.api.Assertions.assertThat; /** * Tests for MCP server configuration serialization and deserialization. * * <p> * Per the ACP spec: * <ul> * <li>Stdio transport: N...
Based on Lucene-powered intelligent search, it instantly locates the critical code you need.
b) Code Modification and Verification
User
> Give WebSocketAcpAgentTransport class under the perfect log (based on slf4j specification)
Xiaohua
I searched for this class first and then refined the SLF4J log for it.
❯ full_text_search query=WebSocketAcpAgentTransport
Five results were found (in order of relevance) :
Path: acp-websocket-jetty/src/test/java/com/agentclientprotocol/sdk/agent/transport/WebSocketAcpAgentTransportTest.java (Score: 3.28, Line: ~18)
Preview: ...ssertions.assertThatThrownBy; /** * Unit tests for {@link WebSocketAcpAgentTransport}. */ class WebSocketAcpAgentTransportTest { private McpJsonMapper jsonMapper; @BeforeEac...
Path: acp-websocket-jetty/src/test/java/com/agentclientprotocol/sdk/integration/WebSocketClientAgentTest.java (Score: 2.68, Line: ~14)
Preview: ...ncAgent; import com.agentclientprotocol.sdk.agent.transport.WebSocketAcpAgentTransport; import com.agentclientprotocol.sdk.client.AcpAsyncClient; import com.agentclientprotocol.sdk...
Path: acp-websocket-jetty/src/main/java/com/agentclientprotocol/sdk/agent/transport/WebSocketAcpAgentTransport.java (Score: 2.57, Line: ~70)
Preview: ...ncy> * }</pre> * * @author Mark Pollack */ public class WebSocketAcpAgentTransport implements AcpAgentTransport { private static final Logger logger = LoggerFactory.getLogger...
Path: README.md (Score: 1.65, Line: ~342)
Preview: ...```
java import com.agentclientprotocol.sdk.agent.transport.WebSocketAcpAgentTransport; var transport = new WebSocketAcpAgentTransport( 8080, // port...
Path: acp-agent-support/README.md (Score: 1.01, Line: ~291)
Preview: ...create()) .run();
``` ### WebSocket Transport ```
java WebSocketAcpAgentTransport transport = WebSocketAcpAgentTransport.builder() .host("localhost") .port(8080) ....
(End of output)
❯ read_file
Solon Code CLI follows the “verification-driven” principle of Claude Code: tests must be run after modifying code to ensure changes are safe and reliable.
c) Secure Command Execution
For high-risk operations, Solon Code CLI features a built-in security audit policy similar to Claude Code. It intelligently intercepts:
User
> Get the contents of https://solon.noear.org/ web page
Xiaohua
The user wants to access the contents of https://solon.noear.org/. I need to use a tool that fetches web content.
Looking at the available tools, I see that there are these related tools:
1. 'bash' - can execute shell commands like curl or wget
2. 'full_text_search' - This is a local full-text search, not getting the content of the web page
3. Other tools are mainly related to file manipulation
The most straightforward way is to use the 'bash' tool to execute the curl command to get the content of the web page.
Let me help you get the content of this web page.
(8554 tokens)
Permission Required
Command: curl -s https://solon.noear.org/
Approve? (y/n)
It intelligently intercepts (via the customizable HitlStrategy) :
- System privileged commands (
sudo,chmod,chown) - Network outbound operations (
curl,wget,ssh) - Path traversal attacks (
../) - Combined command injections (
;,&)
Only risky operations that you confirm will be executed, and security is fully aligned with Claude Code.
5. Three Connection Modes: AI Everywhere
Solon Code CLI adopts the “Pool-Box Model”—one AI core with three connection methods:
a) CLI Mode
yml
solon.code.cli:
cliEnabled: true
cliPrintSimplified: true
Directly chat with AI in the terminal for the purest experience. (Enabled by default via cliEnabled: true).
b) Web Mode
yml
solon.code.cli:
webEnabled: false
webEndpoint: "/cli"
Access http://localhost:8080/cli via a browser for a visual interactive interface.
c) ACP Protocol Mode
Solon Code CLI implements the ACP (Agent Communication Protocol), allowing seamless connection to any IDE plugin or client supporting the protocol. This means:
- Future direct use in VS Code or IntelliJ IDEA.
- Support for remote connections (AI runs on your server while you operate locally).
- Shared AI computing resources for teams.
yml
solon.code.cli:
acpEnabled: false
acpTransport: "websocket" # "stdio" or "websocket"
acpEndpoint: "/acp"
6. Quick Start
Download (17MB):
https://github.com/opensolon/soloncodecli/releases/download/v0.0.12/SolonCodeCLI_v0.0.12.zip
https://gitee.com/opensolon/soloncodecli/releases/download/v0.0.12/SolonCodeCLI_v0.0.12.zip
Configuration:
Extract the package and adjust application.yaml with your API Key and Model details (e.g., DeepSeek, OpenAI, etc.).
yaml
solon:
code:
cli:
nickname: "Xiaohua"
workDir: "my-project"
chatModel:
apiUrl: "https://api.deepseek.com/v1/chat/completions"
apiKey: "sk-xxxx"
model: "deepseek-chat"
planningMode: true
hitlEnabled: true
Run:
# For Mac or Linux
sh run.sh
# For Windows
run.cmd
# Or native Java command
java -jar SolonCodeCLI.jar
7. Conclusion
Solon Code CLI is not intended to replace Claude Code; rather, it brings this advanced AI programming paradigm into the customizable Java world , allowing every Java developer to enjoy the efficiency revolution brought by AI.
It is open-source (MIT), customizable, and deeply integrated. You can integrate it into your CI/CD pipelines, build your own AI toolchains, or empower your entire development team.
The Java edition of Claude Code is here. Are you ready?
Project Address: https://github.com/opensolon/soloncodecli
Solon Code CLI — Born for Java developers, an intelligent terminal assistant sharing the same DNA as Claude Code.