majiayu000/remem

remem: Local-first Memory for Claude Code and Codex CLI

Stop re-explaining your project every new coding-agent session.

Language: English | 简体中文

remem is a single Rust binary that automatically captures, distills, searches, and injects project memory across Claude Code and Codex CLI sessions. It keeps decisions, bug-fix rationale, project patterns, and preferences available through hooks, MCP, CLI, and REST without requiring an external database.

What You Get

• Claude Code and Codex CLI remember project decisions across sessions.
• Bug-fix rationale, preferences, and project patterns are searchable.
• Memory stays local by default with SQLite and SQLCipher.
• Hooks, MCP tools, CLI commands, and a localhost REST API use the same store.
• One Rust binary; no hosted database or separate memory service.

Install

For Codex CLI:

brew install majiayu000/tap/remem
remem install --target codex
remem doctor

For Claude Code:

brew install majiayu000/tap/remem
remem install --target claude
remem doctor

If you do not use Homebrew:

curl -fsSL https://raw.githubusercontent.com/majiayu000/remem/main/install.sh | env REMEM_NO_CONFIG=1 sh
~/.local/bin/remem install --target codex
~/.local/bin/remem doctor

Success Check

Start a new Claude Code or Codex CLI session after installation. remem should inject relevant project memory at session start and summarize durable memory after the session stops. Then run:

remem status
remem search "last decision"

remem install --target codex creates or updates:

• ~/.remem/.key and the encrypted ~/.remem/remem.db
• ~/.remem/config.toml memory-AI profiles
• Codex MCP registra