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.12.tar.gz (66.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.12-py3-none-any.whl (78.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: memento_brain_collector-0.0.12.tar.gz
  • Upload date:
  • Size: 66.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.12.tar.gz
Algorithm Hash digest
SHA256 a36d6c86c971c2f931d6c40875bf5588e730068f5a8687b98166ec8e709058bc
MD5 83be9937ba79f907b13d130c1fdfa355
BLAKE2b-256 3b186d6e14ff241875747620a74222ffd8c61129cbd14783471fdfc8ccfdf0c8

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for memento_brain_collector-0.0.12-py3-none-any.whl
Algorithm Hash digest
SHA256 185552123c4ec064c566fda69103151b351606977616b5b728c01c024a7c0bb6
MD5 4d3ea6267301815287cc5be40085bd82
BLAKE2b-256 46ba1d3140b4c6b78fe0c6c8a10afe197a13fdb5c0bb08cfb2c3ca7328a5d489

See more details on using hashes here.

Provenance

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