Installation

Install Memex via Docker, Homebrew, or build from source

Memex Full

Full server with MCP integration, Web UI, semantic search, and RAG.

Homebrew (macOS / Linux)

brew install vimo-ai/tap/memex

Docker

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

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

Mount	Purpose
`~/.vimo:/data`	Memex data directory (required)
`~/.claude/projects:/claude`	Claude Code sessions
`~/.codex:/codex`	Codex CLI sessions (optional)
`~/.local/share/opencode:/opencode`	OpenCode sessions (optional)
`~/.gemini/tmp:/gemini`	Gemini CLI sessions (optional)

Binary

Download from GitHub Releases. Available for macOS (arm64/x64), Linux (x64/arm64), and Windows (x64).

Verify

curl http://localhost:10013/health
# OK

MCP Integration

claude mcp add memex -- npx -y mcp-remote http://localhost:10013/api/mcp

codex mcp add memex -- npx -y mcp-remote http://localhost:10013/api/mcp

gemini mcp add --transport http memex http://localhost:10013/api/mcp

// 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"

Memex Lite

Zero-dependency standalone CLI for quick searches. Reads local session files directly, no server needed.

brew install vimo-ai/tap/memex-lite

memex search "anything you want"
memex list -n 10

Build from Source

git clone https://github.com/vimo-ai/memex.git
cd memex

# Full server
cd memex-rs && cargo build --release
./target/release/memex

# Lite CLI only
cd memex-lite && cargo build --release
./target/release/memex --help

Requires Rust 1.75+ and SQLite 3.35+ with FTS5.

Ollama (Optional)

For semantic search and RAG:

brew install ollama
ollama serve
ollama pull bge-m3      # embeddings
ollama pull qwen3:0.6b  # chat (optional)

Memex auto-detects Ollama at http://localhost:11434.

Troubleshooting

vimo-agent auto-download failed

The background agent (vimo-agent) is downloaded automatically on first run. If auto-download fails, download manually from ai-cli-session-db Releases and place it at ~/.vimo/bin/vimo-agent.

Docker users don't need to worry about this - vimo-agent is bundled in the image.