memento-collector

Cross-platform agent that automatically collects AI coding tool memory files and syncs them to a central Memento server (a shared brain for your AI coding tools).

Supported AI Tools

Tool Data Collected
Claude Code Conversations, memory, plans, history
OpenClaw Sessions, identity, memory, learnings, skills
Codex Sessions (active + archived), history, skills
Antigravity Full conversations (built-in .pb decryption — AES-256-GCM + protobuf), brain plans, code snapshots
Obsidian All markdown notes in your vault
Cursor Agent transcripts, skills, MCP config

Install

pip install memento-brain-collector

Antigravity support (decrypting encrypted .pb conversation files) is built in — no extras needed. The cryptography library is already a required dependency.

Quick Start

# Interactive setup (first time)
memento-collector setup

# Or run directly
memento-collector run

The setup wizard will:

  1. Detect your platform (macOS / Linux / Windows)
  2. Auto-discover installed AI tools and Obsidian vaults
  3. Configure the server URL and auth token
  4. Optionally install as a system service (auto-start on boot)

Commands

memento-collector setup      # Interactive setup wizard
memento-collector run        # Run in foreground
memento-collector install    # Install as system service
memento-collector start      # Start the service
memento-collector stop       # Stop the service
memento-collector status     # Show collector status
memento-collector uninstall  # Remove system service

How It Works

  1. File Watching — Uses watchdog (FSEvents on macOS, inotify on Linux, ReadDirectoryChanges on Windows) to detect file changes in real-time
  2. Parsing — Supports Markdown, JSONL, JSON, TOML, SQLite formats
  3. Sanitization — Automatically redacts API keys, tokens, passwords, private keys before upload
  4. Queuing — Local SQLite queue for offline resilience (syncs when server is reachable)
  5. Syncing — HTTP upload to server, with chunked upload for files > 2MB (tested with 37MB files)
  6. Device Identity — Each device gets a persistent unique ID, all data tagged with device info

Configuration

Environment variables (or set via memento-collector setup):

Variable Default Description
MEMENTO_SERVER_URL http://localhost:8001 Server API URL
MEMENTO_SERVER_TOKEN Collector auth token
MEMENTO_OBSIDIAN_VAULT_PATH Auto-detected Obsidian vault path

Config file: ~/.memento/config.json

System Service

Platform Service Type Config Location
macOS LaunchAgent ~/Library/LaunchAgents/com.memento.collector.plist
Linux systemd user ~/.config/systemd/user/memento-collector.service
Windows Task Scheduler MementoCollector scheduled task

License

MIT

Project links

Data verified by PyPI on Jul 12, 2026
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:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for ddong1 from gravatar.com ddong1

Credits

Author: ddong8

GitHub Statistics

Data verified by PyPI on Jul 12, 2026
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

GNU Affero General Public License v3 (AGPL-3.0-only)

Requires

Python >=3.10

Provides Extra

dev

Tags

ai antigravity claude codex collector cursor memento memento-brain obsidian openclaw

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

memento_brain_collector-0.0.13.tar.gz (67.3 kB view details)

Uploaded Source

Built Distribution

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

memento_brain_collector-0.0.13-py3-none-any.whl (79.4 kB view details)

Uploaded Python 3

File details

Details for the file memento_brain_collector-0.0.13.tar.gz.

File metadata

  • Download URL: memento_brain_collector-0.0.13.tar.gz
  • Upload date:
  • Size: 67.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for memento_brain_collector-0.0.13.tar.gz
Algorithm Hash digest
SHA256 a46abd44d5313631a86addc8c9091b8ab6c68476c4f12be96f810ad91a118968
MD5 b46ace01c76eca9d6648b3563460e3e8
BLAKE2b-256 548e3b90566b44bf58362dac23c21cbf54dc6f72776f31df92b5a77d89a1696c

See more details on using hashes here.

Provenance

The following attestation bundles were made for memento_brain_collector-0.0.13.tar.gz:

Publisher: release.yml on ddong8/memento

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

File details

Details for the file memento_brain_collector-0.0.13-py3-none-any.whl.

File metadata

File hashes

Hashes for memento_brain_collector-0.0.13-py3-none-any.whl
Algorithm Hash digest
SHA256 13b537f14e4dc106fabde7d8e8b15df528ef5eedb0f80d63f9095103e9a5e15d
MD5 e9d6eefe3f3c80c39ca3e8122412fdfc
BLAKE2b-256 1d5d163186bfccc683e94f536cb5ff54b7e84823d733277b7b3d9ded645f1ddd

See more details on using hashes here.

Provenance

The following attestation bundles were made for memento_brain_collector-0.0.13-py3-none-any.whl:

Publisher: release.yml on ddong8/memento

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 Sentry Error logging StatusPage Status page