mirror of https://github.com/samvallad33/vestige.git synced 2026-04-25 16:56:21 +02:00

Sam Valladares 3fce1f0b70 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

2026-02-12 17:18:15 -06:00

2.7 KiB

Raw Blame History

Cursor

Give Cursor a brain that remembers between sessions.

Cursor has native MCP support. Add Vestige and your AI assistant remembers your architecture, preferences, and past fixes across every session.

Setup

1. Create or edit the config file

Global (all projects):

Platform	Path
macOS / Linux	`~/.cursor/mcp.json`
Windows	`%USERPROFILE%\.cursor\mcp.json`

# macOS / Linux
mkdir -p ~/.cursor
open -e ~/.cursor/mcp.json

2. Add Vestige

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

Use absolute paths. Cursor does not reliably resolve relative paths or ~. Run which vestige-mcp to find your binary location.

Windows:

{
  "mcpServers": {
    "vestige": {
      "command": "C:\\Users\\you\\.cargo\\bin\\vestige-mcp.exe",
      "args": [],
      "env": {}
    }
  }
}

3. Restart Cursor

Fully quit and reopen Cursor. The MCP server loads on startup.

4. Verify

Open Cursor's AI chat and ask:

"What MCP tools do you have access to?"

You should see Vestige's tools listed (search, smart_ingest, memory, etc.).

First Use

Ask Cursor's AI:

"Remember that this project uses React with TypeScript and Tailwind CSS"

Start a new chat session, then:

"What tech stack does this project use?"

It remembers.

Project-Specific Memory

To isolate memory per project, use --data-dir:

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

Or place a .cursor/mcp.json in the project root for project-level config.

Troubleshooting

Vestige tools not appearing

Verify the binary exists:
```
which vestige-mcp
```
Test the binary manually:
```
echo '{}' | vestige-mcp
```

Check the config is valid JSON:

cat ~/.cursor/mcp.json | python3 -m json.tool

Fully restart Cursor (Cmd+Q / Alt+F4, not just close window).

Silent failures

Cursor does not surface MCP server errors in the UI. Test by running the command directly in your terminal to see actual error output.

Also Works With

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

Your AI remembers everything, everywhere.

2.7 KiB Raw Blame History