cachly in JetBrains IDEs
The plugin shows your Brain inside the IDE. Your AI assistant uses the Brain through MCP (Model Context Protocol, the way assistants call outside tools). The plugin writes that connection for you where the assistant reads it from a file.
From install to first recall
About five minutes. Your AI asking your Brain is the step that counts; the status bar alone only shows that the plugin is connected.
- Install Node.js 20 or newer. Your AI starts the cachly server through npx.
- Install Cachly Brain from the JetBrains Marketplace and restart the IDE if it asks.
- On first start, a window asks what the plugin may send. Keep Use the Brain ticked and click Save my choice. The plugin creates a free trial Brain; the status bar then shows your Brain.
- In the message that follows, click Set up AI files (plugin 0.9.5 or newer; otherwise Tools → Set Up AI Files). It writes the files that tell Junie and Claude Code to check your Brain first.
- Using JetBrains AI Assistant? Also click Connect AI Assistant and tick cachly in its MCP settings (details below).
- Start a new chat in your AI tool, so it loads the cachly tools. Then ask it to start a task, or ask: What does my cachly Brain know about this project? It calls the cachly tool smart_recall and answers from your Brain. That is your first recall.
Stuck at a step? Run Tools → Run Brain Doctor. Or write to [email protected] with a screenshot of where it stopped; a person answers.
What the plugin does
- Gets you a Brain on first startWith no key stored, the plugin asks for a free trial Brain by itself. No account, no key to paste. It then makes one request with the new key and shows the result in the status bar.
- Status barShows how many lessons your Brain holds. It refreshes every 300 seconds; you can change that in Settings → Tools → Cachly Brain.
- Briefing on project openIf your Brain already holds lessons, a notification shows the three most reused ones.
- Warning on file openWhen you open a file, the plugin asks your Brain whether it knows a failure pattern for that path. It only speaks up for medium or high risk.
- Tools menuConnect Brain, Show Brain Health, Show Lessons, Save Lesson to Brain (Ctrl+Shift+B), Set Up AI Files and Run Brain Doctor.
Connect your AI assistant
The plugin alone does not give an assistant memory. The assistant needs the cachly MCP server. It runs through npx, so Node.js must be installed.
Run Tools → Set Up AI Files. The plugin writes .mcp.json into the project root. Claude Code reads it when it starts in that folder.
Run Tools → Set Up AI Files (plugin 0.8.3 or newer). The plugin writes .junie/mcp/mcp.json, the project-level MCP file Junie reads.
JetBrains: Junie MCP configurationAI Assistant reads MCP servers from its settings, not from a project file. With plugin 0.8.5 or newer, click Connect AI Assistant after connecting, or run Tools → Connect JetBrains AI Assistant. In IDE 2025.3 and newer the plugin adds cachly to ~/.ai/mcp/mcp.json. The server starts switched off, so:
- Open Settings → Tools → AI Assistant → Model Context Protocol (MCP). The Open MCP settings button in the plugin's notification goes there.
- Tick cachly and press OK. The first start can take about 40 seconds, because the server is downloaded.
- cachly missing in the list? Restart the IDE once, it then reads the file. On Windows, AI Assistant notices a changed mcp.json only after a restart.
- The box Automatically enable new and changed MCP servers on that page is off by default. You can tick it.
In IDE 2024.1 to 2025.2 the plugin copies the server config and opens the same page: click Add, paste, then OK and Apply.
JetBrains: AI Assistant and MCPThe server entry
This is what Set Up AI Files writes. For AI Assistant in IDEs before 2025.3, the plugin copies it for you. On Windows, AI Assistant starts the server without a shell, so the plugin writes cmd as the command and puts /c npx in front of the arguments. Your instance ID is in Settings → Tools → Cachly Brain.
{
"mcpServers": {
"cachly": {
"command": "npx",
"args": ["-y", "@cachly-dev/mcp-server@latest"],
"env": {
"CACHLY_API_URL": "https://api.cachly.dev",
"CACHLY_BRAIN_INSTANCE_ID": "<your instance ID>"
}
}
}
}Your API key stays out of these files. Since plugin 0.8.4 it is stored in ~/.cachly/credentials.json in your home folder, where the cachly server finds it. The project files hold only the server address and your instance ID.
If the status bar says "not configured" or "offline"
Run Tools → Run Brain Doctor. It checks the key, the instance ID and the connection, and names the step that fails. If no key is stored, Tools → Connect Brain starts the setup again.
More: Plugin on JetBrains Marketplace · IDE plugins overview · MCP integration