Initial commit - Engram wiki docs

This commit is contained in:
minguezsanzjuanjose
2026-05-03 14:41:28 +02:00
commit fc7fc16073
4 changed files with 382 additions and 0 deletions

122
01-setup-maquina-nueva.md Normal file
View File

@@ -0,0 +1,122 @@
# 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):
```powershell
[Environment]::SetEnvironmentVariable("Path", "$env:USERPROFILE\bin;" + [Environment]::GetEnvironmentVariable("Path", "User"), "User")
```
Cierra y abre PowerShell de nuevo. Verifica:
```powershell
engram version
```
---
## 3. Apuntar al servidor cloud
```powershell
engram cloud config --server https://engram.v-encore-lab.com
```
---
## 4. Enrollar el proyecto
```powershell
engram cloud enroll planificacion_proyectos
```
---
## 5. Descargar memorias del cloud
```powershell
engram sync --cloud --project planificacion_proyectos --import
```
Esto descarga toda la memoria almacenada en el VPS a la máquina nueva.
---
## 6. Configurar OpenCode
```powershell
engram setup opencode
```
---
## 7. Arrancar el servidor HTTP
```powershell
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:
```bat
@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
```powershell
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