Todo lo que tu equipo y administradores necesitan saber para instalar, operar y sincronizar la memoria persistente de IA en sus entornos de desarrollo.
INICIO RÁPIDO PARA NUEVOS MIEMBROS (30 SEGUNDOS)
1. INSTALAR
Instala el CLI global en tu máquina:
$ npm i -g @simplexlat/memhub
2. CONECTAR
En la carpeta de tu repositorio corre:
$ mh login
3. PROGRAMAR
Abre Cursor o Claude Code. ¡Tu IA ya tiene todo el contexto!
Sincronizado con el equipo
Comandos de la CLI (`mh` / `memhub`)
7 comandos
$ mh loginAutenticación & Configuración de IDEs
Inicia sesión con tu navegador, detecta automáticamente el repositorio Git y autoinyecta los conectores MCP y reglas en tus IDEs.
Aspectos clave:
Abre el navegador para que autorices tu máquina con un solo clic.
Detecta el remote de Git (GitHub/GitLab) para asociarte al proyecto del equipo.
Inyecta la configuración MCP y el protocolo de memoria persistente.
Salida de ejemplo:
🔑 Starting browser login flow for MemHub...
✅ Successfully authenticated as Nelson Sarcos (nelsonsarcos@gmail.com)
📡 Linked repository: https://github.com/NLSARCOS/memhub.git
✓ Claude Code: MCP and rules configured
✓ Cursor: .cursorrules and mcp.json configured
✓ Antigravity: global rules configured
$ mh statusEstado de Sincronización y Outbox
Muestra el identificador de tu dispositivo, secuencia monotónica, eventos pendientes en outbox y proyecto activo.
Aspectos clave:
Te permite comprobar si tienes cambios locales pendientes por sincronizar.
Muestra la ruta de la base de datos local SQLite WAL.
Verifica la integridad de las herramientas locales de memoria, la base de datos SQLite, la conectividad con la nube y comprueba si hay nuevas versiones en NPM.
Aspectos clave:
Comprueba que tu API Key y URL estén conectadas a la nube.
Valida que el motor SQLite local funcione correctamente.
Salida de ejemplo:
🩺 Running MemHub Doctor...
1. Checking local engine tools: ✓ Found 53 native tools mapped.
2. Checking local durable outbox: ✓ SQLite DB accessible.
3. Checking MemHub Cloud API: ✓ Reachable at https://memhub.simplex.lat.
4. Checking for CLI updates: ✓ MemHub CLI is up to date (v0.1.3).
$ mh rulesInyectar/Refrescar Reglas de IA
Inserta o actualiza el Protocolo de Memoria Persistente en todos los archivos de reglas de tus IDEs (CLAUDE.md, .cursorrules, AGENTS.md, etc.) de forma no destructiva.
Aspectos clave:
Úsalo cuando creas un repositorio nuevo y quieres añadir las reglas de memoria al instante.
Actualiza solo el bloque de MemHub sin borrar tus otras reglas personalizadas.
Salida de ejemplo:
📝 Injecting MemHub memory protocol rules...
✓ Claude Code (Workspace): updated at CLAUDE.md
✓ Cursor (.cursorrules): updated at .cursorrules
✓ Antigravity (Global): updated
✓ Agents Specification (AGENTS.md): updated
$ mh updateActualizar CLI a la Última Versión
Comprueba el registro oficial de NPM y actualiza automáticamente tu paquete global `@simplexlat/memhub`.
Aspectos clave:
Mantiene tu CLI siempre al día con un solo comando.
Soporta el flag --canary para builds de prueba anticipada.
Salida de ejemplo:
🔍 Checking for MemHub CLI updates on npm...
Current version: v0.1.2
📦 Updating @simplexlat/memhub via npm...
✅ MemHub CLI updated successfully to v0.1.3!
$ mh flushForzar Envío Inmediato a la Nube
Fuerza el envío instantáneo de todos los eventos del outbox SQLite local hacia la base de datos PostgreSQL en la nube sin esperar al temporizador automático.
Aspectos clave:
Útil antes de apagar tu máquina o desconectarte de internet.
Garantiza que todas tus memorias locales estén respaldadas en la nube.
$ mh logoutDesvincular Dispositivo
Revoca la credencial de este dispositivo en la nube, libera el slot de dispositivo en tu suscripción y limpia el estado local de forma segura.
Aspectos clave:
Conserva todo tu historial de memorias en la nube intacto.
Libera el cupo de dispositivo para usarlo en otra máquina.
Herramientas MCP para los Agentes de IA
Las herramientas que tus agentes ejecutan de forma autónoma en segundo plano.
5 herramientas
Herramienta
Propósito y Cuándo se Invoca
Parámetros Principales
mem_savealias: memory_save
Guarda una nueva memoria técnica. La IA lo ejecuta autónomamente tras corregir bugs, tomar decisiones arquitectónicas o descubrir patrones.
title, type (bugfix|decision|architecture|pattern|discovery), content, topic_key
mem_searchalias: memory_recall
Busca en el corpus de memorias del equipo con búsqueda híbrida léxica y vectorial. Retorna resultados con latencia <3ms.
query, limit, mode
mem_context
Recupera el historial reciente de las últimas sesiones y decisiones del proyecto para alimentar el contexto inicial del agente.
None
mem_pinalias: is_pinned
Fija una directriz de arquitectura crítica en la sección /rules para que nunca sea olvidada ni compactada por los agentes.
memory_id
mem_session_summary
Resume la sesión de trabajo con Goal, Discoveries, Accomplished y Next Steps al cerrar una tarea o milestone.
Vinculación Inteligente por Repositorio Git (Git Remote)
MemHub unifica a todos los miembros de tu equipo mediante la URL canónica de GitHub/GitLab. Si tú tienes el repositorio en una carpeta llamada `/home/nelson/MemHub` y tu compañero lo tiene en `/Users/dev/mi-proyecto`, ambos sincronizan exactamente el mismo proyecto y las mismas memorias sin ninguna configuración manual.
MemHub — Memoria compartida para agentes de código IA