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.38.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.38-py3-none-any.whl (5.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: moot_memory-1.0.38.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.38.tar.gz
Algorithm Hash digest
SHA256 bf18253f1dd1dbcd6e21c88b1ab9255894fd297c0fbf62fda769ebb26d43a031
MD5 0d63994e333e88aadb4d91bbc72fb65d
BLAKE2b-256 a9adf4e8db188909f3482c649c763737f71da548d36b09efb578b8f471ea10e3

See more details on using hashes here.

Provenance

The following attestation bundles were made for moot_memory-1.0.38.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.38-py3-none-any.whl.

File metadata

  • Download URL: moot_memory-1.0.38-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.38-py3-none-any.whl
Algorithm Hash digest
SHA256 cf036ac1ea93cc087af64d4df232b2d296ff100f034a8b9fa55f2fae4e3ad044
MD5 4fa1ec5004a98c4ae93cb604cdee673f
BLAKE2b-256 9be8d0b6015a52829c04d78bf9a5e6a62096292340334e8e66bf8d23ead0af50

See more details on using hashes here.

Provenance

The following attestation bundles were made for moot_memory-1.0.38-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