Overture

официальный

Визуальное утверждение планов для ИИ-агентов кодирования. Просматривайте план вашего агента в виде интерактивного графа, добавляйте контекст, выбирайте подходы, а затем утверждайте до начала написания кода.

Документация

Overture

Сначала посмотрите план, прежде чем писать код. Утвердите его. Затем наблюдайте за выполнением.

npm version CI status npm downloads Discussions MIT License

ПроблемаРешениеУстановкаВозможностиМаркетплейсКонфигурацияОбсуждения


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


🔥 Проблема

Каждый современный AI-агент для кодинга — Cursor, Claude Code, Cline, Copilot — работает одинаково:

Что происходит сейчас

  1. Вы вводите запрос
  2. Агент сразу начинает писать код
  3. У вас нулевая видимость того, что он делает
  4. Вы понимаете, что он неправильно понял ваш запрос
  5. Сотни строк кода приходится отбрасывать
  6. Вы потратили токены, время и нервы

Текстовые планы не помогают

Некоторые агенты показывают планы в виде текста в чате. Но текст не может показать:

  • Зависимости — какие задачи от каких зависят?
  • Точки ветвления — какие существуют альтернативные подходы?
  • Требования к контексту — какие файлы, API или секреты нужны?
  • Сложность — какие шаги рискованны?
  • Прогресс — что сделано, что дальше?

The Problem


✨ Решение

Overture перехватывает фазу планирования вашего AI-агента и отображает ее в виде интерактивной визуальной блок-схемы — до того, как будет написан какой-либо код.

Overture Solution

Агент не пишет ни строчки кода, пока вы не утвердите план.



Визуальные планы
Интерактивная блок-схема с панорамированием, масштабированием и навигацией по клику

Прикрепить контекст
Файлы, ключи API, инструкции для каждого шага

Выбрать подходы
Сравните плюсы и минусы разных путей

Выполнение в реальном времени
Смотрите, как узлы подсвечиваются по мере выполнения

Маркетплейс MCP
Просматривайте и прикрепляйте инструменты к узлам

🚀 Установка

Overture — это MCP-сервер, который работает с любым MCP-совместимым AI-агентом для кодинга. Одна команда для установки.

Claude Code

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

Cursor

Добавьте в ~/.cursor/mcp.json:

{
  "mcpServers": {
    "overture": {
      "command": "npx",
      "args": ["overture-mcp"]
    }
  }
}
Другие агенты (Cline, Copilot, Sixth AI)

Cline (расширение VS Code)

Откройте настройки VS Code → найдите "Cline MCP" → добавьте:

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

GitHub Copilot

Создайте .vscode/mcp.json в корне вашего проекта:

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

Примечание: GitHub Copilot MCP требует VS Code 1.99+ и использует servers вместо mcpServers.

Sixth AI (расширение VS Code)

Добавьте в файл настроек Sixth AI MCP:

ПлатформаПуть
macOS~/Library/Application Support/Code/User/globalStorage/sixth.sixth-ai/settings/sixth-mcp-settings.json
Windows%APPDATA%\Code\User\globalStorage\sixth.sixth-ai\settings\sixth-mcp-settings.json
Linux~/.config/Code/User/globalStorage/sixth.sixth-ai/settings/sixth-mcp-settings.json
{
  "mcpServers": {
    "overture": {
      "command": "npx",
      "args": ["overture-mcp"],
      "disabled": false
    }
  }
}

Глобальная установка (опционально)

npm install -g overture-mcp

Проверьте работу

Дайте агенту любое задание. Overture автоматически откроется по адресу http://localhost:3031 с вашим планом, готовым к утверждению.


🎯 Как это работает

How Overture Works

Процесс:

ШагЧто происходит
1. ЗапросВы даете агенту задачу: "Создай REST API с аутентификацией"
2. ПланАгент генерирует подробный план с шагами, ветвлениями и требованиями
3. ВизуализацияOverture отображает план в виде интерактивного графа
4. ОбогащениеВы кликаете по узлам, прикрепляете файлы, выбираете ветки, заполняете ключи API
5. УтверждениеВы нажимаете "Утвердить и выполнить" (или Enter)
6. ВыполнениеНаблюдайте в реальном времени, как узлы пульсируют, завершаются или выдают ошибку
7. УправлениеПауза (Пробел), возобновление, повторный запуск узлов или изменение плана на лету

🛠 Возможности

Интерактивный холст плана

Interactive Canvas

