CP Memory MCP server

CP Memory

<!-- mcp-name: io.github.CJhuochai/cp-memory -->

Local-first, governable memory for AI coding agents. Remember project rules across sessions, recall only what matters, and correct bad memory without hiding history.

简体中文 | English

Why CP Memory

For reproducible package, protocol and recall checks, see verification evidence and limits.

• Local first: memory stays in ~/.cp-memory/memory.db by default.
• Governable: inspect, review, correct, scope, or retire memory instead of silently overwriting it.
• MCP-ready, Codex-enhanced: the stdio MCP server is the portable baseline; the Codex plugin adds Skills and lifecycle Hooks.

Quick Start — Portable MCP

With Python 3.10+ and uv installed, any stdio MCP client can start CP Memory with:

uvx cp-memory-mcp

The public package passed a clean-cache MCP handshake with all 40 tools and a write/search/correct flow. See MCP client setup for Codex, Claude Code, Cursor, VS Code, and Gemini CLI examples.

For the enhanced Codex integration with lifecycle Hooks and Skills, install the plugin:

codex plugin marketplace add CJhuochai/cp-memory
codex plugin add cp-memory@cp-memory

Restart Codex after installation and approve the lifecycle Hooks if prompted.

See The Result In 30 Seconds

1. Tell Codex a project rule, such as: “Releases must start on a branch, run tests, and merge through a PR.”
2. In a later session, CP Memory restores the relevant rule from the local primary store so Codex can continue following it.
3. If the rule is wrong, preserve correction history and mark the old record wrong, stale, or scoped instead of silently overwriting it.

CP Memory is a local-first memory plugin for Codex. It stores facts, preferences, ongoing work, episodes, decisions, and conversation checkpoints in a local SQLite database, then restores relevant context through MCP tools and lifecycle hooks.

The goal is not to remember as much as possible. The goal is memory that remains trustworthy after long-term use: explainable, reviewable, correctable, and governable.

Current Capabilities

• Context restore: restores relevant local-primary memory on startup and eligible prompts.
• Automatic extraction: conservatively creates long-term personal memory candidates from explicit statements.
• Project scope: prioritizes current-project memories with repo:, project:, and workspace: scopes.
• Reviewable governance: supports review inbox, review digests, conflict suggestions, correction states, and startup reminders.
• Safe maintenance: weekly maintenance runs health checks, governance preflight, and low-risk expiry cleanup only.

30-Second Example

You tell Codex:

Remember this: releases for this project must start on a branch, run tests, and merge through a PR.

In a later session, you ask:

What are the release rules for this plugin?

Shortened. The full README is on GitHub.