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 Jun 24, 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:
Newer release available (0.0.13)

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 Jun 24, 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.11.tar.gz (65.5 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.11-py3-none-any.whl (77.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: memento_brain_collector-0.0.11.tar.gz
  • Upload date:
  • Size: 65.5 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.11.tar.gz
Algorithm Hash digest
SHA256 7b4d2a034c843a5e3b8a1f1dfb046a84fe1d8fb30e3ab3c619fe81b33c2ca191
MD5 6f5e032368e8dccb23de87752b564f97
BLAKE2b-256 ca73a13ab7a9d7ef74ef95eb0a515078dc135803200b089775190efcaa14e2ca

See more details on using hashes here.

Provenance

The following attestation bundles were made for memento_brain_collector-0.0.11.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.11-py3-none-any.whl.

File metadata

File hashes

Hashes for memento_brain_collector-0.0.11-py3-none-any.whl
Algorithm Hash digest
SHA256 46519e7e45fc54b50f8ea5bad414039d73a275eecbb9656274a0a6765a73151d
MD5 53c9ce6e553d3310725fe2a6e5467ca3
BLAKE2b-256 b6dd820ead469786015cca95ea795f4c455020f121ac7ee4517479186074d698

See more details on using hashes here.

Provenance

The following attestation bundles were made for memento_brain_collector-0.0.11-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