ВозможностьОписание
Холст React FlowПолное панорамирование, масштабирование, перетаскивание с плавной анимацией
Потоковый парсерУзлы плана появляются в реальном времени по мере генерации агентом
Автомакет DagreИнтеллектуальное автоматическое позиционирование узлов
Визуальный статусОжидание (серый) → Активен (пульсирующий желтый) → Завершен (зеленый) / Ошибка (красный)
Индикатор следующего узлаСиняя пульсация показывает, какой узел выполняется следующим
Значки сложностиНизкая (зеленый), Средняя (желтый), Высокая (красный) с первого взгляда
Эффекты свеченияТени подсвечивают активные и предстоящие узлы
Вставляемые ребраНаведите курсор на ребра, чтобы вставить новые узлы в середину плана

Панель деталей узла

Node Details Panel

Нажмите на любой узел, чтобы увидеть его полные детали:

ИнформацияЧто вы видите
Название и описаниеПолный контекст того, что делает этот шаг
Уровень сложностиНизкий / Средний / Высокий с визуальным индикатором
Ожидаемый результатЧто должен произвести этот шаг
Риски и крайние случаиПотенциальные проблемы, на которые стоит обратить внимание
Плюсы и минусыДля вариантов ветвления — сравнение компромиссов

Динамические поля (пользовательский ввод)

Dynamic Fields

Узлы могут запрашивать у вас ввод перед выполнением:

Тип поляПример использования
СтрокаНазвания проектов, URL-адреса, пользовательские значения
ЧислоНомера портов, лимиты, счетчики
ЛогическоеПереключатели Да/Нет для опций
ВыборВыпадающий список с предопределенными вариантами
СекретКлючи API, токены (скрытый ввод)
ФайлПути к файлам для прикрепления контекста

Каждое поле включает:

  • Индикатор обязательно/необязательно
  • Значения по умолчанию
  • Текст справки и описания
  • Инструкции по настройке ("Как получить ключ API")

Вложения файлов

File Attachments

Прикрепляйте контекстные файлы к определенным узлам:

  • Автоматическое определение типа — Изображение, код, документ или другое
  • Визуальные иконки для каждого типа файла
  • Описания — добавляйте заметки о том, почему этот файл важен
  • Удаление — убирайте ненужные вложения

Мета-инструкции

Meta Instructions

Добавляйте пользовательские инструкции LLM к любому узлу:

"Уделите особое внимание обработке ошибок здесь" "Используйте существующий шаблон аутентификации из src/auth.ts" "Обязательно добавьте тесты для крайних случаев"

Инструкции отправляются агенту непосредственно перед выполнением этого узла.


Обнаружение и выбор веток

Branch Selection

Когда агент предлагает несколько подходов:

ВозможностьОписание
АвтообнаружениеВетки определяются по структуре графа (без специальной разметки)
Точки ветвленияУзлы с несколькими исходящими ребрами становятся точками принятия решений
Модальное окно выбораСравнение бок о бок с плюсами и минусами
Сравнение сложностиПросмотр уровня сложности для каждой опции
Визуальный индикаторВыбранная ветка подсвечивается на холсте
Пропуск невыбранногоВыполняется только выбранный вами путь

Чек-лист требований

Requirements Checklist

Прежде чем вы сможете утвердить план, Overture показывает, что необходимо:

  • Пустые обязательные поля — подсчет по узлам
  • Выбор веток — какие решения ожидают принятия
  • Индикатор прогресса — визуальное отслеживание завершения
  • Разворачиваемые элементы — нажмите, чтобы увидеть детали
  • Цветовое кодирование — Зеленый (готово) / Оранжевый (ожидает)

Кнопка «Утвердить» остается неактивной, пока все требования не будут выполнены.


Элементы управления выполнением

Execution Controls

УправлениеКак
УтвердитьНажмите кнопку или клавишу Enter
ПаузаНажмите Spacebar во время выполнения
ВозобновитьНажмите Spacebar снова
Повторить узелНажмите на узел с ошибкой → «Повторить»
Повторить отсюдаПовторно выполнить с любого узла до конца

Кнопка утверждения интеллектуальна:

  • 🟢 «Утвердить и выполнить» — план готов, требования выполнены
  • 🟠 «Выполнить требования» — условия не выполнены
  • 🔵 «Выполняется...» — запущено с индикатором выполнения
  • 🟢 «Завершено» — все готово
  • 🔴 «Ошибка» — произошла ошибка

Структурированный вывод

Structured Output

После выполнения каждого узла просматривайте насыщенный структурированный вывод:

КатегорияЧто показывает
ОбзорРезюме того, что было выполнено
Измененные файлыПути, добавленные/удаленные строки, различия
Созданные файлыНовые файлы с количеством строк
Удаленные файлыУдаленные файлы
Установленные пакетыnpm-пакеты с версиями
Настроенные MCP-серверыСтатус установки (установлен/настроен/ошибка)
Веб-поискиВыполненные запросы, использованные результаты
Вызовы инструментовКакие инструменты использовались и как часто
URL-адреса предпросмотраСсылки на развернутые сайты или предпросмотры
ПримечанияИнформация, предупреждения, ошибки

