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.
Module 29: JetBrains Integration
Run your Java ACP agent in IntelliJ IDEA, PyCharm, WebStorm, and other JetBrains IDEs.
What You’ll Learn
- Configuring JetBrains IDEs for ACP agents
- The
~/.jetbrains/acp.json configuration format
- MCP server access from JetBrains
Prerequisites
- JetBrains IDE version 25.3 RC or later
- JetBrains AI Assistant plugin enabled
- Java 17+
The Agent
Same code as Module 28 (Zed). The agent is identical — only the IDE configuration differs:
AcpSyncAgent agent = AcpAgent.sync(transport)
.initializeHandler(req -> InitializeResponse.ok())
.newSessionHandler(req ->
new NewSessionResponse(UUID.randomUUID().toString(), null, null))
.promptHandler((req, context) -> {
String promptText = /* extract from req */;
context.sendThought("Analyzing your request...");
context.sendMessage(generateResponse(promptText));
return PromptResponse.endTurn();
})
.build();
agent.run();
1. Build the JAR
./mvnw package -pl module-29-jetbrains-integration -q
~/.jetbrains/acp.json:
{
"agent_servers": {
"Java Tutorial Agent": {
"command": "java",
"args": ["-jar", "/absolute/path/to/jetbrains-agent.jar"]
}
}
}
3. Use the agent
Open AI Chat (Alt+Shift+C), select Java Tutorial Agent from the agent dropdown.
Configuration Options
With environment variables
{
"agent_servers": {
"Java Tutorial Agent": {
"command": "java",
"args": ["-jar", "/path/to/jetbrains-agent.jar"],
"env": {
"MY_API_KEY": "your-key-here"
}
}
}
}
With IDE MCP server access
{
"agent_servers": {
"Java Tutorial Agent": {
"command": "java",
"args": ["-jar", "/path/to/jetbrains-agent.jar"],
"use_idea_mcp": true,
"use_custom_mcp": true
}
}
}
Supported IDEs
All JetBrains IDEs with AI Assistant support ACP in version 25.3 RC and later: IntelliJ IDEA, PyCharm, WebStorm, GoLand, PhpStorm, Rider, CLion, RubyMine, DataGrip.
Source Code
View on GitHub
Running the Example
./mvnw package -pl module-29-jetbrains-integration -q
./mvnw exec:java -pl module-29-jetbrains-integration
Next Module
Module 30: VS Code Integration — connect to VS Code using the community extension.
