ai-dream

Memory consolidation for AI agents — REM sleep for your coding assistant.

After 20+ sessions, your AI's MEMORY.md becomes a graveyard of duplicates, stale context, and noise. ai-dream fixes this by running a background consolidation process — like how your brain cleans up memories during REM sleep.

Two versions, same goal:

	Claude Code	OpenClaw
Directory	claude-code/	openclaw/
Mechanism	Built-in autoDreamEnabled setting	Cron-triggered dream agent
Setup	One line in settings.json	setup.sh or manual cron
Runs when	Background (Claude decides)	Nightly at 3:00 AM (configurable)
Config file	settings.json	DREAM.md
Customizable rules	No (black box)	Yes (full control)

---

The Problem

Your AI assistant accumulates memory files over time. Without consolidation:

• Duplicates pile up — the same project status recorded 5 different ways
• Stale info lingers — completed tasks, old deadlines, superseded decisions
• Signal drowns in noise — important context gets buried under session artifacts
• MEMORY.md bloats — the index file grows past useful limits

The Solution

ai-dream consolidates memory the way sleep consolidates human memory:

Session 1 → raw notes
Session 2 → raw notes
Session 3 → raw notes
        ↓
   [Dream cycle]
        ↓
  Clean MEMORY.md
  (deduplicated, pruned, integrated)

---

Quick Start

Claude Code Users

# Add to your Claude Code settings
# ~/.claude/settings.json
{
  "preferences": {
    "autoDreamEnabled": true
  }
}

See claude-code/README.md for details.

OpenClaw Users

# Clone and run setup
git clone https://github.com/VoidLight00/ai-dream.git
cd ai-dream/openclaw
chmod +x setup.sh
./setup.sh /path/to/your/workspace

See openclaw/README.md for details.

---

How It Works

Both versions follow the same core cycle:

1. Collect — Gather recent memory files and session notes
2. Compare — Diff against current MEMORY.md for conflicts and duplicates
3. Consolidate — Merge, prune, and integrate based on priority rules
4. Update — Write a clean MEMORY.md with consolidated information
5. Log — Record what changed for auditability

The Claude Code version handles this internally. The OpenClaw version gives you full control over the rules via DREAM.md.

---

Repository Structure

ai-dream/
├── README.md                      # This file
├── LICENSE                        # MIT
├── CHANGELOG.md
├── claude-code/
│   ├── README.md                  # Claude Code setup guide
│   ├── settings.example.json      # Example configuration
│   └── how-it-works.md            # Technical deep-dive
└── openclaw/
    ├── README.md                  # OpenClaw setup guide
    ├── DREAM.md                   # Dream rules template
    ├── dream-agent-prompt.md      # Agent prompt template
    ├── setup.sh                   # Automated setup
    └── cron-setup.md              # Manual cron guide

---

Contributing

Contributions are welcome. Please open an issue first to discuss what you'd like to change.

License

MIT — VoidLight00

---

한국어 안내

ai-dream — AI 메모리 정리 시스템

20개 이상의 세션을 거치면 AI의 MEMORY.md는 중복, 오래된 정보, 노이즈로 가득 찹니다. ai-dream은 사람의 렘수면처럼 백그라운드에서 메모리를 정리합니다.

두 가지 버전:

• Claude Code — settings.json에 autoDreamEnabled: true 추가 → 자동 실행
• OpenClaw — DREAM.md 규칙 파일 + cron 기반 야간 정리 에이전트

각 디렉토리의 README를 참고하세요.