Каждая категория разворачиваемая — углубляйтесь без визуальной перегрузки.


Модальное окно вывода

Output Modal

Нажмите на любой завершенный узел, чтобы увидеть полный вывод:

  • Прокручиваемый для длинных выводов
  • Подсветка синтаксиса фрагментов кода
  • Закрытие по Escape или кликом вне окна

🏪 Маркетплейс MCP

MCP Marketplace

Просматривайте и прикрепляйте MCP-серверы прямо из интерфейса Overture.

ВозможностьОписание
Встроенный маркетплейсПоиск и обнаружение MCP-серверов
Детали сервераОписания, авторы, ссылки на GitHub, звезды
Просмотр по категориямФильтрация по вариантам использования
Прикрепление к узлуПрикрепляйте определенные инструменты к конкретным шагам
Инструкции по настройкеСмотрите, как настроить каждый сервер
Рекомендуемые серверыКурируемый список для распространенных задач

Когда вы прикрепляете MCP-сервер к узлу, агент получает доступ к этим инструментам только для этого шага.


📂 Поддержка нескольких проектов

Работайте над несколькими проектами одновременно:

ВозможностьОписание
Навигация по вкладкамМгновенное переключение между проектами
АвторегистрацияПроекты регистрируются при первом контакте агента
Изолированное состояниеУ каждого проекта свои планы, узлы, конфигурации
Значки непрочитанногоУзнавайте, когда в других проектах есть обновления
Контекст проектаПросмотр названия проекта, пути и типа агента

Один проект? Панель вкладок автоматически скрывается для более чистого интерфейса.


📜 История планов и сохранность

Никогда не теряйте свою работу:

ФункцияОписание
АвтосохранениеПланы сохраняются каждые 3 секунды
Локальное хранилищеХранится в ~/.overture/history.json
Обозреватель историиВыдвижная панель со всеми прошлыми планами
Значки статусаЗавершён, ошибка, выполняется, приостановлен
Индикаторы прогрессаВизуальный процент завершения
Возобновление в один кликЗагрузить и продолжить любой прошлый план
Полный контекстВсе значения полей, выбор веток, вложения сохранены

Информация о возобновлении

При возобновлении вы получаете полный контекст:

  • Текущий узел — где остановилось выполнение
  • Завершённые узлы — с их результатами
  • Ожидающие узлы — что осталось сделать
  • Узлы с ошибкой — с сообщениями об ошибках
  • Все конфигурации — значения полей, ветки, вложения
  • Временные метки — когда создано, когда приостановлено

✏️ Динамическое изменение плана

Изменяйте планы даже во время выполнения:

ОперацияОписание
Вставить узлыДобавить новые шаги в середине выполнения
Удалить узлыУдалить шаги (связи перестраиваются автоматически)
Заменить содержимоеОбновить заголовок/описание узла на месте
Пакетные операцииНесколько изменений в одном запросе

Представление различий плана

Когда план меняется, смотрите, что именно изменилось:

  • Добавленные узлы — выделены зелёным
  • Удалённые узлы — выделены красным
  • Изменённые узлы — жёлтым со сравнением до/после
  • Изменения связей — добавленные/удалённые соединения

🔌 Инструменты MCP (Для разработчиков агентов)

Overture предоставляет 11 инструментов MCP для взаимодействия агентов:

ИнструментНазначение
submit_planОтправить полный план как XML
get_approvalОжидать одобрения пользователя (блокирует до одобрения)
update_node_statusОбновить статус узла + вывод во время выполнения
plan_completedОтметить план как успешно завершённый
plan_failedОтметить план как завершённый с ошибкой
check_rerunПроверить, запросил ли пользователь повторный запуск узла
check_pauseПроверить, приостановил ли пользователь выполнение
get_resume_infoПолучить полный контекст для возобновления приостановленного плана
request_plan_updateЗапросить инкрементальные изменения плана
create_new_planСигнализировать о создании нового плана
get_usage_instructionsПолучить инструкции, специфичные для агента

🔄 Обмен данными через WebSocket в реальном времени

19 типов сообщений от сервера клиенту:

connectedplan_startednode_addededge_addedplan_readyplan_approvednode_status_updatedplan_completedplan_failedplan_pausedplan_resumednodes_insertednode_removedproject_registeredprojects_listhistory_entriesplan_loadedresume_plan_infoplan_updated

