@mem0/pi-agent-plugin

Persistent semantic memory for Pi Agent, powered by Mem0.

This extension gives Pi Agent long-term memory that persists across sessions, projects, and devices. Memories are automatically captured from conversations and can be searched, managed, and consolidated through slash commands and an agent-accessible tool.

Features

• Automatic memory capture — learns from every conversation (both user and assistant messages)
• Semantic search — find memories by meaning, not just keywords
• Scoped memory — project, session, or global scope
• Monorepo-aware — uses git root for project detection, consistent app_id across subdirectories
• Dream consolidation — merges duplicates, resolves contradictions, prunes stale entries
• Confirmation dialogs — destructive commands ask before acting
• 8 slash commands — essential memory management from the command line
• Agent tool — mem0_memory tool lets the agent search and store memories autonomously

Setup

1. Get an API key

Sign up at app.mem0.ai and copy your API key.

2. Install

pi install npm:@mem0/pi-agent-plugin

3. Configure

Set the API key as an environment variable:

export MEM0_API_KEY="m0-your-key-here"

Or create a config file at ~/.pi/agent/mem0-config.json:

{
  "apiKey": "m0-your-key-here",
  "userId": "your-username",
  "autoCapture": true,
  "defaultScope": "project",
  "searchThreshold": 0.2,
  "dream": {
    "enabled": true,
    "auto": true,
    "minHours": 24,
    "minSessions": 5,
    "minMemories": 20
  }
}

Environment variables (MEM0_API_KEY, MEM0_USER_ID) override the config file.

searchThreshold (default 0.3) is the minimum similarity score (0–1) a memory must reach to count as a match for /mem0-search, /mem0-forget, and /mem0-pin. It is passed to the mem0 search API (along with reranking for higher-precision ordering), so a query with no sufficiently similar memory reports no match instead of returning the closest unrelated memories. Raise it to be stricter; lower it if relevant results are missed.

Commands

Command	Description
/mem0-remember <text>	Store a memory verbatim (no inference)
/mem0-forget <query>	Search and delete memories (with confirmation)
/mem0-search <query>	Semantic search across memories
/mem0-tour [scope]	Browse all memories grouped by category
/mem0-dream	Consolidate — merge duplicates, prune stale, resolve contradictions
/mem0-pin <query>	Pin a memory to protect from dream pruning (preserves ID)
/mem0-scope <scope>	Change default scope for this session
/mem0-status	Connection health, identity, and memory count

Skills

The plugin includes 8 skills that guide the agent on how to use each capability:

Skill	Purpose
context-loader	Pre-fetch relevant memories at session start
remember	Store facts with category classification
search	Quick semantic search with compact results
forget	Delete memories with confirmation
dream	Memory consolidation workflow
tour	Full memory walkthrough by category
pin	Protect critical memories from pruning
status	Health check and diagnostics

Memory Scopes

Scope	Filters	Use case
project	user + app_id (git root)	Default. Project-specific knowledge
session	user + app_id + run_id	Ephemeral, session-only context
global	user only	All memories across all your projects

Project scoping uses git rev-parse --show-toplevel to detect the repository root, so all subdirectories within a monorepo share the same memory pool.

Memory Categories

Memories are automatically classified into 10 general-purpose categories:

Category	Description
identity	Personal details, background, self-descriptions
preferences	Likes, dislikes, habits, preferred approaches
goals	Objectives, aspirations, targets
projects	Ongoing work, initiatives, areas of focus
decisions	Choices made, rationale, trade-offs
technical	Technical knowledge, tools, configurations
relationships	People, teams, organizations
routines	Recurring patterns, workflows, schedules
lessons	Insights learned, mistakes to avoid
work	Professional context, role, responsibilities

Architecture

pi-agent-plugin/
├── src/
│   ├── entry.ts          # Extension entry point
│   ├── index.ts          # Barrel exports
│   ├── commands.ts       # 8 slash commands
│   ├── prompt.ts         # System prompt injection (MEMORY_POLICY)
│   ├── types.ts          # Shared interfaces and categories
│   ├── telemetry.ts      # PostHog telemetry (batched, PII-safe)
│   ├── config/           # Config loading (~/.pi/agent/mem0-config.json)
│   ├── memory/           # Tool registration, scoping (git root), formatting
│   ├── capture/          # Auto-capture from conversations (user + assistant)
│   └── dream/            # Consolidation state, gating, locking, prompts
├── skills/               # 8 SKILL.md files for Pi Agent
├── tests/                # Vitest unit tests
└── dist/                 # Built output (ESM + DTS)

Development

pnpm install          # Install dependencies
pnpm run typecheck    # Type check
pnpm run test         # Run tests
pnpm run build        # Build (ESM + declarations)

License

Apache-2.0