cmux-resurrect
Persistencia de sesión para cmux — tus workspaces de terminal, resucitados.
El Problema
cmux es el multiplexor de terminal de más rápido crecimiento en el ecosistema Ghostty (12K+ estrellas). Gestiona la restauración de sesiones bien la mayor parte del tiempo, pero los cierres inesperados, actualizaciones forzadas y reinicios pueden borrar tu workspace.
La Solución
crex es una red de seguridad para esos momentos. Un comando guarda tu layout completo de cmux — workspaces, splits, CWDs, estado de pin, comandos de inicio. Un comando lo restaura todo. Inspirado en tmux-resurrect, crex va más allá con Workspace Blueprints: define tu configuración ideal de terminal en Markdown compatible con Obsidian, versionalo, compártelo con tu equipo.
¿Por qué crex?
tmux-resurrect demostró que la persistencia de sesiones es esencial. Todo multiplexor acaba teniendo uno — crex es esa herramienta para cmux.
| tmux-resurrect | crex | |
|---|---|---|
| 🎯 | Guarda/restaura sesiones tmux | Guarda/restaura sesiones cmux |
| 📝 | Configuración por plugin | Workspace Blueprint — archivos Markdown, compatible con Obsidian |
| 🧩 | Recreación manual de paneles | Plantillas reutilizables (dev, go, monitor) |
| 📥 | Restauración unidireccional | Bidireccional — import-from-md & export-to-md |
| 👁 | Ejecuta inmediatamente | Dry-run — previsualiza cada comando |
| ⏱ | Guardado manual | Auto-save + launchd — deduplicado, cero mantenimiento |
| 📋 | Editar archivos de config | CLI — add, remove, toggle desde terminal |
Características
Captura Completa del Layout
Guarda workspaces, splits, CWDs, estado de pin y pestaña activa en TOML. Un comando para hacer snapshot de toda tu sesión.
Workspace Blueprint
Declara tu configuración ideal de workspace en un archivo Markdown — compatible con Obsidian, versionable, compartible con tu equipo.
Plantillas Reutilizables
Define layouts de paneles una vez (dev, go, monitor) y referencialos desde cualquier workspace. Sin repetir configuraciones de split.
Previsualización Dry-Run
Ve cada comando de cmux que se ejecutará antes de que ocurra nada. Inspecciona, verifica, y restaura con confianza.
Auto-Guardado con launchd
Guardados periódicos vinculados a la disponibilidad del socket cmux. Deduplicación por hash de contenido. Cero mantenimiento.
Gestión de Workspaces por CLI
Añade, elimina, alterna y lista entradas de workspace directamente desde la terminal. Sin editar archivos.
Workspace Blueprint
Los Workspace Blueprints son documentos Markdown con dos secciones — Projects y Templates. Compatibles con Obsidian y cualquier editor Markdown. Los checkboxes controlan qué workspaces se crean. Las plantillas definen layouts de paneles reutilizables.
Inicio Rápido
Tres formas de instalar. Un minuto para empezar.
Instalar con Homebrew (recomendado)
Eso es todo — tanto crex como cmux-resurrect están listos para usar. No necesitas el toolchain de Go.
Instalar con go install
Instalar desde el código fuente
Prueba la demo
Comandos
| Comando | Alias | Descripción |
|---|---|---|
crex save [name] | Capturar el layout actual en TOML | |
crex restore [name] | Recrear workspaces, splits y comandos | |
crex list | ls | Listar layouts guardados con conteo de workspaces |
crex show <name> | Mostrar detalles del layout (--raw para TOML) | |
crex edit <name> | Abrir layout en $EDITOR | |
crex delete <name> | rm | Eliminar un layout guardado |
crex import-from-md | Crear workspaces desde Workspace Blueprint | |
crex export-to-md | Exportar estado live de cmux a Workspace Blueprint | |
crex watch [name] | Auto-guardar a intervalo (por defecto: 5m) | |
crex workspace add | ws add | Añadir entrada de workspace al Blueprint |
crex workspace remove | ws rm | Eliminar entrada de workspace del Blueprint |
crex workspace list | ws ls | Listar entradas de workspace en el Blueprint |
crex workspace toggle | ws toggle | Activar/desactivar una entrada de workspace |
crex version | Imprimir versión, commit, fecha de compilación |
Compatibilidad de Plataforma
crex es un complemento de cmux. Si tu Mac ejecuta cmux, ejecuta crex — sin dependencias extra, sin sorpresas de compatibilidad.
| Plataforma | Arquitectura | Status |
|---|---|---|
| macOS (Apple Silicon) | M1, M2, M3, M4 | ✅ Tested |
| macOS (Intel) | x86_64 | ✅ Tested |
| Linux | x86_64 | ✅ Builds |
| Linux | ARM64 | ✅ Builds |
Construido Con
cmux-resurrect es un binario Go único sin dependencias de ejecución.
- Go 1.26 — Compilación rápida, binario único
- Cobra — Framework CLI para comandos y flags
- go-toml/v2 — Análisis de archivos de configuración
- Lipgloss — Salida CLI con estilos y colores
- Huh — Componentes TUI interactivos (selector de layout)
- 42 tests — Suite de pruebas exhaustiva con cobertura de seguridad
Construyo las herramientas que me faltan, y las regalo.
Si alguna te ahorró tiempo, un café mantiene la siguiente en camino.
¿Listo para resucitar tus sesiones?
cmux-resurrect es gratuito, código abierto y listo para usar.