memo-bridge（备忘录桥）

MemoBridge — AI Memory Migration Skill

Purpose

MemoBridge extracts, standardizes, and migrates AI memories across tools and workspaces. AI assistants accumulate valuable context over time — user preferences, project history, knowledge progress, vocabulary lists, daily routines. This skill ensures none of that is lost when switching tools or machines.

When to Use

• User wants to switch AI coding tools (CodeBuddy → Claude Code → Cursor → OpenClaw → Hermes)
• User wants to export or backup their AI memory
• User wants to onboard a new AI assistant with existing context
• User wants to share AI context with a teammate
• User is setting up a new machine or workspace
• User mentions "记忆迁移", "导出记忆", "memory export/import/migrate"

Prerequisites

Node.js >= 22.0.0 must be installed. The MemoBridge CLI is available at the project root.

Supported Tools (8 total)

Core Workflow

Step 1: Detect installed tools

Run the detect command to discover all AI tools on the system:

cd {project_root}
node dist/cli.js detect

This scans for local tools (CodeBuddy/OpenClaw/Hermes/Claude Code/Cursor) and lists cloud tools (ChatGPT/Doubao/Kimi) that require prompt-guided export.

Step 2: Extract memories

For local tools (direct file access):

# CodeBuddy — auto-scans all workspaces
node dist/cli.js extract --from codebuddy -o ./memo-bridge.md

# CodeBuddy — specific workspace
node dist/cli.js extract --from codebuddy --workspace /path/to/project -o ./memo-bridge.md

# OpenClaw
node dist/cli.js extract --from openclaw -o ./memo-bridge.md

# Hermes Agent
node dist/cli.js extract --from hermes -o ./memo-bridge.md

# Claude Code
node dist/cli.js extract --from claude-code -o ./memo-bridge.md

# Cursor (with workspace for project rules)
node dist/cli.js extract --from cursor --workspace /path/to/project -o ./memo-bridge.md

For cloud tools (prompt-guided), generate the optimal export prompt:

node dist/cli.js prompt --for doubao
node dist/cli.js prompt --for kimi
node dist/cli.js prompt --for chatgpt

Then instruct the user to: copy the prompt → paste into the AI tool's chat → copy the AI's response → save as a file.

Step 3: Import memories

For file-based tools:

# To Claude Code (appends to CLAUDE.md)
node dist/cli.js import --to claude-code --input ./memo-bridge.md

# To Hermes Agent (auto-trims to 2200 UTF-8 bytes)
node dist/cli.js import --to hermes --input ./memo-bridge.md

# To OpenClaw (appends to MEMORY.md)
node dist/cli.js import --to openclaw --input ./memo-bridge.md

# To Cursor (requires --workspace)
node dist/cli.js import --to cursor --input ./memo-bridge.md --workspace /path/to/project

# To CodeBuddy
node dist/cli.js import --to codebuddy --input ./memo-bridge.md --workspace /path/to/project

For instruction-based tools:

# Generates text for user to paste into ChatGPT/Doubao/Kimi
node dist/cli.js import --to doubao --input ./memo-bridge.md
node dist/cli.js import --to chatgpt --input ./memo-bridge.md
node dist/cli.js import --to kimi --input ./memo-bridge.md

Step 4: One-step migration (shortcut)

node dist/cli.js migrate --from codebuddy --to claude-code
node dist/cli.js migrate --from openclaw --to hermes

Key Options

Extending with Custom Adapters

Third-party adapters can be registered at runtime via the public registry API — useful when a user has a proprietary or yet-unsupported tool:

import { extractorRegistry, importerRegistry, BaseExtractor } from 'memo-bridge';

class MyToolExtractor extends BaseExtractor {
  readonly toolId = 'my-tool' as any;
  async extract() { /* ... */ }
}

extractorRegistry.register('my-tool' as any, () => new MyToolExtractor());

See references/adapter-guide.md for the full three-step adapter recipe.

Intermediate Format

The standard interchange format is memo-bridge.md — Markdown with YAML front matter. See references/format-spec.md for the complete specification.

Key properties:

• Human-readable (any text editor)
• LLM-friendly (can be used directly as CLAUDE.md)
• Git-friendly (plain text, version-trackable)
• Tool-namespaced extensions section preserves tool-specific data

(Hermes skills, OpenClaw SOUL/DREAMS, …) across migrations without polluting the common memory lists.

Security Features

• Privacy sanitization: Automatically redacts 18 types of sensitive

information (API keys, passwords, tokens, SSH keys, emails, private IPs, Authorization headers, custom API headers like X-API-Key, database connection strings with embedded credentials).

• Path validation: Prevents path traversal and symlink attacks;

case-insensitive on Windows so c:\program files can't bypass the denylist.

• Content size limits: 5MB write limit, 10MB read limit enforced on

every extractor file read (no more unbounded reads).

• System directory protection: Blocks writes to /etc, /bin,

/usr, etc. — except OS-managed temp subtrees (/var/folders/, /var/tmp/, /private/tmp/).

• Strict tool-id validation: CLI --from / --to / --for args

are validated against the registered tool list before dispatch.

Error Handling

• If no workspaces found: suggest --workspace or --scan-dir flags
• If tool not detected: suggest installing the tool or using prompt-guided export
• If import fails due to permissions: suggest checking file permissions or using --dry-run first
• If Hermes import exceeds limit: content is automatically prioritized and trimmed

Building from Source

To build the CLI before first use:

cd {project_root}
npm install
npm run build

The project has 395 unit tests and a GitHub Actions CI that runs lint → test → build on every push. To verify the local install:

npm test    # ~500ms