pi-memory

Memory management extension for pi coding agent.

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 | |--------|-------------|------------| | read | Read memory file | target: memory, identity, user, daily | | write | Write to memory file | target: memory, identity, user, daily; content; mode: append/overwrite | | search | Search memory files | query, max_results (optional) | | list | List all files | - |

Targets:

| Target | File | Purpose | |--------|------|---------| | memory | MEMORY.md | Long-term memory (crucial facts, decisions, preferences) | | identity | IDENTITY.md | AI identity (name, persona, behavioral rules) | | user | USER.md | User profile (name, preferences, context) | | daily | daily/YYYY-MM-DD.md | Daily logs (day-to-day activities) |

Examples:

# Read memory files
memory --action read --target memory
memory --action read --target identity
memory --action read --target user
memory --action read --target daily --date 2026-02-18

# Write to memory files
memory --action write --target memory --content "Remember to use PostgreSQL for all projects"
memory --action write --target identity --content "- **Name**: Jarvis" --mode overwrite
memory --action write --target user --content "- **Location**: New York (EST)"
memory --action write --target daily --content "Fixed critical bug in auth module"

# Search and list
memory --action search --query "PostgreSQL"
memory --action list

First Run Flow

1. Extension detects no MEMORY.md exists
2. Creates BOOTSTRAP.md with setup instructions
3. AI reads BOOTSTRAP.md and asks user questions interactively
4. AI writes to MEMORY.md, IDENTITY.md, USER.md
5. AI deletes BOOTSTRAP.md manually
6. Setup complete

Context Injection

The following files are automatically injected into the system prompt at session start:

• MEMORY.md — Long-term memory
• IDENTITY.md — AI identity
• USER.md — User profile

Daily logs are not auto-injected and must be accessed via the memory tool.

License

MIT