Documentación
Documentación
Cómo TermPuzzle preserva el contexto de tu proyecto — desde la primera instalación hasta restaurar un workspace entero en un clic.
Docs iniciales — se amplían con cada release. Última: v0.4.5.
Primeros pasos
TermPuzzle es una app de escritorio que recuerda el contexto de tu proyecto — sus terminales, servicios corriendo, editor y sesiones de IA — para que restaures un entorno de trabajo entero en un clic en vez de rearmarlo a mano.
El flujo es: instalar → abrir una carpeta de proyecto → ordenar tus terminales, editor y agentes una vez → TermPuzzle lo guarda como un workspace spec. De ahí en más, un clic lo restaura.
Instalación
Descarga la app de escritorio para tu plataforma. Corre por completo en tu máquina.
- macOS — firmado y notarizado (Apple Silicon + Intel), o
brew install --cask ElBartox/termpuzzle/termpuzzle. - Windows — instalador
.exe. La primera ejecución puede mostrar un aviso de Defender → Más información → Ejecutar de todas formas (builds firmados pronto). - Linux — AppImage y
.deb.
Workspace Restore
Restore reabre un proyecto exactamente como lo dejaste: las terminales relanzan sus comandos, el editor abre en posición y las ventanas de agente vuelven a su tarea. Los servicios se reanudan, no se reinician, y las rutas que no existen en una máquina nueva se re-mapean en vez de fallar.
Project Pulse
Project Pulse es la memoria operativa de tu proyecto — un score de salud 0–100 en vivo de cada servicio, en el chrome de la ventana. Cuando un servicio se cae, TermPuzzle lo detecta y puede recuperarlo antes de que lo notes, y registra el evento en la Timeline.
AI Mission Control
Corre Claude Code, Cursor, Codex, Aider o Continue como terminales de primera clase dentro de un workspace. Sobreviven los cambios de proyecto y se restauran al reabrir, así una sesión en curso no se pierde al cambiar de proyecto. TermPuzzle lee solo la actividad del PTY (trabajando / esperando) — nunca el contenido de tus prompts.
Mira Arquitectura para saber cómo está construido, o el FAQ para preguntas comunes.