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#

python

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:

python

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

Environment variable override:

bash

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.