engram-wiki/01-setup-maquina-nueva.md

Engram — Setup en máquina nueva

Guía para instalar Engram en un equipo nuevo y recuperar toda la memoria del cloud.

---

1. Descargar el binario

Ve a:

https://github.com/Gentleman-Programming/engram/releases/latest

Descarga engram_1.15.2_windows_amd64.zip y extrae engram.exe en:

C:\Users\TuUsuario\bin\

---

2. Añadir al PATH

Abre PowerShell y ejecuta (solo una vez):

[Environment]::SetEnvironmentVariable("Path", "$env:USERPROFILE\bin;" + [Environment]::GetEnvironmentVariable("Path", "User"), "User")

Cierra y abre PowerShell de nuevo. Verifica:

engram version

---

3. Apuntar al servidor cloud

engram cloud config --server https://engram.v-encore-lab.com

---

4. Enrollar el proyecto

engram cloud enroll planificacion_proyectos

---

5. Descargar memorias del cloud

engram sync --cloud --project planificacion_proyectos --import

Esto descarga toda la memoria almacenada en el VPS a la máquina nueva.

---

6. Configurar OpenCode

engram setup opencode

---

7. Arrancar el servidor HTTP

engram serve

Déjalo corriendo en una terminal aparte.

---

8. Arranque automático con Windows

1. Pulsa Win + R y escribe:

shell:startup

2. Crea un archivo engram.bat con este contenido:

@echo off
start /min engram serve

A partir de ahora engram serve arranca solo cada vez que inicias Windows.

---

9. Verificar que todo funciona

Abre OpenCode en tu proyecto y escribe:

mem_context

Si responde con información de sesión, todo está funcionando correctamente.

---

Sync manual en cualquier momento

cmd /c "set ENGRAM_CLOUD_TOKEN=TOKEN_AQUI && engram sync --cloud --project nombre_proyecto"

---

Notas

• El cloud está en https://engram.v-encore-lab.com
• El dashboard está en https://engram.v-encore-lab.com/dashboard/
• La base de datos local está en C:\Users\TuUsuario\.engram\engram.db
• El autosync se ejecuta cada ~5 minutos automáticamente