Memory Ferry

Memory Ferry · 记忆摆渡 es una capa de memoria a largo plazo y de Skills reutilizables para agentes de IA, local-first y multidispositivo. Coloca una carpeta Vault normal en iCloud Drive, OneDrive, Dropbox, Syncthing o un NAS montado, y luego conecta Codex, Claude Code, Cursor, OpenCode, DeepSeek Harness, Gemini CLI, GitHub Copilot CLI y MiniMax Code a la misma memoria.

Documentación en chino · Guía de usuario en inglés · Manual de usuario en chino

La versión 0.6.0-beta.1 no proporciona cifrado de extremo a extremo. Nunca almacenses contraseñas, claves de API, tokens, claves privadas, códigos de recuperación u otros secretos.

Por qué existe

• Entre ordenadres: sincroniza archivos normales sin un plan de control alojado ni un demonio de base de datos.

• Multiagente: expón un único contrato MCP y CLI en lugar de atar la memoria a un proveedor de modelos.

• Compatible con el modo sin conexión: cada escritura es un evento JSON inmutable e independiente que se sincroniza más tarde.

• Tolerante a conflictos: las adiciones simultáneas nunca se sobrescriben entre sí; las actualizaciones convergen de forma determinista.

• Skills reutilizables: copia una única fuente de Vault a directorios de Skills específicos de cada agente mediante el hash de contenido en macOS y Windows.

• Bajo coste: reutiliza el almacenamiento y el softwre de sincronización que ya utilizas.

Related MCP server: ClawMem MCP Server

Agentes compatibles

Inicio rápido

Requiere Node.js 20 o superior:

npm install -g memory-ferry@beta

memory-ferry init "/path/to/your/synced/MemoryFerryVault"
memory-ferry agents install all
memory-ferry remember "Prefer concise answers" --kind preference --scope global
memory-ferry recall "answer style"
memory-ferry ui

Durante el período beta, usa la etiqueta explícita @beta. Actualiza o desinstala con:

npm install -g memory-ferry@beta
npm uninstall -g memory-ferry

El panel de control solo es accesible mediante loopback, se abre en tu navegador, admite inglés y chino, gestiona múltiples Vaults, conecta o desconecta agentes, migra de forma segura el contenido de los Vaults y reconcilia las Skills cada cinco minutos mientras está en ejecución.

Aplicación portátil para Windows

La versión para Windows x64 es una aplicación portátil MemoryFerry.exe: no requiere instalador ni una instalación separada de Node.js. Coloca el EXE en una carpeta permanente y haz doble clic en él. Se inicia sin ventana de consola y abre el panel de control local. Usa el MemoryFerry-CLI.cmd incluido cuando necesites salida por línea de comandos.

La versión beta no cuenta con firma de código comercial, por lo que Windows puede mostrar una advertencia de editor desconocido. Verifica el archivo SHA-256 incluido y mantén SmartScreen activado.

Modelo de almacenamiento

MemoryFerryVault/
├── memory-ferry.json
├── memory/events/<device-id>/<date>/<event-id>.json
└── skills/<skill-name>/...

La identidad del dispositivo, los relojes, las cachés de eventos y los índices de embeddings opcionales de Ollama permanecen fuera de la carpeta sincronizada. El Vault no contiene ninguna base de datos SQLite activa, WAL ni archivo de bloqueo.

Compatibilidad de actualización

Memory Ferry reconoce las instalaciones existentes de Agent Vault Sync:

• Se acepta agent-vault.json y se crea un nuevo manifiesto complementario memory-ferry.json sin eliminar el archivo antiguo.

• El estado de ~/.agent-vault-sync se migra a ~/.memory-ferry cuando el nuevo estado no existe.

• Las variables de entorno AGENT_VAULT_* siguen siendo respaldos para sus reemplazos MEMORY_FERRY_*.

• Al reconectar un agente, se elimina la antigua entrada gestionada agent-vault y se escribe memory-ferry.

• El alias de CLI heredado agent-vault sigue disponible durante el período de migración beta.

Haz una copia de seguridad de los Vaults importantes antes de actualizar y deja que tu cliente de sincronización termine antes de abrir el mismo Vault en otro ordenador.

Recuperación semántica opcional

Si tienes Ollama local disponible, recall y context combinan la similitud semántica con la puntuación de texto Unicode/CJK. Establece MEMORY_FERRY_EMBED=off o pasa --no-semantic para usar una búsqueda solo de texto. Los índices de embeddings permanecen locales y se reparan antes de que la primera consulta devuelva resultados después de una sincronización en la nube o una migración.

Desarrollo

npm ci
npm run test:all
npm audit --omit=dev
npm pack --dry-run

Las versiones de Windows se compilan y se someten a pruebas de humo en GitHub Actions. Consulta CONTRIBUTING.md, SECURITY.md y architecture.md.

Licencia

MIT. Las versiones independientes también incluyen Node.js y los avisos de licencia de terceros.