Overture

Veja o plano antes do código. Aprove-o. Depois veja-o executar.

Problema • Solução • Instalação • Funcionalidades • Marketplace • Configuração • Discussões

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

🔥 O Problema

Todo agente de codificação com IA hoje — Cursor, Claude Code, Cline, Copilot — funciona da mesma forma:

✨ A Solução

Overture intercepta a fase de planejamento do seu agente de IA e a renderiza como um fluxograma visual interativo — antes que qualquer código seja escrito.

O agente não escreve uma única linha de código até que você aprove o plano.

Planos Visuais Fluxograma interativo com navegação por panorâmica, zoom e clique

Anexar Contexto Arquivos, chaves de API, instruções por etapa

Escolher Abordagens Comparar prós/contras de diferentes caminhos

Execução em Tempo Real Veja os nós acenderem com o progresso

Marketplace MCP Navegue e anexe ferramentas por nó

🚀 Instalação

Overture é um servidor MCP que funciona com qualquer agente de codificação de IA compatível com MCP. Um comando para instalar.

Claude Code

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

Cursor

Adicione ao ~/.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
    }
  }
}

Instalação Global (Opcional)

npm install -g overture-mcp

Verifique se Funciona

Dê qualquer tarefa ao seu agente. Overture abre automaticamente em http://localhost:3031 com seu plano pronto para aprovação.

🎯 Como Funciona

O Fluxo:

🛠 Funcionalidades

Tela de Plano Interativa

Painel de Detalhes do Nó

Clique em qualquer nó para revelar seus detalhes completos:

Campos Dinâmicos (Entradas do Usuário)

Os nós podem solicitar informações suas antes da execução:

Cada campo inclui:

• Indicador de obrigatório/opcional
• Valores padrão
• Texto de ajuda e descrições
• Instruções de configuração ("Como obter uma chave de API")

Anexos de Arquivo

Anexe arquivos de contexto a nós específicos:

• Detecção automática de tipo — Imagem, código, documento ou outro
• Ícones visuais por tipo de arquivo
• Descrições — adicione notas sobre por que este arquivo é importante
• Excluir — remova anexos indesejados

Meta Instruções

Adicione instruções personalizadas de LLM a qualquer nó:

"Preste atenção especial ao tratamento de erros aqui" "Use o padrão de autenticação existente de src/auth.ts" "Certifique-se de adicionar testes para casos limite"

As instruções são enviadas ao agente logo antes da execução desse nó.

Detecção e Seleção de Ramificação

Quando o agente propõe múltiplas abordagens:

Lista de Verificação de Requisitos

Antes de poder aprovar, Overture mostra o que é necessário:

• Campos obrigatórios vazios — contados por nó
• Seleções de ramificação — quais decisões estão pendentes
• Indicador de progresso — rastreamento visual de conclusão
• Itens expansíveis — clique para ver detalhes
• Codificação por cores — Verde (concluído) / Laranja (pendente)

O botão Aprovar permanece desabilitado até que todos os requisitos sejam atendidos.

Controles de Execução

O botão de aprovação é inteligente:

• 🟢 "Aprovar e Executar" — plano pronto, requisitos atendidos
• 🟠 "Completar Requisitos" — condições não atendidas
• 🔵 "Executando..." — em execução com spinner
• 🟢 "Concluído" — tudo pronto
• 🔴 "Falhou" — ocorreu um erro

Saída Estruturada

Após a execução de cada nó, veja uma saída rica e estruturada:

Cada categoria é expansível — aprofunde-se sem sobrecarga visual.

Modal de Saída

Clique em qualquer nó concluído para ver a saída completa:

• Rolável para saídas longas
• Trechos de código com destaque de sintaxe
• Fechar com Escape ou clique fora

🏪 Marketplace MCP

Navegue e anexe servidores MCP diretamente da interface do Overture.

Quando você anexa um servidor MCP a um nó, o agente ganha acesso a essas ferramentas apenas para essa etapa.

📂 Suporte a Múltiplos Projetos

Trabalhe em vários projetos simultaneamente:

Projeto único? A barra de abas se oculta automaticamente para uma interface mais limpa.

📜 Histórico e Persistência do Plano

Nunca perca seu trabalho:

Informações de Retomada

Ao retomar, você obtém o contexto completo:

• Nó atual — onde a execução parou
• Nós concluídos — com suas saídas
• Nós pendentes — o que falta fazer
• Nós com falha — com mensagens de erro
• Todas as configurações — valores de campos, ramificações, anexos
• Marcas de tempo — quando foi criado, quando foi pausado

✏️ Modificação Dinâmica de Plano

Modifique planos mesmo durante a execução:

Visualização de Diferenças do Plano

Quando um plano muda, veja exatamente o que está diferente:

• Nós adicionados — destacados em verde
• Nós removidos — destacados em vermelho
• Nós modificados — amarelo com comparação antes/depois
• Mudanças de arestas — conexões adicionadas/removidas

🔌 Ferramentas MCP (Para Desenvolvedores de Agentes)

Overture expõe 11 ferramentas MCP para os agentes interagirem:

🔄 Comunicação WebSocket em Tempo Real

19 tipos de mensagem servidor-para-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 mensagem cliente-para-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 Retransmissor

Quando a porta WebSocket já está em uso, Overture opera automaticamente como um cliente retransmissor, encaminhando mensagens através do servidor existente. Múltiplas instâncias de agente podem compartilhar uma única interface.

⚙️ Configuração

Definindo Variáveis de Ambiente

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"
      }
    }
  }
}

⌨️ Atalhos de Teclado

🤝 Agentes Suportados

Cada agente possui prompts personalizados para geração ideal de planos.

💪 Por que Overture?

🧑‍💻 Desenvolvimento

# 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

🤝 Contribuindo

Overture é código aberto e aceitamos contribuições!

• 🐛 Reporte bugs em GitHub Issues
• 💡 Sugira funcionalidades em GitHub Discussions
• 📖 Melhore a documentação — PRs são bem-vindos
• 🔧 Contribua com código — veja CONTRIBUTING.md

Todas as contribuições são apreciadas, não importa quão pequenas.

📄 Licença

Licença MIT - veja LICENSE para detalhes.

Construído por Sixth

Para a melhor experiência, experimente Sixth para VS Code
Overture é integrado com configuração zero necessária.

_{Pare de voar às cegas. Veja o plano. Aprove-o. Execute com confiança.}

Histórico de Estrelas