Pi Memory

pi-memory

[](https://www.npmjs.com/package/@zhafron/pi-memory) [](https://www.npmjs.com/package/@zhafron/pi-memory) [](https://www.npmjs.com/package/@zhafron/pi-memory)

Memory management extension for [pi coding agent](https://pi.dev/).

Features

• Long-term Memory: Store crucial facts, decisions, and preferences in MEMORY.md
• Identity Management: Define AI persona in IDENTITY.md
• User Profile: Store user context in USER.md
• Daily Logging: Track day-to-day activities in daily/YYYY-MM-DD.md
• Auto Context Injection: MEMORY.md, IDENTITY.md, USER.md automatically injected into system prompt
• First Run Setup: Interactive bootstrap process for new installations
• Cross-platform: Works on Windows, macOS, and Linux

Installation

pi install git:github.com/tickernelz/pi-memory

Or via npm:

pi install npm:@zhafron/pi-memory

Configuration

Add to `~/.pi/agent/settings.json`:

{
  "pi-memory": {
    "memoryDir": "~/.pi/agent/memory",
    "dashboard": false
  }
}

Setting	Type	Default	Description
memoryDir	string	~/.pi/agent/memory	Memory directory location
dashboard	boolean	false	Enable dashboard widget

Memory Files

File	Purpose
MEMORY.md	Long-term memory (crucial facts, decisions, preferences)
IDENTITY.md	AI identity (name, persona, behavioral rules)
USER.md	User profile (name, preferences, context)
daily/YYYY-MM-DD.md	Daily logs (day-to-day activities)
BOOTSTRAP.md	First run setup instructions (deleted after setup)

Tools

`memory`

Unified memory management tool.

**Actions:**

Action	Description	Parameters