excalidraw-pi-workspace
Espacio de trabajo bidireccional Excalidraw × Pi Agent que convierte bocetos estructurados en requisitos ejecutables mediante MCP CLI + Review Gate, con persistencia server-side y sincronización WebSocket.
Ficha actualizada 24 sept 2026, 5:34 · upstream 24 sept 2026, 5:06 · release sin release detectada
Qué es excalidraw-pi-workspace
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio implementa un espacio de trabajo colaborativo que combina el canvas infinito oficial de Excalidraw (versión 0.18.0-c0ad61c) con un agente de codificación Pi. La arquitectura consume la base oficial sin fork, reutilizando el motor de renderizado, componentes React y librerías de sincronización WebSocket.
El servidor MCP (mcp-excalidraw-server v2.0.0) gestiona operaciones CRUD sobre elementos del canvas mediante REST API y WebSocket, con persistencia server-side que mantiene 20 copias rotativas antes de sobrescribir archivos locales (.excalidraw gitignored). La interfaz principal corre en puerto 5001 como servidor MCP, mientras el puerto 5002 ofrece una UI delgada sin autosave para casos específicos.
El flujo de trabajo permite dibujar nodos y flechas con semántica de Arrow Binding, enviarlos al agente Pi mediante MCP CLI, pasar por Review Gate (validación pre-ejecución con diffs de nodo/flecha), ejecutar el código generado y revertir cambios si se rechaza. Soporta persistencia en WebDAV (Jianguoyun/Nextcloud/Synology) y subida directa a Dropbox/Google Drive/OneDrive vía OAuth 2.0+PKCE.
- Diseño de arquitectura visual → código ejecutable en un solo flujo mediante MCP CLI
- Documentación técnica colaborativa con retroalimentación automática del agente AI y validación humana
- Prototipado rápido de requisitos de software con Review Gate para aprobación pre-ejecución
- Gestión de tareas técnicas mediante .pi/task_set.json extraído desde frames del canvas
- Desarrollo frontend con visualización interactiva de componentes React/Node.js en canvas infinito
- Base oficial Excalidraw sin fork, garantizando compatibilidad y actualizaciones automáticas
- Persistencia server-side con rotación automática de backups (20 versiones retenidas)
- Review Gate implementado para validación pre-ejecución con diffs detallados de nodo/flecha
- Soporte PWA multiplataforma con sincronización WebSocket en LAN y touch/stylus friendly
- Integración MCP CLI estandarizada para operaciones CRUD de elementos del canvas
- Mecanismo de actualización upstream con detección de drift y límites GitHub API explícitos
- Requiere Windows 10/11 según documentación (no soporta Linux/Mac explícitamente)
- Dependencia de agente Pi específico (pi-coding-agent v0.84.4) no es genérico
- Autenticación opcional mediante Basic Auth proxy, sin OAuth nativo para canvas
- Límite GitHub API 60 req/hour afecta frecuencia de checks upstream (2 req por check)
- Actualización manual requerida: ajustar __CANVAS_BASELINE__ en vite.config.ts antes de rebuild
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Necesita Node.js ≥20, Git y Windows. Ejecutar deploy.bat o manualmente: npm install, start-canvas.bat (puerto 5001), node tools/agent-notify.mjs (puerto 5010). Para redes no confiables usar start-auth.bat (genera password en .auth.env gitignored). Actualizar vía npm run check:upstream y ajustar __CANVAS_BASELINE__ en canvas-web/vite.config.ts antes de npm run build:canvas. El puerto 5001 es el anchor del canvas; 5010 para notificaciones Pi.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.