myAI Memory Sync

How myAImemory-mcp Compares to Other Memory Tools

• **Privacy-First**: All data remains on your device, no personal information sent to external servers

• **Performance**: Leverages Claude's caching capabilities for dramatic speed improvements

• **Simplicity**: Natural language updates to your preferences across all Claude interfaces

• **MCP Integration**: Purpose-built as a Claude MCP for seamless integration

Quick Start

Server Options

Direct Sync Method (Simple Alternative)

• Read from your "myAI Master.md" file

• Update all CLAUDE.md files in your projects

• Update your Windsurf memory settings

• All without storing sensitive information in the git repository

Privacy and Security

• The "myAI Master.md" file with your personal information is excluded from git tracking

• All CLAUDE.md files are also excluded to protect your privacy

• Use the included `.gitignore` to ensure sensitive files remain private

Supported Natural Language Commands

Installation Options

Option 1: Direct Install (Recommended)

Option 2: Run from Source

Option 3: Docker

MCP Configuration

Claude Desktop Configuration

Claude.ai with Smithery

1. Visit [Smithery.ai](https://smithery.ai)

2. Add the myAI Memory Sync MCP: ``` @Jktfe/myaimemory-mcp ```

3. Configure with your API key in the Smithery settings

Windsurf Integration

HTTP Server Mode

Environment Variables

System Prompt Integration

Features

• **Cross-Platform Synchronization**: Update once, syncs everywhere

• **Lightning-Fast Recall**: Caching system with up to 2000x performance boost

• **Natural Language Interface**: Just talk naturally to update your preferences

• **Multiple Persona Profiles**: Switch between different presets with ease

• **Security-Focused**: Local storage with .gitignore protection

• **Developer-Friendly**: Full TypeScript implementation with comprehensive API

Core Architecture

• **Template Parser**: Bidirectional conversion between structured memory objects and markdown

• **Template Storage**: Persistent storage with in-memory and file-system caching

• **Platform Synchronizers**: Implements the `PlatformSyncer` interface for each target platform

• **Natural Language Processor**: Extracts structured data from natural language memory commands

• **Memory Cache Service**: Optimizes performance with multi-level caching strategies

Detailed Features

Cross-Platform Synchronization

• **ClaudeCodeSyncer**: Updates CLAUDE.md files across all repositories

• **WindsurfSyncer**: Manages global_rules.md in Windsurf environment

• **ClaudeWebSyncer**: Optional Puppeteer-based synchronization with Claude.ai web interface

Intelligent Memory Management

• **Pattern-Based Extraction**: Converts natural language to structured key-value pairs

• **Section Detection Algorithm**: Automatically determines appropriate section for new memories

• **Memory Template Format**: Markdown-based structure with sections, descriptions, and key-value items

• **Context Preservation**: Updates memory sections while preserving other template content

Performance Optimization

• **Multi-Level Caching**: In-memory caching at both template and section levels

• **TTL-Based Cache Management**: Configurable Time-To-Live for cached content

• **Pre-Warming**: Cache pre-population after template updates

• **Optional Anthropic API Integration**: Accelerates memory-related queries up to 2000x

Security

• **Local-First Architecture**: All data remains on your device

• **Gitignore Management**: Automatically adds CLAUDE.md to .gitignore in all repositories

• **File Permission Handling**: Fixes permissions issues for maximum compatibility

• **Encrypted Storage**: Compatible with encrypted file systems

Memory Template Format

Technical Implementation

MemoryTemplate Schema

Platform Synchronization Interface

MCP Integration API

Natural Language Interface

Advanced Usage

Memory Presets

Emergency Sync

Command Line Interface

Development Workflow

Performance Benchmarks

Security & Privacy

• All data remains locally on your device

• CLAUDE.md files are automatically added to .gitignore

• No data is sent to external servers (except when using the optional Anthropic API integration)

• Works with encrypted file systems for maximum security

Troubleshooting

Common Issues

1. **CLAUDE.md Not Updating** - Check file permissions with `ls -la CLAUDE.md` - Try emergency sync with `./emergency-sync.sh` - Verify platform paths in your `.env` file

2. **MCP Connection Failures** - Ensure MCP server is running with `ps aux | grep myai-memory` - Check Claude Desktop logs for MCP errors - Verify your Claude Desktop configuration file

3. **Caching Issues** - Clear cache with `node dist/cli.js --clear-cache` - Verify Anthropic API key is correctly set - Check memory file integrity with `node dist/cli.js --validate`

4. **Natural Language Commands Not Working** - Make sure to use exactly one of the supported command patterns (see Supported Natural Language Commands section) - If Claude doesn't recognize your command, try a different pattern - For syncing across all platforms, use the direct script: `node sync-memory.js`

Manual Syncing

Logs and Debugging

• Linux/macOS: `~/.local/share/myai-memory/logs/`

• Windows: `%APPDATA%\myai-memory\logs\`

Contributing

1. Fork the repository

2. Create your feature branch (`git checkout -b feature/amazing-feature`)

3. Commit your changes (`git commit -m 'Add some amazing feature'`)

4. Push to the branch (`git push origin feature/amazing-feature`)

5. Open a Pull Request

• All PRs require passing tests and linting

• New features should include tests

• Major changes should update documentation

• Follow existing code style and patterns

Documentation

License

Contact