Repository navigation
MemCtrl v1.2.1 — Credibility Hardening
What's New
Benchmarks & Trust
- Honest capability benchmark replaces misleading precision claims
- Retrieval precision fixed: synonym expansion, layer boost, confidence weighting, relative threshold filtering
CLI Polish
- Starting MCP server
Use Ctrl+C to stop no longer shows fake port/host args - Package description aligned with v1.2 positioning
Durability
- All 19 SQLite write paths wrapped with exponential backoff retry
- Tree LLM clustering batched to 20 memories per prompt
Docs & Demos
- New migration demo: +-------------------------------------------------------------------+
| MemCtrl Migration Demo |
| Your Agent's Memory Travels With You |
| --- |
| Watch project context move seamlessly from Claude Code to Cursor. |
+-------------------------------------------------------------------+
----------------------- PHASE 1: Coding in Claude Code ------------------------
+-------------------------------- Claude Code --------------------------------+
| I'm reviewing the auth system. Let me store what I learn so I don't have to |
| rediscover it in the next session. |
+-----------------------------------------------------------------------------+ - OTel memory spec submitted to OpenTelemetry GenAI SIG
Install
Requirement already satisfied: memctrl in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (1.2.0)
Requirement already satisfied: mcp>=1.0.0 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from memctrl) (1.27.1)
Requirement already satisfied: python-dotenv>=1.0.0 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from memctrl) (1.0.1)
Requirement already satisfied: rich>=13.0.0 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from memctrl) (15.0.0)
Requirement already satisfied: typer>=0.12.0 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from memctrl) (0.24.2)
Requirement already satisfied: watchdog>=4.0.0 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from memctrl) (6.0.0)
Requirement already satisfied: anyio>=4.5 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from mcp>=1.0.0->memctrl) (4.13.0)
Requirement already satisfied: httpx-sse>=0.4 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from mcp>=1.0.0->memctrl) (0.4.3)
Requirement already satisfied: httpx<1.0.0,>=0.27.1 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from mcp>=1.0.0->memctrl) (0.28.1)
Requirement already satisfied: jsonschema>=4.20.0 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from mcp>=1.0.0->memctrl) (4.26.0)
Requirement already satisfied: pydantic-settings>=2.5.2 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from mcp>=1.0.0->memctrl) (2.7.0)
Requirement already satisfied: pydantic<3.0.0,>=2.11.0 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from mcp>=1.0.0->memctrl) (2.13.4)
Requirement already satisfied: pyjwt>=2.10.1 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from pyjwt[crypto]>=2.10.1->mcp>=1.0.0->memctrl) (2.13.0)
Requirement already satisfied: python-multipart>=0.0.9 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from mcp>=1.0.0->memctrl) (0.0.29)
Requirement already satisfied: pywin32>=310 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from mcp>=1.0.0->memctrl) (311)
Requirement already satisfied: sse-starlette>=1.6.1 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from mcp>=1.0.0->memctrl) (3.4.4)
Requirement already satisfied: starlette>=0.27 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from mcp>=1.0.0->memctrl) (1.0.1)
Requirement already satisfied: typing-extensions>=4.9.0 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from mcp>=1.0.0->memctrl) (4.15.0)
Requirement already satisfied: typing-inspection>=0.4.1 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from mcp>=1.0.0->memctrl) (0.4.2)
Requirement already satisfied: uvicorn>=0.31.1 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from mcp>=1.0.0->memctrl) (0.34.0)
Requirement already satisfied: certifi in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from httpx<1.0.0,>=0.27.1->mcp>=1.0.0->memctrl) (2026.4.22)
Requirement already satisfied: httpcore==1.* in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from httpx<1.0.0,>=0.27.1->mcp>=1.0.0->memctrl) (1.0.9)
Requirement already satisfied: idna in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from httpx<1.0.0,>=0.27.1->mcp>=1.0.0->memctrl) (3.13)
Requirement already satisfied: h11>=0.16 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from httpcore==1.*->httpx<1.0.0,>=0.27.1->mcp>=1.0.0->memctrl) (0.16.0)
Requirement already satisfied: annotated-types>=0.6.0 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from pydantic<3.0.0,>=2.11.0->mcp>=1.0.0->memctrl) (0.7.0)
Requirement already satisfied: pydantic-core==2.46.4 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from pydantic<3.0.0,>=2.11.0->mcp>=1.0.0->memctrl) (2.46.4)
Requirement already satisfied: attrs>=22.2.0 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from jsonschema>=4.20.0->mcp>=1.0.0->memctrl) (26.1.0)
Requirement already satisfied: jsonschema-specifications>=2023.03.6 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from jsonschema>=4.20.0->mcp>=1.0.0->memctrl) (2025.9.1)
Requirement already satisfied: referencing>=0.28.4 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from jsonschema>=4.20.0->mcp>=1.0.0->memctrl) (0.37.0)
Requirement already satisfied: rpds-py>=0.25.0 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from jsonschema>=4.20.0->mcp>=1.0.0->memctrl) (0.30.0)
Requirement already satisfied: cryptography>=3.4.0 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from pyjwt[crypto]>=2.10.1->mcp>=1.0.0->memctrl) (48.0.0)
Requirement already satisfied: cffi>=2.0.0 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from cryptography>=3.4.0->pyjwt[crypto]>=2.10.1->mcp>=1.0.0->memctrl) (2.0.0)
Requirement already satisfied: pycparser in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from cffi>=2.0.0->cryptography>=3.4.0->pyjwt[crypto]>=2.10.1->mcp>=1.0.0->memctrl) (3.0)
Requirement already satisfied: markdown-it-py>=2.2.0 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from rich>=13.0.0->memctrl) (4.0.0)
Requirement already satisfied: pygments<3.0.0,>=2.13.0 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from rich>=13.0.0->memctrl) (2.20.0)
Requirement already satisfied: mdurl~=0.1 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from markdown-it-py>=2.2.0->rich>=13.0.0->memctrl) (0.1.2)
Requirement already satisfied: click>=8.2.1 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from typer>=0.12.0->memctrl) (8.3.3)
Requirement already satisfied: shellingham>=1.3.0 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from typer>=0.12.0->memctrl) (1.5.4)
Requirement already satisfied: annotated-doc>=0.0.2 in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from typer>=0.12.0->memctrl) (0.0.4)
Requirement already satisfied: colorama in C:\Users\kjsc\AppData\Local\Programs\Python\Python313\Lib\site-packages (from click>=8.2.1->typer>=0.12.0->memctrl) (0.4.6)