English · 简体中文

Unfour

Un espacio de trabajo de escritorio local-first para desarrolladores de backend que combina depuración de API, terminales SSH y gestión de bases de datos — y los expone a tu agente de IA a través de un servidor MCP local.

Construido con Codex y GPT-5.6

Codex se utilizó para revisar la arquitectura de Rust y TypeScript, implementar y refactorizar comandos de Tauri, añadir pruebas e investigar errores de compilación y problemas del ciclo de vida de los procesos MCP.

GPT-5.6 ayudó a diseñar flujos de trabajo de resolución de problemas de backend asistidos por IA, analizar los límites de permisos de SSH y bases de datos, refinar el diseño de las herramientas MCP y planificar la arquitectura del proyecto y el proceso de publicación.

Codex también es más que una herramienta de desarrollo para Unfour: a través del servidor MCP de Unfour, puede utilizar las capacidades de API, SSH y base de datos para reproducir un problema de API, inspeccionar los registros del servicio, consultar la base de datos, correlacionar las pruebas e identificar la causa raíz.

Las operaciones sensibles permanecen bajo el control del desarrollador. El ámbito del espacio de trabajo, el manejo de credenciales, la confianza del host, las confirmaciones y los permisos de herramientas limitan lo que Codex puede acceder y ejecutar; conectar Codex no otorga acceso sin restricciones por defecto.

[!WARNING] El árbol de fuentes está preparando el release Community Stable v0.5.0. No está firmado y todavía requiere verificación de release; es posible que los instaladores activen SmartScreen u otras advertencias de seguridad del sistema operativo.

Related MCP server: devpulse-mcp

Descarga

Descarga las compilaciones publicadas desde GitHub Releases. La última versión estable publicada es v0.4.0; v0.5.0 aparecerá allí después de que se publique el release.

• Windows: instalador NSIS .exe.

• Los paquetes de macOS y Linux son experimentales y no verificados hasta que se registren pruebas de humo en dispositivos reales; no los trates todavía como compatibles o verificados.

• Verifique los instaladores descargados con el archivo SHA256SUMS.txt del release.

¿Qué es Unfour?

Unfour es un espacio de trabajo de escritorio local-first para el trabajo de backend y operaciones. Mantiene solicitudes de API, conexiones SSH, conexiones de bases de datos, actividad local y la disposición del espacio de trabajo en una única aplicación local-first, y expone esas capacidades a tu agente de IA a través de un servidor MCP local. Esta base sirve como soporte para flujos de trabajo de resolución de problemas asistidos por IA que operan a través de esas herramientas.

La aplicación está construida con Tauri 2, React, TypeScript y Rust. El frontend es el propietario de la interfaz de la mesa de trabajo, mientras que la ejecución con implicaciones de seguridad, como HTTP, SSH, controladores de base de datos, almacenamiento local y referencias a credenciales, reside detrás de las crates de capacidades de Rust y el bus de comandos.

Módulos

• API Client - Compone y envía solicitudes HTTP, organiza las solicitudes guardadas en colecciones y carpetas, resuelve variables de espacio de trabajo compartidas, inspecciona el cuerpo, las cabeceras, las cookies y los tiempos de la respuesta, ejecuta los scripts de pre-solicitud y de post-respuesta guardados, revisa las pruebas de los scripts y la salida de la consola, y mantiene un historial redactado.

• SSH Terminal - Administra conexiones SSH y sesiones de terminal (paneles divididos, búsqueda, menú contextual del portapapeles, historial de comandos redactado persistente y sugerencias de escritura, confianza de clave de host, registros redactados), explora y transfiere archivos remotos a través de SFTP, y automatiza tareas SSH de varios pasos (comando, subida, descarga) desde la barra lateral de Conexiones / Archivos / Tareas.

• Database - Administra conexiones de base de datos, explora esquemas, ejecuta SQL con comprobaciones de seguridad que requieren confirmación (incluido Run Current / Run All de múltiples sentencias), previsualiza y edita filas de tablas, y revisa la salida de las consultas.

• Workspace - Circunscribe solicitudes guardadas, entornos/variables compartidos, conexiones, actividad, pestañas y estado de diseño a un espacio de trabajo local, con cambio de entorno activo en la barra de título.

• MCP integration for Codex-powered API, SSH, and database debugging - Expone herramientas de diagnóstico locales y seguras a los clientes MCP (como Codex, Claude Code o Cursor) a través del mismo bus de comandos que usa la aplicación de escritorio, para que tu agente de IA pueda trabajar con el mismo contexto de API, SSH y SS base de datos.

