@e9n/pi-memory

Persistent memory system for pi. Long-term facts and daily session logs stored as plain Markdown, automatically injected into every agent turn.

Features

• Long-term memory — MEMORY.md with section-based editing for curated facts, preferences, and decisions
• Daily logs — memory/YYYY-MM-DD.md append-only files with auto-timestamped entries
• Full-text search — search across all memory files with surrounding context
• System prompt injection — MEMORY.md and recent daily logs are loaded before every agent turn
• Skill included — pi-memory skill with usage conventions and housekeeping guidance

Setup / Settings

Optional — defaults to cwd. Override via ~/.pi/agent/settings.json (global) or .pi/settings.json (project):

{
  "pi-memory": {
    "path": "~/notes/memory"
  }
}

Key	Default	Description
path	cwd	Base directory for MEMORY.md and memory/ daily logs. Supports ~.

Memory layout

<path>/
├── MEMORY.md              # Curated long-term memory (## Section headers)
└── memory/
    ├── 2026-02-17.md      # Today's session notes
    ├── 2026-02-16.md
    └── ...

Tools

memory_read

Read from persistent memory.

Parameter	Values	Description
target	long_term | daily | list	What to read
date	YYYY-MM-DD (optional)	Date for daily target (defaults to today)

• long_term — reads MEMORY.md
• daily — reads the daily log for the given date (defaults to today)
• list — lists all available daily log files

memory_write

Write to persistent memory.

Parameter	Values	Description
target	daily | long_term	Where to write
content	string	Content to write
section	string (optional)	For long_term: ## Section header to find and replace. Omit to append to end.

• daily — appends a ### HH:MM timestamped entry to today's log
• long_term — replaces the named section in MEMORY.md, or appends a new section if not found

memory_search

Search across all memory files.

Parameter	Values	Description
query	string	Case-insensitive search term
limit	number (optional)	Max results (default: 20)

Returns matching lines with one line of surrounding context and the source file and line number.

Install

pi install npm:@e9n/pi-memory

License

MIT