@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

2. Install

bash

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

3. Configure

Set the API key as an environment variable:

bash

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

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

json

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

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

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

bash

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

License

Apache-2.0