Skill: rokkiezeng/mamp-memory (version 1.2.1)

--- 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 ```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.


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (CRITICAL)