CodeMemory

CodeMemory for Claude Code

English | 简体中文

  Persistent engineering memory for Claude Code.

  Store decisions, constraints, failures, and compacted summaries in local SQLite, then bring the right context back into long sessions, complex refactors, and debugging loops.

  Star on GitHub
  ·
  Quick Start
  ·
  Feature Highlights
  ·
  Configuration
  ·
  Tools
  ·
  Development

CodeMemory is a local-first Claude Code plugin that turns per-session context into durable engineering memory. It stores conversations, summaries, decisions, constraints, failures, and fix attempts in SQLite, then injects the right context back into prompts and risky tool calls.

CodeMemory is intentionally narrow: it is not a general-purpose RAG layer. It is optimized for long Claude Code sessions, complex refactors, and multi-round debugging loops where remembering prior intent matters more than broad document search.

- Claude Code plugin: codememory-plugin
- npm package: codememory-for-claude

Why CodeMemory

CodeMemory is built for three recurring pain points in coding sessions:

1. Long sessions: keep stable requirements and constraints visible after context-window truncation.
2. Complex refactors: preserve design rationale, rejected alternatives, and why the current approach won.
3. Multi-round debugging: recall prior failures and fix attempts before repeating a broken path.

Feature Highlights

- Local-first memory: everything lives in ~/.claude/codememory.db; no external service is required.
- Prompt-time retrieval: every user prompt can pull relevant tasks, constraints, decisions, and failures into additionalContext.
- Prior-failure alerts: before Edit, Write, or Bash, CodeMemory checks whether the target has failed before.
- DAG-based compaction: long history is compacted into leaf…