MAMP

---

name: mamp-memory description: Mark AI Memory Protocol — persistent, searchable session memory for AI agents. SQLite-only, zero external dependencies. author: LeoTseng version: 1.2.1 license: MIT-0 security: credential_access: false # Local SQLite only, no external services or credentials data_persistence: true # Writes to a local .db file on disk

---

MAMP — Mark AI Memory Protocol

Gives AI agents persistent, searchable memory using SQLite.

When to Use

User says "remember what I told you last time"

Agent needs to recall facts across conversations

User asks about past topics, preferences, or decisions

Context window is filling up and older info needs to be summarized

Core Concepts

Session — a conversation, has an ID, survives restarts

Turn — one message in a session (role: user/assistant)

Tag — labels for a turn, e.g. ["finance", "important"]

Priority — importance level: critical, normal, trivial

Key Methods

from importlib.util import spec_from_file_location, module_from_spec
spec = spec_from_file_location("mamp", "ai_memory_protocol_v1.2.0.py")
mod = module_from_spec(spec)
spec.loader.exec_module(mod)
Manual mode — explicit add_turn() calls
sm = mod.SessionManager()
sm.start_conversation()
sm.add_turn("user", "I prefer dark mode")
sm.add_turn("assistant", "Noted")
Auto mode (v1.1.8+) — auto-captures turns without manual add_turn()
sm = mod.SessionManager(auto_record=True)
sm.start_conversation()
... conversations are recorded automatically ...
sm.stop()  # flushes buffer and disables auto_record
Heartbeat (v1.1.9+) — called externally every ~5 min via Hermes cron
sm.heartbeat()  # flushes buffer + closes idle sessions (>30 min)
Explicit db_path (recommended)
sm = mod.SessionManager(db_path="./memory.db", auto_record=True)
Environment variable override:
export MARK_MEMORY_DB=/path/to/memory.db

What It Solves

AI forgets everything each conversation. MAMP makes memory persistent, searchable, and structured — without any external service, API key, or dependency beyond SQLite.

Security Notes

Default behavior — local directory only:

DB file written to ./mark_memory.db in the current working directory

No system directories are touched

No log files, audit files, or hidden state files are written

No network access, no external services

Pass an explicit path to isolate data:

sm = mod.SessionManager(db_path="/your/specific/path/memory.db")

Environment variable override:

export MARK_MEMORY_DB=/your/specific/path/memory.db

This takes precedence over both the default and any db_path argument.

Permissions awareness:

The DB file contains your conversation history in plaintext

Ensure the directory has appropriate access controls

If multiple agents run on the same host with the same path, they share memory — use different paths per agent to isolate

No credentials stored:

MAMP uses no API keys, tokens, or secrets. It is a pure local SQLite store.