pi-memory-dreaming

内容来源：README.md（说明文档） · 原始地址 · 查看安装指南

原始内容

# 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:

```bash
pi install pi-memory-dreaming
```

Or try it for one pi run without installing:

```bash
pi -e pi-memory-dreaming
```

For local development from this repository:

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

Or run the local checkout once without installing:

```bash
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/`:

```text
.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:

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

## Development

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

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