dreams

Dreams for Claude Code

A /dream skill that brings the capabilities of Anthropic's Dreams API (managed-agents research preview) to local Claude Code installations — no API key, beta access, or cloud memory stores required.

Agents write to their memory stores as they work, but these writes are local and incremental: over many sessions a memory store accumulates duplicates, contradictions, and stale entries. Dreams let Claude clean that up.

A dream reads your existing memory alongside past session transcripts, then produces a new, reorganized memory store: duplicates merged, stale or contradicted entries replaced with the latest value, and new insights surfaced. The input is never modified — you review the output, then apply or discard it.

What it curates

Source	Location	Output
Project memory store	~/.claude/projects/<slug>/memory/	rebuilt sibling dir memory.dream-<date>/
Instruction files	CLAUDE.md, CLAUDE.local.md, ~/.claude/CLAUDE.md	*.dream-<date> proposals next to originals
claude-mem observations (if installed)	~/.claude-mem/claude-mem.db	read-only curation report + SQL (never auto-applied)

Usage

/dream                  # curate memory using the 10 most recent sessions
/dream 25               # mine the 25 most recent sessions (max 100)
/dream 0                # curate the store only, no transcript mining
/dream focus on coding-style preferences; ignore one-off debugging notes
/dream 50 preserve all reference memories unchanged

The trailing free text is steering guidance, equivalent to the API's instructions field: synthesis-level direction (focus areas, what to preserve, output conventions), not line-level edits.

Every run ends with a review summary (kept / merged / updated / dropped / new) and an explicit apply-or-discard choice. Applying swaps the store atomically and keeps the previous one as memory.pre-dream-<date> for rollback.

Install

As a plugin (recommended)

/plugin marketplace add maxgoff/Dreams        # or a local path / your fork's URL
/plugin install dreams@dreams

As a personal skill

git clone https://github.com/maxgoff/Dreams.git
ln -s "$(pwd)/Dreams/skills/dream" ~/.claude/skills/dream

Either way, /dream becomes available in every Claude Code session on the machine.

Fidelity to the Dreams API

Dreams API	This skill
memory_store input	local project memory directory
sessions input (1–100)	local .jsonl session transcripts
instructions field	trailing /dream arguments
output store in outputs[]	memory.dream-<date>/ sibling directory
input store never modified	input store never modified
review, then attach or discard	review, then swap or discard
async job with observable session	runs in-session with progress updates
billed API tokens	your Claude Code session tokens

License

MIT