MOOTx01 Memory Adapter

Drop-in /memories backend with governance for the Anthropic memory_20250818 tool.

What it does

Any Claude 4+ / Fable 5 agent that thinks it is reading and writing /memories files is actually reading and writing governed MOOTx01 drawers — with dedup, provenance, sensitivity floor, confirmation state, and a full audit trail included.

The differentiator

Every model-written memory lands as unconfirmed with derived trust. A startup scan or audit pass can quarantine suspect lessons using the estate's contained filter and anomaly lenses. This is the poisoning defense the ecosystem currently lacks — the memory tool contract gives models write access; MOOTx01 gives you the governance to trust (or not trust) what they wrote.

Two surfaces

1. MCP tool (built into mootx01)

The mootx01 daemon registers a memory tool on its MCP surface that matches Anthropic's contract exactly. Claude Code and Claude Desktop users already connected to mootx01 as an MCP server get the memory tool for free — no adapter needed.

2. Python SDK handler (this package)

For Messages API users who run the tool-use loop themselves:

from moot_memory import MootMemoryTool
import anthropic

client = anthropic.Anthropic()
memory = MootMemoryTool(base_url="http://127.0.0.1:4242")

runner = client.beta.messages.tool_runner(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Remember that Acme prefers email."}],
    tools=[memory],
)
final = runner.until_done()

Or standalone without the SDK:

from moot_memory import MootMemoryHandler

handler = MootMemoryHandler(base_url="http://127.0.0.1:4242")
result = handler.execute({"command": "view", "path": "/memories"})

Op mapping

memory_20250818 Estate behavior
view (dir) enumerate drawers in wing="memories"
view (file) drawer content with line numbers
create capture as unconfirmed drawer
str_replace supersede: new content, old withdrawn (full lineage)
insert supersede: content with insertion applied
delete soft withdrawal (never hard-erase from model ops)
rename capture at new location, withdraw old

Security

  • Path traversal protection: all paths validated against /memories
  • Model writes land unconfirmed: poisoning quarantine seam
  • Deletes are soft withdrawals: reversible, audit trail preserved
  • Sensitivity floor: adapter wing is Normal
  • File size cap: 100KB per file
  • No hidden files: dotfiles rejected

Tests

# Against the running daemon
python -m pytest apps/moot-memory-adapter/tests/

# The poisoning quarantine test
python -m pytest apps/moot-memory-adapter/tests/test_memory_adapter.py::TestPoisoningQuarantine -v

Requirements

  • Running mootx01 daemon (v1.0.22+)
  • Python 3.10+
  • anthropic SDK (optional, for the BetaAbstractMemoryTool subclass)

Project links

Data verified by PyPI on
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.0.40)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for bob-codedaptive from gravatar.com bob-codedaptive

Credits

Author: Codedaptive

GitHub Statistics

Data verified by PyPI on 
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python >=3.10

Provides Extra

anthropic

Tags

anthropic claude memory mcp mootx01 ai-memory

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

moot_memory-1.0.37.tar.gz (7.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

moot_memory-1.0.37-py3-none-any.whl (5.5 kB view details)

Uploaded Python 3

File details

Details for the file moot_memory-1.0.37.tar.gz.

File metadata

  • Download URL: moot_memory-1.0.37.tar.gz
  • Upload date:
  • Size: 7.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for moot_memory-1.0.37.tar.gz
Algorithm Hash digest
SHA256 4f4a745b9fe84db3260fc50e6811583a7d310f8ef4bf94310a0fdc58c71c833f
MD5 bee58a6c9cc89e1d3f8f9cf4a3da529e
BLAKE2b-256 8995937212a2fc14868002c2e2276faf120839f457932b4e7ed54f809c2aa532

See more details on using hashes here.

Provenance

The following attestation bundles were made for moot_memory-1.0.37.tar.gz:

Publisher: release.yml on codedaptive/mootx01-ce

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file moot_memory-1.0.37-py3-none-any.whl.

File metadata

  • Download URL: moot_memory-1.0.37-py3-none-any.whl
  • Upload date:
  • Size: 5.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for moot_memory-1.0.37-py3-none-any.whl
Algorithm Hash digest
SHA256 2f87d5828bcc3ef545a38d87d518e977cf0bbffa627e056b7cd135e0cb1e4192
MD5 eaaeab36beffb7650a7dff82565a79e6
BLAKE2b-256 f5d8662f61f4b0ac9c5beb14992e060e0f4a7b28c762b4940676abb6f14faf6a

See more details on using hashes here.

Provenance

The following attestation bundles were made for moot_memory-1.0.37-py3-none-any.whl:

Publisher: release.yml on codedaptive/mootx01-ce

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page