mirror of
https://github.com/samvallad33/vestige.git
synced 2026-05-15 18:25:16 +02:00
feat: v2.0 distribution — IDE integrations, zero-config installer, README overhaul
- Add integration guides for Xcode 26.3, Cursor, VS Code, JetBrains, Windsurf - First cognitive memory server with documented Xcode 26.3 MCP support - Add npx @vestige/init — zero-config CLI that auto-detects IDEs and injects config - Overhaul README: "The open-source cognitive engine for AI" - Add "Why Not Just Use RAG?" comparison and cognitive science stack docs - Update license badge to AGPL-3.0
This commit is contained in:
parent
04a3062328
commit
3fce1f0b70
8 changed files with 1378 additions and 92 deletions
129
docs/integrations/jetbrains.md
Normal file
129
docs/integrations/jetbrains.md
Normal file
|
|
@ -0,0 +1,129 @@
|
|||
# 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](../../README.md#quick-start))
|
||||
|
||||
---
|
||||
|
||||
## 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):**
|
||||
|
||||
```bash
|
||||
mkdir -p ~/.junie/mcp
|
||||
```
|
||||
|
||||
Edit `~/.junie/mcp/mcp.json`:
|
||||
|
||||
```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](./cursor.md), [VS Code](./vscode.md))
|
||||
|
||||
---
|
||||
|
||||
## 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:
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"vestige": {
|
||||
"command": "/usr/local/bin/vestige-mcp",
|
||||
"args": ["--data-dir", "/Users/you/projects/my-app/.vestige"],
|
||||
"env": {}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
<details>
|
||||
<summary>MCP server not appearing in settings</summary>
|
||||
|
||||
1. Verify your IDE version is 2025.2 or later.
|
||||
2. Check that the binary path is absolute:
|
||||
```bash
|
||||
which vestige-mcp
|
||||
```
|
||||
3. Restart the IDE after adding the configuration.
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>Finding your client's config file</summary>
|
||||
|
||||
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.
|
||||
</details>
|
||||
|
||||
---
|
||||
|
||||
## Also Works With
|
||||
|
||||
| IDE | Guide |
|
||||
|-----|-------|
|
||||
| Xcode 26.3 | [Setup](./xcode.md) |
|
||||
| Cursor | [Setup](./cursor.md) |
|
||||
| VS Code (Copilot) | [Setup](./vscode.md) |
|
||||
| Windsurf | [Setup](./windsurf.md) |
|
||||
| Claude Code | [Setup](../CONFIGURATION.md#claude-code-one-liner) |
|
||||
| Claude Desktop | [Setup](../CONFIGURATION.md#claude-desktop-macos) |
|
||||
|
||||
Your AI remembers everything, everywhere.
|
||||
Loading…
Add table
Add a link
Reference in a new issue