⏱️ Lectura: 8 min
ExcalidrawZ para Mac llegó a la versión 2.5.1 el 24 de octubre de 2026, con sincronización completa por iCloud y un asistente de inteligencia artificial integrado en el lienzo, y suma también iPadOS e iOS como plataformas (nota de la versión). En Hacker News, alguien miró el historial de commits del proyecto y encontró algo que no cuadraba con una app hecha a mano: el ritmo de desarrollo se disparó hace poco, mucho más de lo que explicaría un equipo trabajando solo (comentario de j2kun).
📑 En este artículo
El repositorio suma unas 1.700 estrellas y cerca de 100 forks en GitHub al 2026-11-12, escrito en Swift bajo licencia MIT, con el último push el 2026-10-24 (chocoford/ExcalidrawZ). No reescribe el lienzo de Excalidraw. Lo incorpora tal cual y lo rodea de funciones nativas de Apple, pensadas para quien ya dibuja diagramas en Excalidraw y quiere archivos reales en el Finder en lugar de descargas sueltas del navegador.
Qué agrega ExcalidrawZ sobre el Excalidraw que ya conocés
El propio README lo resume así: «Excalidraw is an excellent drawing tool», y ExcalidrawZ se limita a envolverlo con gestión de archivos, historial y sincronización (chocoford/ExcalidrawZ). En la práctica eso significa organizar dibujos en grupos y carpetas locales, abrir y editar directamente .excalidraw, .excalidraw.png y .excalidraw.svg, sincronizar esos archivos entre Mac, iPad y iPhone vía iCloud, y guardar puntos de control del historial para restaurar una versión anterior de un diagrama.
- Asistente de IA en el lienzo: puede leer, crear y revisar dibujos, trabajar con imágenes adjuntas y mostrar una vista previa antes de aplicar cualquier cambio, con control por archivo de qué queda visible para la IA.
- Servidor MCP: ExcalidrawZ puede exponerse como servidor MCP para clientes de IA compatibles, con un modo básico equivalente al paquete
excalidraw-mcpy un modo optimizado con edición del archivo actual, navegación, historial y exportación. - Herramientas de matemática: fórmulas en LaTeX, gráficos de funciones y conversión de diagramas Mermaid a Excalidraw editable.
- Colaboración en vivo usando el modo de colaboración propio de Excalidraw, para dibujar con otras personas en el mismo lienzo.
- Archivos bloqueados con autenticación local, checkpoints cifrados y una clave de recuperación como respaldo; los PNG y SVG exportados siguen siendo archivos
.excalidraweditables, además de exportar a PDF.
Para instalarla fuera de la App Store, el README solo pide bajar el .dmg más reciente desde Releases y arrastrar la app a Applications (chocoford/ExcalidrawZ).
Para quién cambia el flujo de trabajo
Le sirve a quien ya usa Excalidraw para documentar arquitectura, diagramas de secuencia o notas visuales y hoy junta esos archivos sueltos descargados del navegador. Con ExcalidrawZ esos dibujos pasan a ser documentos reales del sistema, con historial y sincronización entre dispositivos Apple, y el Apple Pencil en iPad suma deshacer y rehacer con los mismos gestos que ya usás en otras apps.
La integración MCP interesa a quien corre agentes de IA localmente (Claude Code, Cursor u otro cliente MCP) y quiere que el agente lea o edite un diagrama sin copiar y pegar JSON a mano. Pero esa misma puerta, un servidor HTTP local que puede escribir en tus archivos, es lo primero que hay que auditar antes de activarla en una máquina con diagramas sensibles.
Qué pasó cuando probamos compilarlo en el laboratorio
Corrimos ExcalidrawZ en nuestro sandbox aislado el 2026-11-12. El clon del repositorio terminó bien:
$ git -c protocol.allow=never -c protocol.https.allow=always -c core.hooksPath=/dev/null clone --depth 1 --single-branch --no-tags -- https://github.com/chocoford/ExcalidrawZ /tmp/lab-runs/lab-8njj7gl3/w/repo
Cloning into '/tmp/lab-runs/lab-8njj7gl3/w/repo'...El repositorio pesa 104,4 MB y el clon tardó 3,912 segundos con un pico de memoria de 53,3 MB. Ahí se detuvo: el laboratorio reportó «no supported stack detected» y no llegó a compilar ni correr nada. Tiene sentido. ExcalidrawZ es un proyecto Xcode puro, atado a SwiftUI y al toolchain de Apple, y nuestro sandbox corre Linux (os=Linux-6.18.15, python=3.12.16, node=v18.20.4). No hay forma de construir una app para macOS/iOS fuera de una máquina con Xcode.
Esto importa más allá del dato técnico: si tu equipo quiere validar ExcalidrawZ en un pipeline de CI antes de distribuirlo internamente, necesitás un runner macOS con Xcode instalado, no un contenedor Linux genérico como el que usa la mayoría de las integraciones continuas por defecto. El propio repositorio documenta la configuración de firma (Config/Overrides.xcconfig con DEVELOPMENT_TEAM, ICLOUD_CONTAINER y APP_GROUP_IDENTIFIER), pero asume que ya tenés ese entorno listo (chocoford/ExcalidrawZ).
ExcalidrawZ para Mac frente a Excalidraw, tldraw y Drawnix
| Proyecto | Estrellas (2026-11-12) | Qué es | Diferencia clave |
|---|---|---|---|
| excalidraw/excalidraw | unas 135.600 | El lienzo web original, también como paquete npm | Corre en cualquier navegador sin instalar nada; es lo que ExcalidrawZ envuelve por dentro |
| tldraw/tldraw | unas 51.400 | SDK de React para lienzo infinito | Pensado para integrarlo en tu propio producto, no para usarlo como app de escritorio |
| plait-board/drawnix | unas 15.000 | Whiteboard open source todo en uno (mapas mentales, diagramas de flujo, dibujo libre) | Es SaaS web, no una app nativa de Apple |
| chocoford/ExcalidrawZ | unas 1.700 | App nativa SwiftUI para macOS, iPadOS e iOS | El único de los cuatro con archivos reales, iCloud y Apple Pencil |
Hay una cuarta opción que ni siquiera requiere instalar una app: Excalidraw tiene su propio paquete de npm, y un comentario en Hacker News recuerda que montar un proyecto local con una página HTML vacía y Excalidraw adentro es sencillo, sirve detrás de firewalls corporativos y funciona completamente offline (comentario de BariumBlue). Si lo único que te interesa es el lienzo sin la capa nativa de Apple, esa ruta evita instalar un binario de terceros.
Qué significa esto para tu equipo
Si mantenés documentación técnica de arquitectura en Excalidraw dentro de un equipo backend que usa Mac, antes de instalar ExcalidrawZ la decisión concreta es no activar el modo MCP optimizado (el que da acceso de edición al archivo actual y a la navegación) hasta revisar quién corre ese servidor HTTP local y qué agente de IA se conecta a él. Es la parte de la app que más se parece a abrir una puerta nueva a tus archivos.
Segundo, antes de guardar diagramas de arquitectura con flechas (el tipo de diagrama más común en documentación técnica), leé el issue #119, todavía abierto: reporta un error de «the data couldn’t be read» justo en líneas sin punta de flecha. Probalo primero con un diagrama de prueba, no con el que ya tiene seis meses de historial.
Tercero, si tu política de seguridad exige poder auditar el código antes de confiarle el Llavero (Keychain) para la función de archivos bloqueados, mirá primero el historial de commits y el gráfico de frecuencia de código que señaló el comentario de j2kun en Hacker News antes de instalar el .dmg firmado (comentario de j2kun). No es una acusación confirmada de nada, es una observación de la comunidad que vale la pena mirar con tus propios ojos antes de decidir.
Cuándo no conviene instalarlo
ExcalidrawZ solo corre en macOS, iPadOS e iOS: no hay versión para Windows ni Linux, así que un equipo mixto necesita mantener el acceso web original para quienes no usan Apple. La versión fuera de la App Store llega como .dmg sin pasar por la revisión de Apple, lo que exige confiar en el firmante del binario y no en una tienda que lo auditó.
Compilarlo desde el código fuente no es trivial: necesita un equipo de desarrollador de Apple propio, un App Group y un contenedor de iCloud configurados a mano en Config/Overrides.xcconfig (chocoford/ExcalidrawZ). Y como vimos en el laboratorio, ninguna herramienta de CI genérica para Linux puede validarlo: cualquier pipeline de verificación automática necesita un runner macOS dedicado.
Por último, el issue #119 sigue abierto y el propio ritmo reciente de commits generó dudas en la comunidad de Hacker News sobre cuánto del código se escribe a mano versus con asistencia de IA (comentario de j2kun). Ninguna de las dos cosas es un error confirmado, pero ambas son motivo para no apurar la adopción en un equipo grande sin probarlo primero con diagramas que no importen.
Referencias
- chocoford/ExcalidrawZ: repositorio, README, estrellas y licencia.
- Release v2.5.1: nota de la versión del 2026-10-24.
- Issue #119: error abierto con líneas sin punta de flecha.
- Hilo de Hacker News: discusión de la comunidad sobre ExcalidrawZ.
- excalidraw/excalidraw: el lienzo original que usa ExcalidrawZ.
- tldraw/tldraw: alternativa como SDK de React.
- plait-board/drawnix: alternativa como whiteboard SaaS open source.
Seguimos el tema en @programacion.
Imagen destacada: Foto de Tran Mau Tri Tam ✪ en Unsplash
Así preparamos cada artículo (fuentes, pruebas y criterio editorial): Cómo trabajamos.
¿Te sirvió? ¿Te dio otro error? Contalo abajo: las preguntas se responden y le sirven al siguiente que llegue.
Dejar un comentario
0 Comentarios