1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Memex search for that Python API client we discussed last month" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Memex by vimo-ai

English | 中文

One Memory. All CLIs. Never Compacted. Exact Search.

Session history management for AI coding assistants. Never lose your conversations again.

Features

On-demand search - You control when to search; automatic injection is opt-in
Original preservation - Raw messages always kept; summaries are optional layers
Multi-CLI support - Claude Code, Codex, OpenCode, Gemini in one database
Powerful search - Full-text (FTS5) + semantic vectors + hybrid ranking
MCP integration - Search directly from your AI CLI
REST API - Integrate into any workflow
Local storage - All data stays on your machine

Quick Start

Full

brew install vimo-ai/tap/memex # Verify server is running curl http://localhost:10013/health

Lite

Zero-dependency CLI, reads local session data directly:

brew install vimo-ai/tap/memex-lite memex search "anything you want" memex list -n 10

Docker

macOS / Linux:

docker run -d -p 10013:10013 \ -v ~/.vimo:/data \ -v ~/.claude/projects:/claude:ro \ -v ~/.codex:/codex:ro \ # 可选: Codex -v ~/.local/share/opencode:/opencode:ro \ # 可选: OpenCode -v ~/.gemini/tmp:/gemini:ro \ # 可选: Gemini -e OLLAMA_HOST=http://host.docker.internal:11434 \ # 可选: 本机 Ollama (Docker Desktop) ghcr.io/vimo-ai/memex:latest

Windows (PowerShell):

docker run -d -p 10013:10013 ` -v "$env:USERPROFILE\.vimo:/data" ` -v "$env:USERPROFILE\.claude\projects:/claude:ro" ` -v "$env:USERPROFILE\.codex:/codex:ro" ` # 可选: Codex -v "$env:LOCALAPPDATA\opencode:/opencode:ro" ` # 可选: OpenCode -v "$env:USERPROFILE\.gemini\tmp:/gemini:ro" ` # 可选: Gemini -e OLLAMA_HOST=http://host.docker.internal:11434 ` # 可选: 本机 Ollama (Docker Desktop) ghcr.io/vimo-ai/memex:latest

Binary downloads available at Releases.

Configure MCP

# Claude Code claude mcp add memex -- npx -y mcp-remote http://localhost:10013/api/mcp # Codex codex mcp add memex -- npx -y mcp-remote http://localhost:10013/api/mcp # Gemini gemini mcp add --transport http memex http://localhost:10013/api/mcp # OpenCode - edit ~/.config/opencode/opencode.json # { "mcp": { "memex": { "type": "remote", "url": "http://localhost:10013/api/mcp" } } }

Then search in your AI CLI:

use memex search "anything you want"