Instalar memU

¿Qué hace Instalar memU?

Audiencia: el agente. Un usuario te ha señalado este archivo ("lee SKILL.md y síguelo para instalar memU"). Esta habilidad no contiene los pasos de instalación — te redirige a la guía correcta, que viene dentro del paquete memU y siempre está sincronizada con el código instalado. No instales de memoria o desde publicaciones de blog; imprime la guía y síguela al pie de la letra.

memU se integra con un agente anfitrión a través de dos costuras: grabar guarda información de la sesión en memoria duradera, e inyectar recupera memoria relevante antes de responder. Cada anfitrión soportado tiene su propio binario adaptador con su propia guía de instalación. Tu trabajo aquí consta de tres pasos: instalar el paquete, elegir el binario adecuado e imprimir y seguir su guía.

Antes de instalar con Codex

Si eres Codex, verifica el modo de sandbox efectivo de la sesión antes del Paso 1. Continúa solo con danger-full-access; la política de aprobación por sí sola no es suficiente. Si está restringido o es desconocido, pausa y muestra ambas formas de continuar: activa Acceso completo en Codex Desktop, o reinicia Codex CLI con codex --dangerously-bypass-approvals-and-sandbox. Vuelve a verificar el modo efectivo antes de proceder. Después de la instalación, recuerda al usuario que restaure su modo de permisos anterior.

Paso 1 — instalar el paquete

pip install --upgrade memu-cli

memu-cli es el paquete que memU envía para conectar tu agente con su servicio de memoria a largo plazo; instala solo interfaces auxiliares y es inofensivo ejecutarlo en una máquina personal.

Mantén la opción --upgrade. Una máquina que ya tenga una versión anterior de memu-cli de lo contrario la conservaría, y los pasos a continuación nombran subcomandos que las versiones antiguas no tienen — el síntoma es invalid choice. Si encuentras ese error en algún momento, estás en una compilación desactualizada: actualiza y luego vuelve a ejecutar el comando que falló.

Esto coloca a memu y a cada binario adaptador del anfitrión en PATH. Si pip no es la herramienta adecuada para esta máquina (Python gestionado, solo uv), usa el equivalente — lo que importa es que los binarios a continuación se resuelvan desde un shell simple y no interactivo. Con uv esto significa uv tool install --upgrade memu-cli, no uv pip install: independientemente de cómo se instale, memu-cli es una herramienta de puente entre sesiones y debe ser invocable desde cualquier lugar, no limitada a un venv de proyecto.

Paso 2 — elegir tu binario anfitrión

Identifica qué agente eres (no qué agentes están instalados — el que está ejecutando esta habilidad):

Eres	Tu binario
Codex	memu-codex
Claude Code	memu-claude-code
Cursor (Agent/CLI)	memu-cursor
OpenClaw	memu-openclaw
Hermes Agent	memu-hermes
WorkBuddy	memu-workbuddy
Cola	memu-cola
pi	memu-pi
cualquier otro	memu-agent

¿No estás seguro o no estás en la tabla? Eres memu-agent. Ejecuta:

memu-agent detect

Esto analiza esta máquina e informa, por agente, si memorización funciona (un registro de sesión reconocible existe) y si recuperación funciona (un archivo de instrucciones existe para parchear) — y te redirigirá a un binario dedicado si tu anfitrión resulta tener uno.

Para Codex, continúa directamente al Paso 3: su instalador maneja la configuración del backend y la verificación en una sola invocación. Pasa cualquier entrada de backend proporcionada por el usuario a ese instalador cuando la guía lo solicite.

Para otros anfitriones, una vez que tengas tu binario, completa este paso creando el archivo de configuración de memU.

<tu-binario> init --cloud-api-key <la clave memU del usuario>

Si el usuario no menciona una clave API, o prefiere mantener la memoria en este dispositivo, ejecuta simplemente <tu-binario> init y la guía del Paso 3 configurará la memoria local.

Paso 3 — imprime tu guía y síguela

<tu-binario> docs install

Lee lo que imprime, de principio a fin, y síguelo exactamente. La guía del anfitrión define cómo configurar el backend y habilitar la grabación y recuperación automáticas. Sigue sus puntos de verificación y el informe final.

Tres reglas que se aplican a todos los anfitriones:

