pi-memory-dreaming

pi-memory-dreaming gives pi an automatic memory system. Once installed, it learns durable preferences, facts, corrections, workflows, and project context from your conversations, then reuses saved Markdown memories as background context in future turns.

You do not need to run /dreaming during normal use. The slash command is only for checking status, manually forcing a run, and managing saved Markdown memories.

Install

From npm:

pi install pi-memory-dreaming

Or try it for one pi run without installing:

pi -e pi-memory-dreaming

For local development from this repository:

pi install /absolute/path/to/pi-memory-dreaming

Or run the local checkout once without installing:

pi -e /absolute/path/to/pi-memory-dreaming

Automatic behavior

pi-dreaming is enabled by default. It automatically:

• recalls saved Markdown memories before each agent turn and appends them to the system prompt as background context;
• attempts memory maintenance after each agent turn;
• also checks on a timer, every 5 minutes by default, and skips work when the conversation has not changed or is still below the minimum digest size.

Only normal, high-confidence memories are saved. Secret, forbidden, sensitive, malformed, or low-confidence observations are dropped instead of being written to disk. Stale or contradicted memories can be deleted by the maintenance run.

Memories are stored per project under .pi/dreaming/:

.pi/dreaming/
  _state.json            # settings and last-run metadata
  _index.md              # generated index with [[slug]] links
  memories/
    <slug>.md            # Markdown memory with frontmatter

Memory files and state files use file mode 0600 when supported by the filesystem.

Management commands

Use /dreaming when you want to inspect or manage the automatic memory system:

/dreaming status
/dreaming list [active|all]
/dreaming show <slug>
/dreaming run [--dry-run] [--force]
/dreaming forget <slug>
/dreaming enable
/dreaming disable

Development

bun install
bun run check
bun run pack:dry-run