vestige/docs/integrations/jetbrains.md

JetBrains (IntelliJ, WebStorm, PyCharm, etc.)

Give your JetBrains AI assistant a brain that remembers.

JetBrains IDEs (2025.2+) have built-in MCP support. Vestige integrates through the MCP server settings, giving your AI assistant persistent memory across sessions.

---

Prerequisites

• JetBrains IDE 2025.2+ (IntelliJ IDEA, WebStorm, PyCharm, GoLand, etc.)
• vestige-mcp binary installed (Installation guide)

---

Setup

Option A: Auto-Configure (Recommended)

JetBrains can auto-configure MCP servers for connected clients:

1. Open Settings (Cmd+, / Ctrl+Alt+S)
2. Navigate to Tools > MCP Server
3. Click "+" to add a new MCP server
4. Configure:
   • Name: vestige
   • Command: /usr/local/bin/vestige-mcp
   • Arguments: (leave empty)
5. Click Apply

Option B: Junie AI Config

If using JetBrains Junie AI, add Vestige to the Junie MCP config:

User-level (all projects):

mkdir -p ~/.junie/mcp

Edit ~/.junie/mcp/mcp.json:

{
  "mcpServers": {
    "vestige": {
      "command": "/usr/local/bin/vestige-mcp",
      "args": [],
      "env": {}
    }
  }
}

Project-level:

Create .junie/mcp/mcp.json in your project root with the same format.

Option C: Via External Client

JetBrains exposes its own tools via MCP. You can also use Vestige through an external client (Claude Code, Cursor) that connects to JetBrains:

1. In JetBrains: Settings > Tools > MCP Server
2. Click Auto-Configure for your preferred client
3. Add Vestige to that client's config (see Cursor, VS Code)

---

Verify

After configuration, the MCP server should appear in Settings > Tools > MCP Server with a green status indicator.

Test by asking your AI assistant:

"Remember that this project uses Spring Boot with Kotlin and follows hexagonal architecture"

---

Project-Specific Memory

Isolate memory per project:

{
  "mcpServers": {
    "vestige": {
      "command": "/usr/local/bin/vestige-mcp",
      "args": ["--data-dir", "/Users/you/projects/my-app/.vestige"],
      "env": {}
    }
  }
}

---

Troubleshooting

MCP server not appearing in settings

1. Verify your IDE version is 2025.2 or later.
2. Check that the binary path is absolute:

   which vestige-mcp
   

3. Restart the IDE after adding the configuration.

Finding your client's config file

In Settings > Tools > MCP Server, click the expansion arrow next to your client, then select "Open Client Settings File" to see the exact config path.

---

Also Works With

IDE	Guide
Xcode 26.3	Setup
Cursor	Setup
VS Code (Copilot)	Setup
Windsurf	Setup
Claude Code	Setup
Claude Desktop	Setup

Your AI remembers everything, everywhere.