pi-agent-memory 0.1.1 → 0.2.1

package/README.md

@@ -1,8 +1,35 @@
 # pi-agent-memory
 
-Persistent memory extension for [pi-agents](https://github.com/badlogic/pi-mono) powered by [claude-mem](https://github.com/thedotmack/claude-mem).
-
-Gives pi-coding-agent and any pi-mono-based runtime cross-session, cross-engine memory by connecting to claude-mem's worker service.
+<p align="center">
+  <img src="https://raw.githubusercontent.com/ArtemisAI/pi-mem/main/pi-agent/banner.png" alt="Pi-agent-memory banner" width="600">
+</p>
+
+<p align="center">
+  <a href="https://github.com/thedotmack/claude-mem">
+    <img src="https://img.shields.io/github/stars/thedotmack/claude-mem?style=social&label=claude-mem" alt="GitHub Stars">
+  </a>
+  <a href="https://github.com/thedotmack/claude-mem/network/members">
+    <img src="https://img.shields.io/github/forks/thedotmack/claude-mem?style=social" alt="GitHub Forks">
+  </a>
+  <a href="https://www.npmjs.com/package/pi-agent-memory">
+    <img src="https://img.shields.io/npm/v/pi-agent-memory.svg" alt="npm version">
+  </a>
+  <a href="https://github.com/thedotmack/claude-mem/blob/main/LICENSE">
+    <img src="https://img.shields.io/badge/License-AGPL%203.0-blue.svg" alt="License">
+  </a>
+</p>
+
+> **Fork & adaptation of [claude-mem](https://github.com/thedotmack/claude-mem)** (55k+ stars, 4.4k+ forks) — the most popular persistent memory system for AI coding agents — now available as a native pi-mono extension.
+
+Gives pi-coding-agent and any pi-mono-based runtime cross-session, cross-engine memory by connecting to claude-mem's battle-tested worker service. Same compressed memory, same hybrid search (FTS5 + Chroma vector embeddings), same cross-engine sharing — built for pi-agents.
+
+## Why pi-agent-memory?
+
+- **Backed by claude-mem** — the #1 memory system for AI coding agents, trusted by 55k+ developers
+- **Cross-engine memory** — your pi-agent shares memory with Claude Code, Cursor, Codex, and OpenClaw sessions
+- **Hybrid search** — FTS5 full-text + Chroma vector embeddings for precise memory recall
+- **Zero config** — installs with one command, auto-connects to the claude-mem worker
+- **Battle-tested** — built on the same worker API powering thousands of daily sessions
 
 ## Installation
 
@@ -101,7 +128,7 @@ All engines write to the same `~/.claude-mem/claude-mem.db`, tagged by `platform
 | Cursor | `cursor` |
 | Codex | `codex` |
 
-Context injection returns observations from all engines for the same project by default.
+Context injection returns observations from all engines for the same project by default. Pass `platformSource` to filter by engine.
 
 ## Related Packages
 
@@ -129,6 +156,10 @@ pi -e ./extensions/pi-mem.ts
 pi install ./pi-agent
 ```
 
+## Credits
+
+This package is a fork and adaptation of [**claude-mem**](https://github.com/thedotmack/claude-mem) by [@thedotmack](https://github.com/thedotmack) — the leading persistent memory system for AI coding agents. All core memory infrastructure (worker service, SQLite + FTS5 database, Chroma vector embeddings, AI-powered compression) is provided by claude-mem.
+
 ## License
 
 AGPL-3.0 — same as [claude-mem](https://github.com/thedotmack/claude-mem/blob/main/LICENSE).

package/extensions/pi-mem.ts

@@ -23,7 +23,9 @@ import { basename } from "node:path";
 // Configuration
 // =============================================================================
 
-const WORKER_PORT = parseInt(process.env.CLAUDE_MEM_PORT || "37777", 10);
+const DEFAULT_WORKER_PORT = 37777;
+const parsedPort = process.env.CLAUDE_MEM_PORT ? parseInt(process.env.CLAUDE_MEM_PORT, 10) : DEFAULT_WORKER_PORT;
+const WORKER_PORT = Number.isFinite(parsedPort) ? parsedPort : DEFAULT_WORKER_PORT;
 const WORKER_HOST = process.env.CLAUDE_MEM_HOST || "127.0.0.1";
 const PLATFORM_SOURCE = "pi-agent";
 const MAX_TOOL_RESPONSE_LENGTH = 1000;
@@ -174,7 +176,7 @@ export default function piMemExtension(pi: ExtensionAPI) {
 			contentSessionId,
 			project: projectName,
 			prompt: event.prompt || "pi-agent session",
-			platform_source: PLATFORM_SOURCE,
+			platformSource: PLATFORM_SOURCE,
 		});
 
 		return undefined;
@@ -203,7 +205,7 @@ export default function piMemExtension(pi: ExtensionAPI) {
 
 		if (!contextText || contextText.trim().length === 0) return;
 
-		// Inject as a system message in the conversation
+		// Inject as a user message with XML tags to delineate memory context
 		return {
 			messages: [
 				...event.messages,
@@ -258,6 +260,7 @@ export default function piMemExtension(pi: ExtensionAPI) {
 			tool_input: event.input || {},
 			tool_response: toolResponseText,
 			cwd: sessionCwd,
+			platformSource: PLATFORM_SOURCE,
 		});
 
 		return undefined;
@@ -299,6 +302,7 @@ export default function piMemExtension(pi: ExtensionAPI) {
 		await workerPost("/api/sessions/summarize", {
 			contentSessionId,
 			last_assistant_message: lastAssistantMessage,
+			platformSource: PLATFORM_SOURCE,
 		});
 
 		// Delay completion to let in-flight observations arrive
@@ -306,6 +310,7 @@ export default function piMemExtension(pi: ExtensionAPI) {
 		setTimeout(() => {
 			workerPostFireAndForget("/api/sessions/complete", {
 				contentSessionId: sid,
+				platformSource: PLATFORM_SOURCE,
 			});
 		}, SESSION_COMPLETE_DELAY_MS);
 	});
@@ -358,7 +363,7 @@ export default function piMemExtension(pi: ExtensionAPI) {
 			const limit = Math.max(1, Math.min(typeof params.limit === "number" ? Math.floor(params.limit) : 5, MAX_SEARCH_LIMIT));
 			const project = encodeURIComponent(projectName);
 
-			const result = await workerGetText(`/api/search?q=${query}&limit=${limit}&project=${project}`);
+			const result = await workerGetText(`/api/search?query=${query}&limit=${limit}&project=${project}`);
 
 			const text = result || "No matching memories found.";
 			return {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pi-agent-memory",
-  "version": "0.1.1",
-  "description": "Claude-mem persistent memory extension for pi-agents. Cross-session, cross-engine memory via claude-mem's worker API.",
+  "version": "0.2.1",
+  "description": "Persistent memory for pi-agents, powered by claude-mem (55k+ stars). Cross-session, cross-engine memory with hybrid search.",
   "keywords": [
     "pi-package",
     "claude-mem",
@@ -38,6 +38,7 @@
   "files": [
     "extensions",
     "skills",
+    "banner.png",
     "README.md",
     "LICENSE"
   ]