eml-memory-curate
Markdown-frontmatter memory curator for agentic Claude / LLM sessions.
Tiered indexing, semantic search, and contradiction flagging on top of
any directory of Markdown files. Sister package to
eml-memory — that one ships
the typed JSONL store; this one curates a Markdown index of memory
"topics" with one file per topic.
Install
# core (text search only)
pip install eml-memory-curate
# with semantic search
pip install eml-memory-curate[embeddings]
Quick start
Each topic lives in its own Markdown file with optional frontmatter:
---
name: Buzzard drama
description: Capacitor C7 spec mismatch caught at QC stage 3.
type: feedback
---
The vendor-supplied capacitor on revision B07 has a 30% lower
ESR rating than the BOM specifies. Caught by QC stage 3 thermal
imaging on 2026-04-28...
Run the curator on the directory:
$ eml-memory-curate audit ~/.claude-memory
Memory dir: ~/.claude-memory
Entries: 111
Total bytes: 424,049
...
$ eml-memory-curate curate ~/.claude-memory
Curated 111 entries into 4 tier files.
MEMORY.md 63 entries 22,920 bytes (OK 22KB)
MEMORY_RECENT.md 25 entries 12,400 bytes
MEMORY_ARCHIVE.md 23 entries 18,200 bytes
TAGS.md 111 entries 38,100 bytes
$ eml-memory-curate query ~/.claude-memory "buzzard drama"
Top 3 semantic match(es) for 'buzzard drama':
[0.821] 2026-04-28 [feedback ] feedback_buzzard.md
Capacitor C7 spec mismatch caught at QC stage 3.
...
What it does
| subcommand | description |
|---|---|
audit |
Counts, sizes, oldest/newest, tier preview |
curate |
Regenerate MEMORY.md + MEMORY_RECENT.md + MEMORY_ARCHIVE.md + TAGS.md |
query |
Semantic search (with text fallback) |
tags |
Show all inferred topic tags |
embed |
Build the embedding index (requires [embeddings]) |
contradict |
Flag numeric conflicts between recent and older same-tag memories |
Design
- Per-topic files are sacred. The curator never edits or deletes
source
.mdfiles. Only the four index files are regenerated. - Hot-tier byte cap.
MEMORY.mdstays under a configurable cap (default 22 KB) so it loads uncompressed in an LLM session. Older / less-critical entries flow intoMEMORY_RECENT.mdthenMEMORY_ARCHIVE.md. - Evergreen rules. Entries typed
feedback,user, orreferencestay in the hot tier regardless of age. Sessions / projects age out. - Contradiction scan is advisory. When a recent memory says "21 backends" and an older same-tag memory said "18 backends", the curator flags it for human review. It never auto-resolves.
Configuration
Override the memory directory via $EML_MEMORY_CURATE_DIR or pass it
as the first positional argument to every subcommand. Tier knobs
(--hot-max-bytes, --recent-days, --archive-days, --title) live
on the curate subcommand.
Python API
from eml_memory_curate import collect_entries, tier_entries, find_contradictions
entries = collect_entries(Path("~/.claude-memory").expanduser())
hot, recent, archive = tier_entries(entries)
conflicts = find_contradictions(entries, recent_n=10)
Roadmap
- v0.2 — sync adapter for
eml-memory's typed JSONL store, so the two packages share one source of truth. - v0.3 — registry-drift check (volatile keys vs live values), once generalized away from the monogate-research builder.
- v1.0 — bundled embedding model + SQLite backend.
License
PROPRIETARY-PRE-RELEASE.
Metadata
Release files for eml-memory-curate 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| eml_memory_curate-0.1.0.tar.gz | 19.2 kB | Without provenance | Details for eml_memory_curate-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| eml_memory_curate-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for eml_memory_curate-0.1.0-py3-none-any.whl |
Total release size: 37.2 kB
Release files / eml_memory_curate-0.1.0.tar.gz
| Download URL | eml_memory_curate-0.1.0.tar.gz |
|---|---|
| Size | 19.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2a5a2e3ce17c3da4c7a590fe6c0be6f9c6c2731fbbd45b4cdfe59e4982d992e5
|
|
BLAKE2b-256 checksum How to use checksums |
902ec88113a50eb4bc2b3891cca9e5b53e25fb2126151dc8b102e24fd1121d46
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
Release files / eml_memory_curate-0.1.0-py3-none-any.whl
| Download URL | eml_memory_curate-0.1.0-py3-none-any.whl |
|---|---|
| Size | 18.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8222641a891acc7d9bac0bc2b0aa36876813feac01012d6ee4027d71513caf64
|
|
BLAKE2b-256 checksum How to use checksums |
a5c6143a3d5b41f59fab84e7696a7c95b3f6dbc2a857bbdfdc6b1b86dc3ec960
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
Security for eml-memory-curate 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.