Overture

Ve el plan antes que el código. Apruébalo. Luego mira cómo se ejecuta.

Problema • Solución • Instalar • Características • Marketplace • Configuración • Discusiones

https://github.com/user-attachments/assets/eeb9c4cb-c80d-42da-bf63-c0c4ecb1e5d6

🔥 El Problema

Hoy en día, todos los agentes de codificación con IA — Cursor, Claude Code, Cline, Copilot — funcionan de la misma manera:

✨ La Solución

Overture intercepta la fase de planificación de tu agente de IA y la representa como un diagrama de flujo visual interactivo — antes de que se escriba cualquier código.

El agente no escribe una sola línea de código hasta que apruebes el plan.

Planes Visuales Diagrama de flujo interactivo con navegación panorámica, zoom y clic

Adjuntar Contexto Archivos, claves API, instrucciones por paso

Elegir Enfoques Comparar pros/contras de diferentes caminos

Ejecución en Tiempo Real Observa cómo los nodos se iluminan con el progreso

Marketplace MCP Explora y adjunta herramientas por nodo

🚀 Instalación

Overture es un servidor MCP que funciona con cualquier agente de codificación de IA compatible con MCP. Un comando para instalar.

Claude Code

claude mcp add overture-mcp -- npx overture-mcp

Cursor

Agregar a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "overture": {
      "command": "npx",
      "args": ["overture-mcp"]
    }
  }
}

{
  "mcpServers": {
    "overture": {
      "command": "npx",
      "args": ["overture-mcp"]
    }
  }
}

{
  "servers": {
    "overture": {
      "command": "npx",
      "args": ["overture-mcp"]
    }
  }
}

{
  "mcpServers": {
    "overture": {
      "command": "npx",
      "args": ["overture-mcp"],
      "disabled": false
    }
  }
}

Instalación Global (Opcional)

npm install -g overture-mcp

Verifica que funcione

Dale a tu agente cualquier tarea. Overture se abre automáticamente en http://localhost:3031 con tu plan listo para aprobación.

🎯 Cómo Funciona

El Flujo:

🛠 Características

Lienzo de Plan Interactivo

Panel de Detalles del Nodo

Haz clic en cualquier nodo para revelar sus detalles completos:

Campos Dinámicos (Entradas del Usuario)

Los nodos pueden solicitar tu entrada antes de la ejecución:

Cada campo incluye:

• Indicador de requerido/opcional
• Valores predeterminados
• Texto de ayuda y descripciones
• Instrucciones de configuración ("Cómo obtener una clave API")

Archivos Adjuntos

Adjunta archivos de contexto a nodos específicos:

• Detección automática de tipo — Imagen, código, documento u otro
• Iconos visuales por tipo de archivo
• Descripciones — agrega notas sobre por qué este archivo es importante
• Eliminar — quita archivos adjuntos no deseados

Meta Instrucciones

Agrega instrucciones personalizadas para el LLM a cualquier nodo:

"Presta especial atención al manejo de errores aquí" "Usa el patrón de autenticación existente de src/auth.ts" "Asegúrate de agregar pruebas para casos límite"

Las instrucciones se envían al agente justo antes de que ese nodo se ejecute.

Detección y Selección de Ramas

Cuando el agente propone múltiples enfoques:

Lista de Verificación de Requisitos

Antes de que puedas aprobar, Overture muestra lo que se necesita:

• Campos requeridos vacíos — contados por nodo
• Selecciones de rama — qué decisiones están pendientes
• Indicador de progreso — seguimiento visual de finalización
• Elementos expandibles — haz clic para ver detalles
• Codificación de colores — Verde (hecho) / Naranja (pendiente)

El botón Aprobar permanece deshabilitado hasta que se cumplan todos los requisitos.

Controles de Ejecución

El botón de aprobación es inteligente:

• 🟢 "Aprobar y Ejecutar" — plan listo, requisitos cumplidos
• 🟠 "Completar Requisitos" — condiciones no cumplidas
• 🔵 "Ejecutando..." — corriendo con spinner
• 🟢 "Completado" — todo listo
• 🔴 "Fallido" — ocurrió un error

Salida Estructurada

Después de que cada nodo se ejecuta, ve una salida estructurada enriquecida:

Cada categoría es expandible — profundiza sin sobrecarga visual.

Modal de Salida

Haz clic en cualquier nodo completado para ver la salida completa:

• Desplazable para salidas largas
• Fragmentos de código con resaltado de sintaxis
• Cerrar con Escape o haz clic fuera

