mcpField
D
dream-memory

dream-memory

github.com/learnpromptAgent workflows24074 installsUpdated 16w ago
Repository

About dream-memory

Dream Memory is a portable skill for consolidating an agent's stored notes into a concise, maintained memory. It helps merge durable facts, remove stale or conflicting entries, and keep MEMORY.md as an index.

Key features

  1. 01Merge overlapping memory notes
  2. 02Prune stale or contradicted facts
  3. 03Convert relative dates to absolute dates
  4. 04Keep MEMORY.md concise and index-like
  5. 05Inspect logs and transcripts

Use cases

  1. 01Run a scheduled memory cleanup
  2. 02Consolidate topic files after a work session
  3. 03Remove outdated or conflicting memory entries

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/learnprompt/cc-harness-skills --skill dream-memory

After installing, type/dream-memoryin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

README.md
references/
prompt-template.md
source-notes.md
scripts/
dream_memory.py

Details

From the project README

Dream Memory

Use this skill when you want a deliberate memory-consolidation pass instead of storing more raw notes.

This bundle is intentionally portable. It borrows the workflow shape from Claude Code's dream system, but it does not depend on Claude Code internals.

Use It For

  • nightly or manual memory cleanup
  • merging overlapping memory notes
  • normalizing relative dates into absolute dates
  • pruning stale or contradicted memories
  • keeping MEMORY.md small and index-like

Avoid It For

  • saving a single new memory from the current turn
  • persisting code facts that should be re-read from source
  • replacing plans, task boards, or issue trackers

Quick Start

Inspect a memory directory before running the consolidation prompt:

python3 {baseDir}/scripts/dream_memory.py --memory-root /path/to/memory --transcripts-dir /path/to/transcripts

Then use the portable prompt in references/prompt-template.md.

Workflow

  1. Inspect MEMORY.md, topic files, and recent logs or transcripts.
  2. Identify durable facts worth keeping.
  3. Merge into topic files instead of creating near-duplicates.
  4. Remove stale or contradicted memory.
  5. Rewrite MEMORY.md as a concise index.

Rules

  • MEMORY.md is an index, not a content dump.
  • Prefer topic merges over new file creation.
  • Convert relative dates to absolute dates.
  • Do not store code-state facts that can drift.

Supporting Files

Comments

Markdown supported