16 типов сообщений от клиента серверу:

approve_plancancel_planrerun_requestpause_executionresume_executioninsert_nodesremove_noderegister_projectsubscribe_projectunsubscribe_projectget_historyload_planget_resume_infosave_planrequest_plan_updatecreate_new_plan

Режим ретрансляции

Когда порт WebSocket уже используется, Overture автоматически работает как клиент-ретранслятор, пересылая сообщения через существующий сервер. Несколько экземпляров агента могут использовать один интерфейс.


⚙️ Конфигурация

ПеременнаяПо умолчаниюОписание
OVERTURE_HTTP_PORT3031Порт для веб-интерфейса
OVERTURE_WS_PORT3030Порт для WebSocket
OVERTURE_AUTO_OPENtrueАвтоматически открывать браузер при запуске

Установка переменных окружения

Claude Code
claude mcp add overture-mcp -e OVERTURE_HTTP_PORT=4000 -e OVERTURE_AUTO_OPEN=false -- npx overture-mcp
Cursor / Cline / Sixth AI
{
  "mcpServers": {
    "overture": {
      "command": "npx",
      "args": ["overture-mcp"],
      "env": {
        "OVERTURE_HTTP_PORT": "4000",
        "OVERTURE_WS_PORT": "4001",
        "OVERTURE_AUTO_OPEN": "false"
      }
    }
  }
}
GitHub Copilot
{
  "servers": {
    "overture": {
      "command": "npx",
      "args": ["overture-mcp"],
      "env": {
        "OVERTURE_HTTP_PORT": "4000",
        "OVERTURE_WS_PORT": "4001",
        "OVERTURE_AUTO_OPEN": "false"
      }
    }
  }
}

⌨️ Горячие клавиши

КлавишаДействие
EnterОдобрить план (когда готов)
SpaceПриостановить / Возобновить выполнение
EscapeСнять выделение с текущего узла / Закрыть модальное окно

🤝 Поддерживаемые агенты

АгентСтатусПримечания
Claude Code✅ ПолнаяНативная поддержка MCP
Cursor✅ ПолнаяЧерез конфигурацию mcp.json
Cline✅ ПолнаяЧерез настройки VS Code
GitHub Copilot✅ ПолнаяТребуется VS Code 1.99+
Sixth AI✅ ПолнаяВстроенный, без настройки

Каждый агент имеет специально адаптированные подсказки для оптимальной генерации планов.


💪 Почему Overture?

Для пользователей

  • Прозрачность — Видите, что именно произойдёт до написания кода
  • Контроль — Одобряйте, отклоняйте или изменяйте любой план
  • Контекст — Прикрепляйте файлы и инструкции к нужным шагам
  • Выбор — Сравнивайте подходы и выбирайте свой путь
  • Наглядность — Прогресс в реальном времени с подробным выводом
  • Безопасность — Приостанавливайте, возобновляйте или перезапускайте в любое время
  • История — Мгновенно возобновляйте любой прошлый план
  • Эффективность — Никаких потраченных токенов на отклонённые подходы

Для ИИ-кодинга

  • Доверие — Делает агентов предсказуемыми и контролируемыми
  • Интерпретируемость — Видите рассуждения ИИ до выполнения
  • Универсальность — Работает с любым агентом, совместимым с MCP
  • Расширяемость — MCP Marketplace для поиска инструментов
  • Открытый исходный код — Лицензия MIT, управляется сообществом
  • Автономность — Без облачных зависимостей
  • Работает офлайн — Полностью локальное выполнение
  • Мультипроектность — Управляйте несколькими рабочими пространствами

🧑‍💻 Разработка

# 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

Технологический стек

УровеньТехнологии
MCP СерверNode.js, TypeScript, Express, WebSocket (ws), SAX XML Parser
UIReact 18, React Flow, Zustand, Framer Motion, Tailwind CSS, Vite
МакетDagre (автоматическое позиционирование графа)

🤝 Участие в разработке

Overture — проект с открытым исходным кодом, и мы приветствуем ваш вклад!

  • 🐛 Сообщайте об ошибках на GitHub Issues
  • 💡 Предлагайте функции на GitHub Discussions
  • 📖 Улучшайте документацию — PR приветствуются
  • 🔧 Вносите код — см. CONTRIBUTING.md

Любой вклад ценен, каким бы малым он ни был.


📄 Лицензия

Лицензия MIT — подробнее см. LICENSE.



Sixth

Создано Sixth

Для наилучшего опыта попробуйте Sixth для VS Code
Overture встроен и не требует настройки.

Хватит действовать вслепую. Смотрите план. Одобряйте его. Выполняйте с уверенностью.

История звёзд

Star History Chart