🏪 Marketplace MCP

Explora y adjunta servidores MCP directamente desde la interfaz de Overture.

Cuando adjuntas un servidor MCP a un nodo, el agente obtiene acceso a esas herramientas solo para ese paso.

📂 Soporte Multi-Proyecto

Trabaja en múltiples proyectos simultáneamente:

¿Un solo proyecto? La barra de pestañas se oculta automáticamente para una interfaz más limpia.

📜 Historial de Planes y Persistencia

Nunca pierdas tu trabajo:

Información de Reanudación

Al reanudar, obtienes el contexto completo:

• Nodo actual — donde se detuvo la ejecución
• Nodos completados — con sus salidas
• Nodos pendientes — lo que queda por hacer
• Nodos fallidos — con mensajes de error
• Todas las configuraciones — valores de campo, ramas, adjuntos
• Marcas de tiempo — cuándo se creó, cuándo se pausó

✏️ Modificación Dinámica de Planes

Modifica planes incluso durante la ejecución:

Vista de Diferencias del Plan

Cuando un plan cambia, ve exactamente qué es diferente:

• Nodos agregados — resaltados en verde
• Nodos eliminados — resaltados en rojo
• Nodos modificados — amarillo con comparación antes/después
• Cambios de conexiones — conexiones agregadas/eliminadas

🔌 Herramientas MCP (Para Desarrolladores de Agentes)

Overture expone 11 herramientas MCP para que los agentes interactúen:

🔄 Comunicación WebSocket en Tiempo Real

19 tipos de mensajes de servidor a cliente:

connected • plan_started • node_added • edge_added • plan_ready • plan_approved • node_status_updated • plan_completed • plan_failed • plan_paused • plan_resumed • nodes_inserted • node_removed • project_registered • projects_list • history_entries • plan_loaded • resume_plan_info • plan_updated

16 tipos de mensajes de cliente a servidor:

approve_plan • cancel_plan • rerun_request • pause_execution • resume_execution • insert_nodes • remove_node • register_project • subscribe_project • unsubscribe_project • get_history • load_plan • get_resume_info • save_plan • request_plan_update • create_new_plan

Modo Retransmisión

Cuando el puerto WebSocket ya está en uso, Overture opera automáticamente como un cliente de retransmisión, reenviando mensajes a través del servidor existente. Múltiples instancias de agente pueden compartir una sola interfaz de usuario.

⚙️ Configuración

Configuración de Variables de Entorno

claude mcp add overture-mcp -e OVERTURE_HTTP_PORT=4000 -e OVERTURE_AUTO_OPEN=false -- npx overture-mcp

{
  "mcpServers": {
    "overture": {
      "command": "npx",
      "args": ["overture-mcp"],
      "env": {
        "OVERTURE_HTTP_PORT": "4000",
        "OVERTURE_WS_PORT": "4001",
        "OVERTURE_AUTO_OPEN": "false"
      }
    }
  }
}

{
  "servers": {
    "overture": {
      "command": "npx",
      "args": ["overture-mcp"],
      "env": {
        "OVERTURE_HTTP_PORT": "4000",
        "OVERTURE_WS_PORT": "4001",
        "OVERTURE_AUTO_OPEN": "false"
      }
    }
  }
}

⌨️ Atajos de Teclado

🤝 Agentes Soportados

Cada agente tiene indicaciones personalizadas para una generación de planes óptima.

💪 ¿Por qué Overture?

🧑‍💻 Desarrollo

# Clone the repo
git clone https://github.com/SixHq/Overture.git
cd Overture

# Install dependencies
npm install

# Build all packages
npm run build

# Start MCP server (in one terminal)
cd packages/mcp-server && npm start

# Start UI dev server (in another terminal)
cd packages/ui && npm run dev

Stack Tecnológico

🤝 Contribuir

¡Overture es de código abierto y damos la bienvenida a las contribuciones!

• 🐛 Reporta errores en GitHub Issues
• 💡 Sugiere funcionalidades en GitHub Discussions
• 📖 Mejora la documentación — PRs bienvenidos
• 🔧 Contribuye con código — consulta CONTRIBUTING.md

Todas las contribuciones son apreciadas, sin importar cuán pequeñas sean.

📄 Licencia

Licencia MIT - consulta LICENSE para más detalles.

Construido por Sixth

Para la mejor experiencia, prueba Sixth para VS Code
Overture está integrado sin necesidad de configuración.

_{Deja de volar a ciegas. Mira el plan. Apruébalo. Ejecuta con confianza.}

Historial de Estrellas