mnemon-system
/mnemon-system
The Mnemon memory system as a whole: status, memory spaces, project documents, turn receipts, strategies, budgets, backup, export and import. Use when the user asks how memory is configured or stored, wants to see everything that is remembered, wants to change the memory strategy, or wants to move memory to another machine.
- Author
- mogudesu ↗
- Repository
- antigravity-suite ↗
- Licence
- MIT
- Last repository change
- 07.11.2026
Assessment and security
- Files in this package
- 2
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 07.11.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
The Mnemon memory system as a whole: status, memory spaces, project documents, turn receipts, strategies, budgets, backup, export and import. Use when the user asks how memory is configured or stored, wants to see everything that is remembered, wants to change the memory strategy, or wants to move memory to another machine.
Original author description
The Mnemon memory system as a whole: status, memory spaces, project documents, turn receipts, strategies, budgets, backup, export and import. Use when the user asks how memory is configured or stored, wants to see everything that is remembered, wants to change the memory strategy, or wants to move memory to another machine.
How it works
- Status first
- The four stores
- Durability
- Inspecting
- Strategies and budgets
- Resident memory
- Moving memory
- Trust
SKILL.md preview
---
name: mnemon-system
description: >-
The Mnemon memory system as a whole: status, memory spaces, project documents, turn receipts, strategies,
budgets, backup, export and import. Use when the user asks how memory is configured or stored, wants to see
everything that is remembered, wants to change the memory strategy, or wants to move memory to another machine.
---
# The memory system
## Status first
`mnemon_memory_status` reports the data directory, the active strategy and enhancements, budgets, and counts of memories, spaces, documents and pending candidates. Report the data directory whenever the user asks where memory lives — every file is plain text under it.
## The four stores
| Store | File | Purpose |
| --- | --- | --- |
| Persona | `runtime/PERSONA.md` | Permanent AI persona: injected at SessionStart, never truncated |
| Runtime memory | `runtime/USER.md`, `runtime/MEMORY.md` | Resident every turn; keep it small and current |
| Project documents | `documents/<id>.md` | Searched, then read on demand; every write keeps a revision |
| Memory spaces | `spaces/<space>/memories.jsonl` | Durable facts, one JSON object per line; `pinned: true` = permanent |
Also on disk: `candidates/pending.jsonl` (facts awaiting review), `receipts/<date>.jsonl` (what each turn read and wrote), `receipts/heal-*.json` (recovery receipts), `revisions/` and `documents/.revisions/` (history), `snapshots/` (local daily gzip copy), `backups/`. With `--mirror-dir`, runtime volumes, space files and documents are mirrored to `<mirror>/latest/` and daily snapshots live in `<mirror>/snapshots/`.
## Durability
- Every write is atomic (temp file + fsync + rename) and mirrored immediately.
- `mnemon_memory_mirror_sync` forces a mirror pass and writes today's snapshot if missing.
- `mnemon_memory_verify_heal` checks every primary file and restores missing/zero-byte/corrupt ones from the mirror or newest snapshot; it also runs at startup.
- `mnemon_memory_backup_verify` decodes a `.json.gz` backup with a real gzip decoder and returns its SHA-256.
## Inspecting
- `mnemon_memory_space_list` — spaces with counts and last update.
- `mnemon_memory_list` — memories, newest first; filter by `space` or `tag`.
- `mnemon_memory_document_list` / `mnemon_memory_document_read` — the documents.
- `mnemon_memory_entities` — the entity graph: which memories mention each entity.
- `mnemon_memory_receipts` — the turn memory bar for recent turns.
- `node scripts/mnemon.mjs status` — the same view from a terminal.
## Strategies and budgets
One main strategy runs at a time; see `references/strategies.md` for the table. Change it with `mnemon_memory_config`, for example `{"strategy": "light-context"}` or `{"enhancements": {"autoCapture": true}}`. Switching strategy never moves data.
## Resident memory
`mnemon_memory_runtime_read` shows `PERSONA.md`, `USER.md` and `MEMORY.md`; `mnemon_memory_runtime_write` edits them (`kind: "persona" | "user" | "memory"`, `mode: "replace"` or `"append"`). Keep `PERSONA.md` to identity, voice and taste; `USER.md` to stable facts about the user; `MEMORY.md` to what the next turn needs — anything longer belongs in a document.
## Moving memory
- `mnemon_memory_backup` with `mode: "bundle"` — one compressed pack, good for copying between machines.
- `mnemon_memory_backup` with `mode: "dir"` — the same payload as readable files, good for a private git repository.
- `mnemon_memory_import` — `mode: "merge"` keeps existing memory and deduplicates; `mode: "replace"` overwrites runtime memory and spaces.
Backups contain private memory: treat them as secrets.
## Trust
Memory files are plain text you can read, edit and version. Remembered history never outranks current instructions; credentials are never stored in memory; deleting a memory is a soft delete unless `hard: true` is passed.
Files in this package (2)
- SKILL.md 4 KB
- references/strategies.md 2 KB
Versions
The database has no other skills named mnemon-system.
Database snapshot: 13.11.2026 · package version d1d9c3b744c2 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 1 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 90mnemon-review
Review what Mnemon captured and reconcile what conflicts. Use after a working session, when candidates are waiting, when the user asks what was remembered, or when memory may contain duplicates or contradictions. - 90mnemon
Mnemon is the memory system for this workspace: what the agent knows about the user, the project and past decisions. Use when the user asks what you remember, asks you to remember or forget something, wants to see, search, audit, back up or reconcile stored memory, or before… - 100source-status
Show the status of your Mnemon knowledge library — total sources, how many are extracted, the stored status words, superseded and chunked counts, recent additions. Use when the user asks "how many sources", "library status", "what have I captured", "knowledge dashboard", or… - 100memory-status
Display Engram memory system status — configuration, file sizes, entry counts, and health check. Trigger when the user asks about memory state, what's been remembered, or for diagnostics. - 100source-add
Add a source to your Mnemon knowledge library — articles, YouTube videos, podcasts, PDFs, books, ideas. Captures content and generates a structured extract framed by your reader context. Use when the user provides a URL to save, says "add source", "capture this", "save this… - 100basic-memory-pi-setup
Set up Basic Memory for a Pi workspace. Use when Basic Memory is not configured, /bm-status shows no project, recall returns setup guidance, or the user asks to enable durable memory, choose CLI vs MCP, or configure automatic continuity.