Tutorial · Desktop local + agentes

Comenzar con DEKS Desktop

Crea o abre un archivo .deks que tú y un agente pueden editar juntos. Desktop guarda todo en tu equipo: no requiere cuenta ni se conecta a DEKS Cloud.

Comenzar la instalación Ver código fuente

5 etapas · 15–25 min · macOS, Windows o Linux

Local · guardadoTu presentación, en un archivo .deks.

Un mismo documento. Cambios visibles. Sin una copia remota oculta.

01 · Preparar
Descarga la última release para tu plataforma
Los botones usan releases/latest/download y nombres de archivo estables, así GitHub entrega el instalador vigente sin fijar una versión en esta guía. El alias latest se actualiza con cada release publicada desde un tag Desktop, no con cada commit a main.
macOSDescargar deks-desktop-macos-universal.dmgWindowsDescargar deks-desktop-windows-x64.exeLinuxDescargar deks-desktop-linux-x64.AppImage
Descargar MSI para Windows Descargar DEB para Linux Descargar RPM para Linux Ver metadatos latest.json Descargar checksums SHA256SUMS.txt Ver página de la release
Verifica la descarga antes de abrirla. Compara el checksum SHA-256 del instalador con SHA256SUMS.txt. Si prefieres revisar las notas y todos los assets primero, abre la página de la release.
02 · Tu archivo
Crea una presentación o abre una existente
Al iniciar Desktop, crea una presentación nueva o abre un archivo .deksexistente. Cada presentación es un único archivo portable que contiene el documento y sus imágenes.
1. Escribe el nombre y elige el tamaño de la presentación.
2. Desktop guarda el archivo .deks en tu carpeta Deks predeterminada.
3. Ábrelo en Desktop y confirma que el guardado local está activo.
Archivo y carpeta cumplen roles distintos. El archivo .dekses la presentación. Una carpeta sólo sirve para organizar archivos y delimitar cuáles puede ver el MCP local.
La presentación se crea como un archivo .deks local; no hace falta iniciar sesión.
03 · Agente local
Conecta el MCP local
Desktop y el MCP leen los mismos archivos .deks. Autoriza con DEKS_PROJECTS_ROOT sólo la carpeta que contiene los archivos que quieres compartir con el agente. Cada escritura exige revisión e idempotencia antes de reemplazar el archivo de forma atómica.
En concreto, una mutación envía expected_revision e idempotency_key. Si otro proceso escribió primero, el agente debe volver a leer y reconciliar en vez de sobrescribir.
1. Abre Configuración → Agentes. Desktop lista sólo los arneses instalados en este equipo.
2. Elige Instalar global para la configuración personal del arnés, o Instalar en carpeta para dejar listo un espacio de trabajo del agente. Cada instalación copia las skills y escribe la entrada deks —y sólo esa— en la configuración MCP del cliente, guardando antes una copia del archivo original.
3. Una instalación por carpeta autoriza esa misma carpeta como DEKS_PROJECTS_ROOT; la global usa la ubicación local configurada por Desktop.
4. Instala una vez las dependencias del runtime y el Chromium aislado para previews:
Las ubicaciones instaladas quedan en una lista dentro de la misma pantalla. Quitar una detiene futuras actualizaciones de la integración y no borra tus archivos.
```
cd /ABSOLUTE/PATH/TO/deks-local-mcp
npm ci --omit=dev
npm run install-browser
```
ChatGPT Desktop + Codex
Agrega el servidor STDIO local
Desktop los configura por ti desde Configuración → Agentes. Para hacerlo a mano: ChatGPT Desktop, Codex CLI y la extensión IDE comparten la configuración del mismo host, así que puedes usar Settings → MCP servers → Add server, elegir STDIO y pegar el comando, o registrarlo desde la terminal:
codex mcp add deks-local \ --env DEKS_PROJECTS_ROOT=/ABSOLUTE/PATH/TO/DEKS-PROJECTS \ -- node /ABSOLUTE/PATH/TO/deks-local-mcp/mcp/server.mjs codex mcp list
Guarda, selecciona Restart y escribe /mcp en el composer para confirmar que deks-local está conectado.
Revisar la guía oficial de MCP local
Claude Desktop + Claude Code
Combina JSON o usa la CLI
Si prefieres hacerlo a mano, en Claude Desktop abre Settings → Developer → Edit Config y combina esta entrada en claude_desktop_config.json, dentro del objeto mcpServers existente; no reemplaces otros servidores:
claude_desktop_config.json
{ "mcpServers": { "deks-local": { "type": "stdio", "command": "node", "args": ["/ABSOLUTE/PATH/TO/deks-local-mcp/mcp/server.mjs"], "env": { "DEKS_PROJECTS_ROOT": "/ABSOLUTE/PATH/TO/DEKS-PROJECTS" } } } }
Para Claude Code, registra el mismo runtime con alcance de usuario:
claude mcp add --transport stdio --scope user deks-local \ -e DEKS_PROJECTS_ROOT=/ABSOLUTE/PATH/TO/DEKS-PROJECTS \ -- node /ABSOLUTE/PATH/TO/deks-local-mcp/mcp/server.mjs claude mcp list
Reinicia Claude Desktop o recarga la configuración; en Claude Code ejecuta /mcp. Confirma que deks-local aparece conectado antes de editar.
Revisar Claude Desktop · Revisar Claude Code
Conexión local verificada. Con el servidor instalado, el agente puede listar, leer, editar y previsualizar los archivos .deks autorizados.
04 · Método + herramientas
Instala y usa las dos skills
El plugin separa intención visual y operación segura. Úsalas juntas cuando el agente deba diseñar y además cambiar el documento.
No hay que instalarlas aparte: cualquier instalación desde Configuración → Agentes deja el servidor MCP y estas dos skills juntos. Sin el servidor el agente no puede tocar la presentación; sin las skills no sabe cómo hacerlo bien.
$design-deks-presentationsDecide la historia
Estructura narrativa, sistema visual, movimiento y revisión renderizada.
$deks-presentationsOpera el documento
Lecturas frescas, revisiones, lotes atómicos, validación y recuperación segura.
Alternativa: instalar el plugin completo en ChatGPT Desktop
Clona el paquete, registra el checkout como marketplace local y reinicia la app:
git clone https://github.com/eigen-cl/deks-plugin.git codex plugin marketplace add /ABSOLUTE/PATH/TO/deks-plugin codex plugin marketplace list
En Plugins Directory, abre EIGEN Plugins e instaladeks-plugin.
Alternativa: instalar el plugin completo en Claude Code
claude plugin marketplace add eigen-cl/deks-plugin claude plugin install deks-plugin@eigen-plugins claude plugin enable deks-plugin@eigen-plugins
Ejecuta /reload-plugins si Claude lo solicita.
Prompt de prueba“Usa $design-deks-presentations y $deks-presentations para revisar mi deck, proponer una historia de cinco slides y aplicar sólo el primer cambio. Valida y muéstrame el preview antes de continuar.”
Código del paquete: eigen-cl/deks-plugin.
05 · Revisar
Editar localmente
1. Pide al agente listar y leer la presentación abierta.
2. Aprueba un cambio acotado y revisa la nueva revisión en Desktop.
3. Previsualiza las slides, corrige overflow y guarda el archivo .deks.
Desktop termina en tu archivo. El MCP local no publica ni crea enlaces, y Desktop no se conecta a DEKS Cloud. Si copias o mueves el .deks, la presentación y sus imágenes viajan juntas.
Abrir la última release Entender el archivo .deks
Desktop abre y guarda el mismo archivo .deks que puede editar el agente local.

Contrato local

Lo que permanece bajo tu control

Desktop edita sin red y no necesita cuenta, conexión a DEKS Cloud ni telemetría.
Cada presentación visible es un único archivo .deks.
El MCP descubre sólo archivos .deks directos de DEKS_PROJECTS_ROOT.
Las tools reciben IDs de presentación, nunca rutas arbitrarias.
El renderer recibe recursos resueltos; no navega el filesystem ni hace fetch.
La consulta opcional de actualizaciones usa GitHub y no bloquea el trabajo local.

Descarga la última release para tu plataforma

Crea una presentación o abre una existente

Conecta el MCP local

Agrega el servidor STDIO local

Combina JSON o usa la CLI

Instala y usa las dos skills

Editar localmente

Lo que permanece bajo tu control