¿Qué es WWorkbench?

WWorkbench es una herramienta de escritorio desarrollada con Go 1.25+ y Wails v2 que centraliza flujos de trabajo de operaciones multi-hospedaje. Permite gestionar terminales locales y SSH, bases de datos (PostgreSQL, MySQL, Redis), contenedores Docker, archivos remotos vía SFTP, registros en vivo y notas operativas en un solo espacio de trabajo restaurable.

El asistente lateral contextual puede detectar el host y shell activos mediante enlaces @ o integración MCP con Cursor, proporcionando sugerencias sin ejecutar acciones automáticamente. El almacenamiento local usa SQLite para preferencias, credenciales y snapshots de workspace, garantizando privacidad sin cuentas obligatorias en la nube.

Soporta gestión de entornos (Node, Go, PHP, Java), edición con Monaco Editor, temas oscuros/claros e internacionalización en inglés/chino. La arquitectura separa backend Go del frontend React 18 con Vite y Zustand, permitiendo desarrollo modular y compilación nativa para macOS, Windows y Linux.

Casos de Uso

• Consolidar herramientas de operaciones: Termius + DBeaver + Docker Desktop en una sola aplicación para reducir la fricción entre workflows.
• Integrar contexto de terminal en asistentes AI locales: MCP HTTP permite lectura de ~100 líneas del shell activo con Cursor.
• Gestionar bases de datos distribuidas: MySQL/PostgreSQL/Redis con consolas SQL, exploradores de tablas y DDL integrado sin cambiar de aplicación.
• Automatizar despliegues full-stack auto-alojados: Vincular activos locales y remotos en un workspace restaurable con snapshots.

Funciones Principales

Adicional: Tema oscuro/claro con preferencias en SQLite local, UI language English/简体中文 (icono globo top bar), multi-product workspace restore, asset radar refreshes UI after saves, capability switches: disabled AI tools refused.

Arquitectura Técnica

Instalación y Despliegue

Descarga Binaria (Recomendado)

Descargar binarios oficiales desde Releases para macOS/Windows/Linux:

Direct links también en el sitio: wworkbench.wcore.top

Compilación desde Fuente

Prerrequisitos:

• Go ≥ 1.25
• Node.js ≥ 18 (LTS recomendado)
• Wails CLI v2.12+, ver Wails docs
• Platform toolchain: macOS: Xcode CLT; Windows: WebView2 + build tools
• Opcional: Docker Desktop / docker.sock; Homebrew / nvm / goenv (Env module)

Comandos:

git clone https://github.com/wcoreing/WWorkbench.git
cd WWorkbench
cd frontend && npm install && cd ..
go mod download
wails dev

Debug browser: http://localhost:34115

wails build # output under build/bin/
wails generate module # after changing Go-exported APIs

Datos y Configuración

No commit o adjuntar ~/.wworkbench a issues.

Cursor via MCP

1. Iniciar WWorkbench; en assistant settings, mantener MCP HTTP on (default 127.0.0.1:51021)
2. Copiar el Workbench URL (debe ser /mcp/workbench, no /mcp)
3. Añadir a Cursor mcp.json:

{
  "mcpServers": {
    "wworkbench": {
      "url": "http://127.0.0.1:51021/mcp/workbench"
    }
  }
}

Writes may return ww_confirm text — confirm in the WWorkbench sidebar. External clients do not click confirm for you.

Alternativas Reales

• Termius: SSH client con sync cloud (premium). Alternativa self-hosted: Termix.
• DBeaver: DB universal open-source. Alternativas: CloudBeaver, Adminer, HeidiSQL, Beekeeper Studio.
• Docker Desktop: Gestión containers local. WWorkbench integra Docker Engine API directamente.

Limitaciones

• Dependencia de Go 1.25+ que puede requerir compilación desde fuente o descarga de binarios específicos para cada plataforma.
• Configuración manual del endpoint MCP HTTP (127.0.0.1:51021/mcp/workbench) en clientes externos como Cursor sin autenticación integrada.
• Ausencia de soporte nativo para Dockerfile o Compose según análisis técnico, limitando la gestión avanzada de contenedores.
• Almacenamiento de datos sensibles (SSH known_hosts, SQLite) en ~/.wworkbench que debe protegerse manualmente en entornos compartidos.

Seguridad y Privacidad

• Conexiones, secrets y preferencias permanecen en local ~/.wworkbench (SQLite). No cuenta cloud obligatoria.
• Agent / MCP son opcionales; capacidades deshabilitadas se refusan.
• License: MIT License.
• Docker Engine API usa socket local por defecto (sin exposición externa).

FAQ

¿Necesito Docker Desktop?

No. WWorkbench integra Docker Engine API directamente. Funciona con Docker instalado en el host o vía SSH a máquinas remotas.

¿Soporta Docker Compose?

No nativo. El módulo Containers gestiona imágenes/contenedores individuales vía Docker Engine API. Logs de Compose se pueden visualizar pero no orquestar desde WWorkbench.

¿Cómo funciona el asistente MCP?

El asistente lateral puede detectar host/shell activos mediante enlaces @. Con Cursor, MCP HTTP lee ~100 líneas del shell activo. Writes requieren confirmación manual en sidebar.

¿Es seguro usar en producción?

Sí, con precauciones: proteger ~/.wworkbench, no exponer endpoint MCP (default 127.0.0.1), y deshabilitar Agent/MCP si no necesario.