Skip to main content

JetBrains IDEs

JetBrains IDEs support the Agent Client Protocol through JetBrains AI Assistant.

Supported IDEs​

This guide applies to all JetBrains IDEs:

  • IntelliJ IDEA
  • PyCharm
  • WebStorm
  • GoLand
  • Rider
  • CLion
  • PhpStorm
  • RubyMine
  • DataGrip
  • And other JetBrains IDEs

Prerequisites​

Before configuring JetBrains IDEs:

  1. Faheem Code CLI installed - See Installation
  2. LLM settings configured - Run faheemcode and use /settings
  3. JetBrains IDE version 25.3 or later
  4. JetBrains AI Assistant enabled in your IDE

Configuration​

Step 1: create the ACP configuration file​

Create or edit the file $HOME/.jetbrains/acp.json:

mkdir -p ~/.jetbrains
nano ~/.jetbrains/acp.json

Step 2: add the configuration​

Add the following JSON:

{
  "agent_servers": {
    "Faheem Code": {
      "command": "faheemcode",
      "args": ["acp"],
      "env": {}
    }
  }
}

Step 3: use Faheem Code in your IDE​

Follow the JetBrains ACP instructions to open and use an agent in your JetBrains IDE.

Advanced configuration​

LLM-approve mode​

For automatic LLM-based approval:

{
  "agent_servers": {
    "Faheem Code": {
      "command": "faheemcode",
      "args": ["acp", "--llm-approve"],
      "env": {}
    }
  }
}

Auto-approve mode​

For automatic approval of all actions (use with caution):

{
  "agent_servers": {
    "Faheem Code": {
      "command": "faheemcode",
      "args": ["acp", "--always-approve"],
      "env": {}
    }
  }
}

Resume a conversation​

Resume a specific conversation:

{
  "agent_servers": {
    "Faheem Code (Resume)": {
      "command": "faheemcode",
      "args": ["acp", "--resume", "abc123def456"],
      "env": {}
    }
  }
}

Resume the latest conversation:

{
  "agent_servers": {
    "Faheem Code (Latest)": {
      "command": "faheemcode",
      "args": ["acp", "--resume", "--last"],
      "env": {}
    }
  }
}

Multiple configurations​

Add multiple configurations for different use cases:

{
  "agent_servers": {
    "Faheem Code": {
      "command": "faheemcode",
      "args": ["acp"],
      "env": {}
    },
    "Faheem Code (Auto-Approve)": {
      "command": "faheemcode",
      "args": ["acp", "--always-approve"],
      "env": {}
    },
    "Faheem Code (Resume Latest)": {
      "command": "faheemcode",
      "args": ["acp", "--resume", "--last"],
      "env": {}
    }
  }
}

Environment variables​

Pass environment variables to the agent:

{
  "agent_servers": {
    "Faheem Code": {
      "command": "faheemcode",
      "args": ["acp"],
      "env": {
        "LLM_API_KEY": "your-api-key"
      }
    }
  }
}

Troubleshooting​

"Agent not found" or "Command failed"​

  1. Verify Faheem Code CLI is installed:

    faheemcode --version

  2. If the command is not found, ensure Faheem Code CLI is in your PATH or reinstall it following the Installation guide

"AI Assistant not available"​

  1. Ensure you have JetBrains IDE version 25.3 or later
  2. Enable AI Assistant: Settings > Plugins > AI Assistant
  3. Restart the IDE after enabling

Agent doesn't respond​

  1. Check your LLM settings:

    faheemcode
    # Use /settings to configure

  2. Test ACP mode in terminal:

    faheemcode acp
    # Should start without errors

Configuration not applied​

  1. Verify the config file location: ~/.jetbrains/acp.json
  2. Validate JSON syntax (no trailing commas, proper quotes)
  3. Restart your JetBrains IDE

Finding your conversation ID​

To resume conversations, first find the ID:

faheemcode --resume

This displays recent conversations with their IDs:

Recent Conversations:
--------------------------------------------------------------------------------
 1. abc123def456 (2h ago)
    Fix the login bug in auth.py
--------------------------------------------------------------------------------

See also​