exovault

CLI and MCP server for ExoVault — durable, encrypted memory for AI agents.

ExoVault uses a hooks-based architecture to automatically capture conversations and inject relevant memories. The MCP server gives your agent 37+ tools for active memory management. Together they build a complete, persistent knowledge layer.

Quick Start

1. Get an Agent Key

Sign up at exovault.co and generate an agent key (exv_...) from the Connect Wizard.

2. Connect (One-Time Setup)

npx exovault connect exv_your_key_here

This validates your key, writes the MCP config to ~/.exovault-mcp/config.json, and installs hooks for automatic turn capture and context injection. Supported for Claude Code, Cursor, and Windsurf.

Commands

| Command | Description | |---------|-------------| | exovault connect <key> | One-time setup — validates key, writes config, installs hooks | | exovault --help | Show help |

How It Works

1. Hooks run alongside your agent and capture every conversation turn automatically
2. Captured turns are sent to ExoVault for knowledge extraction in the background
3. Extracted facts, skills, and preferences are stored as durable encrypted memories
4. At session start, relevant memories are injected into the agent's context automatically

The agent also has direct access to all ExoVault MCP tools for explicit memory reads and writes.

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | EXOVAULT_AGENT_KEY | Yes | Your agent key (exv_...) — set via exovault connect | | EXOVAULT_API_URL | No | API URL (default: https://exovault.co) |

Links

• ExoVault Dashboard
• exovault-mcp-server — MCP-only package
• Model Context Protocol

License

MIT