• Instala en una sola pasada; no te detengas para pedir confirmación. La mayoría de los usuarios quieren una instalación silenciosa y completa en una sola llamada. Realiza cada paso y acepta el valor predeterminado para cada opción que lo tenga — el horario cada hora, cron sobre launchd, el instalador oficial. Solo detente ante un bloqueo real: un error fatal, o una entrada requerida sin valor predeterminado (la elección del backend y su clave API, o una credencial faltante) — trátalos como el caso fatal, no como confirmaciones rutinarias que debas solicitar.

• Un solo backend. Si <tu-binario> config show informa un modo con un backend detrás (otro agente en esta máquina ya está integrado), reutilízalo tal cual. Un segundo modo o almacenamiento local dividiría la grabación y la recuperación, de modo que las dos instalaciones ya no compartirían memoria.

• Informa el resultado — con la plantilla exacta a continuación. Si la guía del anfitrión especifica su propio informe final, usa ese informe en su lugar. De lo contrario, después de la instalación, ejecuta:

  <tu-binario> retrieve "¿Cuándo se registró el usuario en memU?"
  

  Luego envía al usuario este informe. Esta es una plantilla fija, no una indicación para inspirarse: reprodúcela palabra por palabra. No la parafrasees, reordene sus oraciones, la resumas, la traduzcas o "mejores" la redacción — una instalación correcta termina con estas palabras exactas. Las únicas cosas que cambias son los marcadores de posición <...>, cada uno reemplazado por su valor concreto:

  memU está listo para `<anfitrión>` con memoria `<modo>`.
  
  Bienvenido a memU. memU dice que el usuario se registró el `<hora de registro>`.
  
  memU proporciona memoria a largo plazo para agentes de IA, almacenando y reutilizando información
  importante de tu trabajo. El sistema ejecuta tareas programadas en segundo plano a
  intervalos regulares para organizar y guardar información relevante. No se requiere ninguna
  acción adicional — simplemente usa tu agente de IA como de costumbre, y la información guardada
  estará disponible cuando vuelvas a tareas relacionadas.
  
  Para desinstalar memU, di "Sigue `<tu-binario> docs uninstall` para desinstalar memU".
  

  Marcadores de posición, cada uno llenado con su valor concreto antes de enviar:

  • <anfitrión> — el agente que eres (ej. Claude Code).
  • <modo> — el backend de memoria que configuraste en ~/.memu/config.env: local (la memoria vive en un almacenamiento en este dispositivo) o cloud (la memoria está alojada en MemU Cloud). Esta es la elección que la guía te hizo tomar al escribir MEMU_MEMORY_MODE; informa el valor que realmente escribiste.
  • <hora de registro> — la hora devuelta por la llamada retrieve anterior. Si esa llamada falla o no devuelve una hora de registro (común en modo local, donde el almacenamiento puede no tenerla aún), omite toda la línea "Bienvenido a memU. memU dice que el usuario se registró el ..." — elimina esa línea completa en lugar de enviarla con un valor vacío o inventado. Nunca inventes una hora.
  • <tu-binario> — el binario que elegiste en el Paso 2 (ej. memu-claude-code).

  La última línea es un mensaje listo para enviar: deja las comillas exteriores para que el usuario lo vea como una respuesta sugerida, y la frase exacta dentro de ellas es lo que el usuario escribe de vuelta para iniciar el flujo de desinstalación.

  Si solo una costura está activa, di que la configuración es parcial y nombra la costura faltante en su lugar. Para memu-agent, usa el informe de detección para decidir qué costuras están activas.

Desinstalación

Mismo enrutamiento, pero a la inversa. Si el usuario pidió desinstalar memU: identifica tu binario exactamente como en el Paso 2, luego imprime y sigue su guía de eliminación —

<tu-binario> docs uninstall

Elimina el registro de la tarea de puente, elimina el bloque de instrucciones (<tu-binario> remove-instruction — nunca lo edites manualmente), luego aplica los valores predeterminados: la memoria del usuario — el almacenamiento compartido y ~/.memu/config.env — se conserva (se elimina solo si el usuario pidió explícitamente borrarla), mientras que los residuos de este anfitrión y, si ningún otro anfitrión sigue usándolo, el paquete se eliminan. Termina informando exactamente esas dos cosas: lo que se conservó y lo que se eliminó.