A tool for reading a More Protocol memory store and producing a portrait of the collaboration it holds.
Parses journal entries, handoffs, constraints, experience memories, and tags from a More Protocol directory and renders:
- Session timeline — dates, tone, and what was built each session
- Handoffs — grouped by status (active / partial / parked / resolved / superseded / expired / deprecated), with a staleness flag for
active/partialhandoffs that haven't been touched in a while - Constraints — binding rules currently in force, with scope (global / project) and any exemptions
- Growth — a timeline of
experiencememories, marking shifts in understanding over time - Topic threads — tags ranked by frequency across sessions, handoffs, constraints, and experience memories
- Tone over time — the emotional texture of the collaboration as a chronological strip
- Index health —
MEMORY.mdline count against the spec's recommended 200-line ceiling
Output uses rich formatting by default; falls back to plain text with --no-color.
Requires a directory conforming to the More Protocol spec. The tool reads:
MEMORY.md— the index, for a line-count health checkjournal/*.md— session entries with frontmatter (date,tags) and section headings (## Tone,## What we built, etc.)handoff/*.md— handoff files with frontmatter (id,status,subject,tags,created,updated,expires; legacyexpires_afterstill read)constraints/*.md— constraint files with frontmatter (id,subject,scope,project,exempt,tags)experience/*.md— experience files with frontmatter (id,subject,created,tags)
Without a More Protocol store there is nothing to read.
pip install -r requirements.txtDependencies: pyyaml, rich (optional but recommended).
# Uses $MORE_PATH or ~/more by default
python3 more_map.py
# Point at a specific More Protocol directory
python3 more_map.py --more /path/to/more
# Plain text output
python3 more_map.py --no-colorThe MORE_PATH environment variable can be set to avoid passing --more each time.