agentmemory-architecture

Explains agentmemory's iii engine primitives, hybrid retrieval model, storage lifecycle, and port layout.

3|Updated Oct 25, 2025
One-click install
npx skills add https://github.com/Prismaibrowser/prismspace-web --skill agentmemory-architecture-prismaibrowser
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agentmemory-architecture
Source: https://github.com/Prismaibrowser/prismspace-web/tree/main/.agents/skills/agentmemory-architecture
Command: npx skills add https://github.com/Prismaibrowser/prismspace-web --skill agentmemory-architecture-prismaibrowser

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Understanding how agentmemory stores, indexes, and retrieves memories end to end is difficult without a map of its internals. This Skill explains the iii engine primitives, the hybrid retrieval pipeline, the storage lifecycle, and the port layout so you can reason about the system, extend it, or answer how it works under the hood. ## Core Features & Use Cases - iii Engine Primitives: Explains that everything is a function, trigger, or worker state on the iii engine, with new capabilities added as functions plus triggers. - Hybrid Retrieval Model: Covers BM25 keyword search, on-device vector similarity, and graph expansion over linked concepts, with no API key required by default. - Storage, Lifecycle, and Ports: Details memory fields, sessions, commit links, the capture-compress-consolidate-forget lifecycle, and the port block anchored at REST 3111. - Use Case: When extending agentmemory with a new capability, use this Skill to confirm you should register a new mem::* function and an api::* HTTP trigger rather than bypassing the engine. ## Quick Start Ask the agent to explain how agentmemory stores and retrieves memories end to end using this architecture Skill.

Frequently Asked Questions about agentmemory-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How does agentmemory store and retrieve memories?▼

agentmemory stores memories with content, concepts, files, importance, and timestamps, grouped into sessions and optionally linked to commits. Recall is hybrid, combining BM25 keyword search, vector similarity, and graph expansion over linked concepts.

How do I extend agentmemory with a new capability?▼

Extend agentmemory by registering a new function (mem::*) plus an HTTP trigger (api::*) on the iii engine. There is no separate plugin system, and new capabilities should not bypass the engine.

Does agentmemory require an API key for embeddings?▼

No, the default install needs no API key because embeddings run on-device and BM25 requires none. An LLM provider only adds richer summaries and auto-injection, both of which are opt-in.

What ports does agentmemory use by default?▼

REST is the anchor at 3111, streams run at 3112, the viewer at 3113, and the engine at 49134. The --instance N flag shifts the whole port block by N*100.

How does agentmemory prevent unbounded memory growth?▼

agentmemory applies a lifecycle of capture, compress, consolidate, and forget to keep the store useful over time. This prevents the memory store from growing without bound as sessions accumulate.