LaserPhaser/claude-ltm

README preview

# claude-ltm

Long-term memory for Claude Code. Persist project decisions across sessions so context is never lost.

## The Problem

During large workloads, the context and decisions made at the beginning of a project get lost as Claude Code sessions fill up and context windows rotate. Teams lose track of why choices were made, what was decided, and what changed.

## How It Works

claude-ltm adds a **persistent decision memory** to your project — a structured Markdown file that Claude reads at every session start and updates as decisions are made.

Think of it like human memory:
- A **main file** (`.memory/DECISIONS.md`) holds short decision checkpoints — what you'd recall off the top of your head
- **Detail files** (`.memory/details/`) hold deep-dive context for complex decisions — the memories you dig into when needed

Claude is instructed via `CLAUDE.md` to:
1. **Read** the memory at session start
2. **Update** it when significant decisions are made during work
3. **Compact** before finishing — a final pass to capture anything missed

View full repository on GitHub →