refactor: consolidate agent/editor plugins under integrations/ (#5491)

Co-authored-by: Claude <noreply@anthropic.com>
2026-06-12 10:31:35 +05:30
parent c676c2c458
commit 2c796d144f
295 changed files with 94 additions and 81 deletions
@@ -0,0 +1,144 @@
+# @mem0/pi-agent-plugin
+
+Persistent semantic memory for [Pi Agent](https://pi.dev), powered by [Mem0](https://mem0.ai).
+
+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](https://app.mem0.ai/dashboard/api-keys) and copy your 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](LICENSE)