Capturas de pantalla

Vista general de la aplicación: barra lateral con conmutador de módulos y el espacio de trabajo del API Client

API Client: constructor de solicitudes con parámetros, autenticación, cabeceras, cuerpo y respuesta

SSH Terminal: conexiones, sesiones, archivos remotos y tareas

Database: exploración de esquemas y salida de consultas SQL

Desarrollo local

Requisitos:

• Node.js y pnpm.

• Un toolchain de Rust estable.

• Los requisitos previos de Tauri 2 para tu sistema operativo.

Instalación y ejecución:

pnpm install
pnpm tauri dev

pnpm install también instala los hooks de Git a través de lefthook. Un commit aplica cargo fmt a los archivos Rust en preparación y corrige automáticamente los archivos TypeScript en preparación con ESLint. Para omitirlo una sola vez, usa LEFTHOOK=0 git commit.

Comandos comunes:

pnpm tauri build        # create local Stable-channel Tauri bundles
pnpm tauri build:test   # create isolated Test-channel Tauri bundles
pnpm run build          # build the desktop frontend only
pnpm run check          # frontend build + Rust check + large-file check
pnpm run lint           # ESLint
pnpm run test           # frontend unit tests (Vitest)
pnpm run test:e2e       # Playwright smoke tests
pnpm run check:rust     # cargo check --workspace
pnpm run check:rust:ssh # cargo check with the ssh-native feature
pnpm run test:rust      # cargo test --workspace
pnpm run test:release-env # release/channel contract unit tests

Ejecuta los comandos desde la raíz del repositorio a menos que un documento del paquete indique lo contrario. pnpm tauri dev usa por defecto el canal de release Test, mientras que pnpm tauri build local usa Stable por defecto. Usa pnpm tauri build:test para obtener un bundle y aislado del canal Test. Asigna UNFOUR_STORAGE_PROFILE=dev cuando los datos de desarrollo deban usar ~/.unfour-dev; esta anulación del almacenamiento es independiente de la identidad del release. Solo CI no debe crear artefactos formales de publicación de tipo Stable, con UNFOUR_RELEASE_CHANNEL=stable y un UNFOUR_BUILD_COMMIT exacto.

Estructura del proyecto

Consulta docs/architecture/project-structure.md para el mapa completo de paquetes y crates.

Estado de la publicación

El árbol de fuentes está preparando Community Stable v0.5.0; la última versión estable publicada es v0.4.0. La preparación del nuevo lanzamiento está documentada en:

• docs/testing/release-verification.md

• docs/testing/manual-test-cases.md

• docs/release/release-checklist.md

• docs/release/distribution.md

• docs/release/signing.md

Windows distribuye instalador NSIS .exe. Los instaladores no están firmados y pueden activar SmartScreen. macOS y Linux siguen en fase experimental/no verificada hasta que se completen las pruebas de humo en dispositivos reales. No afirme que un control de release pasa a menos que se haya ejecutado correctamente para la plataforma de destino o que presente la evidencia actual del repositorio.

Documentación

• AGENTS.md: reglas del repositorio para agentes de codificación.

• docs/agents/START_HERE.md: ruta de onboarding guiada para agentes de IA.

• docs/architecture/package-boundaries.md: propiedad de paquetes y uso de dependencias prohibidas.

• docs/architecture/project-structure.md: mapa del repositorio, paquetes, crates y cadenas de llamadas.

• docs/architecture/data-storage.md: datos del espacio de trabajo, SQLite, referencias a credenciales y reglas de actividad local.

• docs/architecture/diagnostics.md: logs estructurados locales, redacción de datos, retención, bundles de diagnóstico y descripción del registro de desarrollo.

• docs/architecture/security-model.md: modelo de seguridad, redacción, política de claves de host y reglas de acciones peligrosas.

• docs/mcp/overview.md y docs/mcp/tools.md: comportamiento del MCP local del servidor MCP.

• docs/testing/release-verification.md: matriz de verificación de releases.

• docs/release/release-checklist.md: prácticas para releases públicos.

• docs/user/USER_GUIDE.md: guía de flujos de trabajo para el usuario.

Contribución

Por favor, lee CONTRIBUTING.md, CODE_OF_CONDUCT.md y las reglas de límites de paquetes en AGENTS.md antes de abrir una pull request.

Los problemas de seguridad deben informarse a través de SECURITY.md en vez de un issue público.

Licencia

Bajo la licencia Apache License 2.0.