membase

# Membase Memory Management

Membase provides secure, decentralized memory storage for AI agents with end-to-end encryption.

## When to Use This Skill

Activate this skill when the user:
- Asks to backup their memories, conversations, or workspace
- Wants to restore previous memories or conversations
- Wants to see available backups
- Asks to compare different backup versions
- Wants to check backup status
- Mentions "membase" or "backup memories"

## Overview

All Membase operations go through a single command:

```bash
node membase.ts <command> [options]
```

Available commands:
- `backup` - Backup memories to Membase
- `restore` - Restore memories from a backup
- `list` - List all available backups
- `diff` - Compare two backups
- `status` - Show backup status and statistics
- `cleanup` - Clean up old backups

## Configuration

### Environment Variables

```bash
export MEMBASE_ACCOUNT=your-account-address
export MEMBASE_SECRET_KEY=your-secret-key
export MEMBASE_BACKUP_PASSWORD=your-backup-password
export MEMBASE_ENDPOINT=https://testnet.hub.membase.io
```

Check if configured:
```bash
echo $MEMBASE_ACCOUNT
echo $MEMBASE_SECRET_KEY
echo $MEMBASE_BACKUP_PASSWORD
```

## Commands

### 1. backup - Backup Memories

Backs up agent memory files (MEMORY.md, memory/**/*.md) to Membase with AES-256-GCM encryption.

**Usage:**
```bash
node membase.ts backup [options]
```

**Options:**
- `--password <pwd>` or `-p <pwd>` - Encryption password (required if not in env)
- `--incremental` or `-i` - Only backup changed files since last backup
- `--workspace <path>` - Custom workspace directory
- `--no-validate` - Skip password strength validation
- `--no-json` - Don't output JSON for agent parsing

**Example conversation:**

User: "Please backup my memories"

You should:
1. Check for MEMBASE_BACKUP_PASSWORD:
   ```bash
   echo $MEMBASE_BACKUP_PASSWORD
   ```

2. If not set, ask: "Please provide a backup password for encryption (at least 12 characters with uppercase, lowercase, an...