admin-valentin/agent-ecosystem
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
agent-ecosystem/docs/research/ai-maestro-deep-dive.md
iliya fe90ac866d Add deep dive research documentation on AI agent orchestration and communication standards 
- Introduced multiple markdown files covering agent spawn packages, inter-agent communication protocols, and multi-agent orchestration tools.
- Detailed analysis of official SDKs for CLI agents (Claude Code, Codex, Gemini) and their integration potential.
- Documented various competitor approaches to agent spawning and communication, highlighting strengths and weaknesses.
- Provided insights into best practices for implementing multi-provider support within Electron applications.

This comprehensive documentation aims to enhance understanding of the current AI agent ecosystem and serve as a resource for developers and stakeholders.
2026-03-27 17:51:49 +02:00

334 lines
20 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# AI Maestro — Deep Dive Research
**Дата исследования:** 2026-03-25
**Репозиторий:** [23blocks-OS/ai-maestro](https://github.com/23blocks-OS/ai-maestro)
**Сайт:** [ai-maestro.23blocks.com](https://ai-maestro.23blocks.com/)
**Автор:** Juan Pelaez / 23blocks
**Лицензия:** MIT
---
## Общая информация
AI Maestro — open-source оркестратор AI-агентов с системой навыков (Skills System), дашбордом для управления агентами, собственным протоколом обмена сообщениями (AMP) и поддержкой мультимашинных mesh-сетей. Позиционирует себя как "The Future of Work: Humans + AI Agents".
### Метрики репозитория (на 25 марта 2026)
| Метрика | Значение |
|---------|----------|
| Stars | **557** |
| Forks | 77 |
| Open issues | 8 |
| Коммитов | 890+ |
| Контрибьюторов | ~5 (249 от jpelaez-23blocks, далее 9, 7, 4, 2) |
| Создан | 10 октября 2025 |
| Последний коммит | 25 марта 2026 (сегодня!) |
| Последний релиз | v0.26.4 (25 марта 2026) |
| Языки | TypeScript 89%, Shell 6.7%, JS 3.4%, CSS 0.5% |
| Размер репо | ~312 MB |
**Вывод:** Проект активно развивается, коммиты ежедневные. Но по факту это проект одного человека (Juan Pelaez — 249 из ~270 коммитов от людей). 4 коммита от аккаунта `claude` — что ироничным образом подтверждает AI-происхождение кода.
---
## Origin Story
Цитата из описания проекта:
> "I had 35 terminals and couldn't tell which was which."
Автор запускал 35+ AI-агентов одновременно и стал "human mailman" между ними — копировал контекст из одного терминала в другой. Сейчас утверждает, что запускает **80+ агентов** на нескольких компьютерах.
---
## Поддерживаемые агенты
### Заявленная совместимость:
- **Claude Code** (основной)
- **Aider**
- **Cursor**
- **GitHub Copilot CLI**
- **OpenCode** (через Skills)
- **Любой терминальный AI-агент**
### Как это работает:
AI Maestro не является "мультипровайдерным" в том смысле, что он сам вызывает API разных LLM. Он работает на уровне **терминалов** — оборачивает tmux-сессии и предоставляет dashboard для управления ими. Любой инструмент, который работает в терминале, может быть "агентом" в AI Maestro.
**Важное уточнение:** AI Maestro НЕ абстрагирует LLM-провайдеров (как например LiteLLM). Он оркестрирует **процессы в терминале**. Claude Code внутри себя использует Anthropic API, Aider может использовать OpenAI/Anthropic/etc — но AI Maestro этого не контролирует.
---
## Архитектура
### Tech Stack
| Компонент | Технология | Роль |
|-----------|-----------|------|
| Frontend | **Next.js** | Web-дашборд |
| Terminal | **xterm.js** | Эмуляция терминала в браузере |
| Database | **CozoDB** | Граф-реляционная БД для памяти и Code Graph |
| Code Analysis | **ts-morph** | Парсинг AST для Code Graph |
| Process Mgmt | **tmux** | Мультиплексор терминалов |
| Networking | **Peer Mesh** | P2P сеть между машинами |
### CozoDB — выбор базы данных
CozoDB (3 926 stars) — необычный выбор. Это транзакционная реляционно-графовая-векторная БД, использующая **Datalog** для запросов. Ключевые фичи:
- Реляционная модель + графовые алгоритмы
- Векторный поиск через HNSW-индексы
- Встраиваемая (embedded)
- Time-travel запросы
Это позволяет хранить и код-граф (структура кодобазы), и память агентов (conversation history), и выполнять векторный поиск — в одной БД.
### Три уровня "интеллекта"
1. **Memory** — Персистентная память через CozoDB. Агенты помнят прошлые решения и разговоры.
2. **Code Graph** — Визуализация структуры кодобазы. ts-morph парсит AST, извлекает классы/функции/импорты, строит граф зависимостей. Delta-индексация (переиндексируются только изменённые файлы).
3. **Documentation** — Автогенерируемая документация из кода, доступная агентам для поиска.
### Мультимашинная mesh-сеть
- Peer-to-peer топология: каждая машина — равноправный узел
- Нет центрального сервера
- Новая машина автоматически присоединяется к mesh
- Все агенты со всех машин видны в одном дашборде
- Поддержка remote access через Tailscale VPN
### Структура репозитория
```
/app — Application logic
/components — UI-компоненты
/services — Backend-сервисы
/plugin — Система плагинов для Claude Code
/agent-container — Контейнеризированные агенты
/infrastructure/terraform/aws-agent — AWS deployment
/docs — Документация
```
---
## Agent Messaging Protocol (AMP)
AMP — это **собственный протокол** 23blocks для межагентной коммуникации. Отдельный репозиторий: [agentmessaging/protocol](https://github.com/agentmessaging/protocol) (20 stars, Apache 2.0).
### Ключевые характеристики
| Параметр | Значение |
|----------|----------|
| Версия | 0.1.3-draft |
| Лицензия | Apache 2.0 |
| Безопасность | Ed25519 криптографические подписи |
| Адресация | Email-подобная: `agent-name@tenant.provider` |
| Спецификации | 11 документов |
### Формат сообщений
Конверт содержит:
- `from` / `to` — адреса отправителя/получателя
- `subject` — тема
- `priority` — приоритет
- `in_reply_to` — для тредов
- `payload` — произвольный JSON
- `signature` — Ed25519 подпись
Каноническая подпись: `from|to|subject|priority|in_reply_to|SHA256(payload)`
### Доставка сообщений
4 способа:
1. **WebSocket** — реалтайм для подключённых агентов
2. **REST API** — polling
3. **Webhook** — HTTP POST push
4. **Relay queue** — очередь для офлайн-агентов (TTL 7 дней по умолчанию)
5. **Mesh** — локальная маршрутизация без интернета
### Провайдеры (федеративная модель)
- **AI Maestro** (self-hosted): `http://localhost:23000/api/v1` — работает
- **crabmail.ai** — "coming soon"
- **lolainbox.com** — "coming soon"
### Безопасность
- Ed25519 подписи предотвращают подмену отправителя
- Trust-level аннотации для внешних сообщений
- Key revocation с федеративным распространением
- Защита от prompt injection (34 паттерна)
- SSRF-превенция для webhook
### Критическая оценка AMP
**Плюсы:**
- Формально специфицированный протокол (11 документов)
- Криптографическая безопасность по умолчанию
- Федеративная модель
- Поддержка офлайн-агентов
**Минусы:**
- Всего 20 stars на GitHub
- Единственная реализация — сам AI Maestro
- Федерация заявлена, но 2 из 3 провайдеров "coming soon"
- По факту проприетарный протокол одного проекта, несмотря на Apache 2.0 лицензию
- Не совместим с ACP (Agent Communication Protocol), MCP или другими стандартами
---
## Kanban Board
AI Maestro включает kanban-доску с:
- **5 колонок** (статусы задач)
- **Drag-and-drop** перемещение карточек
- **Зависимости** между задачами
- **Шаренные задачи** между агентами
- Часть "War Room" — split-pane интерфейс для командных встреч
**Детали реализации Kanban ограничены** — в документации и на сайте нет скриншотов или подробного описания UX. Описание сводится к маркетинговым фразам: "full Kanban board with drag-and-drop, dependencies, and 5 status columns."
---
## Gateways — внешние интеграции
AI Maestro поддерживает "Gateways" для подключения к внешним сервисам:
- **Slack**
- **Discord**
- **Email**
- **WhatsApp**
Маршрутизация через синтаксис `@AIM:agent-name`. Заявлена защита от 34 паттернов prompt injection.
---
## Skills System
Система плагинов, устанавливаемых через `npx skills add`. Навыки автоматически триггерят:
- Поиск по памяти
- Запросы к Code Graph
- Поиск документации
Совместим с 30+ агентами через "Agent Skills Standard".
### Agent Identity (AID)
Новая фича (v0.26.0, 24 марта 2026): агенты могут аутентифицироваться на OAuth 2.0 серверах используя Ed25519 identity. Без паролей, без API-ключей.
---
## Релизная активность
Последние 5 релизов (за 2 дня!):
| Версия | Дата | Описание |
|--------|------|----------|
| v0.26.4 | 25.03.2026 | AMP mesh routing fix |
| v0.26.3 | 24.03.2026 | AID v0.2.0: независим от AMP |
| v0.26.2 | 24.03.2026 | Dynamic discovery для verification |
| v0.26.1 | 24.03.2026 | Переименование installer, auto-discover skills |
| v0.26.0 | 24.03.2026 | Agent Identity (AID) интеграция |
5 релизов за 2 дня — это очень высокий темп. Может свидетельствовать как об активной разработке, так и о незрелости (частые фиксы только что выпущенных фич).
---
## Сравнение с нашим продуктом (Claude Agent Teams UI)
### Фундаментальные различия
| Аспект | AI Maestro | Claude Agent Teams UI |
|--------|-----------|----------------------|
| **Подход** | Терминальный оркестратор (tmux wrapper) | Нативная UI-надстройка над Claude Code Agent Teams |
| **Агенты** | Любой терминальный AI | Claude Code (нативный Agent Teams API) |
| **Мультипровайдер** | Да (на уровне терминалов) | Нет (Claude-only, но с multi-model: Opus/Sonnet/Haiku) |
| **Kanban** | Есть (5 колонок, drag-drop, dependencies) | Есть (5 колонок, drag-drop, real-time) |
| **Межагентная связь** | AMP protocol (собственный) | Нативный Claude Code inbox/task system |
| **Code Review** | Не указан | Diff view с approve/reject/comment |
| **Deep Analytics** | Memory + Code Graph + Docs | Session analysis, context tracking, token usage |
| **Мультимашинность** | Peer mesh network | Нет (локальный) |
| **UI** | Web (Next.js, браузер) | Desktop (Electron) |
| **Процесс** | tmux sessions | stream-json CLI processes |
### Где AI Maestro сильнее
1. **Мультимашинность** — peer mesh сеть, агенты на разных компьютерах. У нас этого нет вообще.
2. **Мультиагентность** — поддерживает Claude, Aider, Cursor, Copilot и любой терминальный инструмент. Мы только Claude Code.
3. **Memory System** — CozoDB с графовыми запросами, векторным поиском, персистентной памятью. У нас аналитика сессий, но не полноценная "память" агентов.
4. **Code Graph** — визуализация кодобазы через ts-morph + CozoDB. У нас такого нет.
5. **External Gateways** — Slack, Discord, Email, WhatsApp. У нас встроенный MCP-сервер, но не gateway к мессенджерам.
6. **Scale** — заявляет 80+ агентов. Наш продукт ориентирован на команды 3-8 агентов.
### Где наш продукт сильнее
1. **Нативная интеграция с Claude Code** — мы работаем с официальным Agent Teams API, а не просто оборачиваем терминалы. Наши агенты нативно общаются через inbox, шарят задачи, имеют structured task references.
2. **Code Review** — полноценный diff view с accept/reject/comment, как в Cursor. У AI Maestro это не заявлено.
3. **Kanban UX** — у нас real-time обновления, direct messaging на карточках, quick actions, structured task references с кросс-ссылками. AI Maestro заявляет Kanban, но без деталей UX.
4. **Deep Session Analysis** — bash commands, reasoning, subprocesses breakdown, chunk timeline. AI Maestro показывает терминал, но не анализирует сессии.
5. **Context Monitoring** — 6 категорий контекста (CLAUDE.md, tool outputs, thinking, team coordination), token usage by category. Уникальная фича.
6. **Desktop App** — нативный Electron, не браузерная вкладка.
7. **DM to agents** — прямые сообщения конкретному агенту с карточки задачи.
8. **Zero-setup** — встроенная установка Claude Code и аутентификация. AI Maestro требует Node.js + tmux + установку.
9. **Built-in Code Editor** — редактор файлов с Git support.
10. **Post-compact context recovery** — восстановление инструкций после context compaction.
### Фундаментальная разница в философии
**AI Maestro** = "Terminal multiplexer on steroids" — оборачивает tmux, добавляет UI и межагентную коммуникацию. Агенты — это просто терминальные сессии. Протокол AMP — собственный, не стандартный.
**Claude Agent Teams UI** = "CTO dashboard for Claude teams" — нативная надстройка над Claude Code Agent Teams, с глубоким пониманием внутренних протоколов Claude (stream-json, inbox, tasks). Агенты — это структурированные сущности с ролями, задачами и коммуникацией.
---
## Рыночное позиционирование
AI Maestro позиционирован в [awesome-agent-orchestrators](https://github.com/andyrewlee/awesome-agent-orchestrators) в категории **"Parallel Agent Runners"** наряду с 38 другими инструментами.
### Конкуренты AI Maestro (не наши)
| Инструмент | Фокус | Stars |
|-----------|-------|-------|
| **Maestro** (RunMaestro) | Desktop orchestrator, Claude/Codex/OpenCode | 2000+ |
| **Vibe Kanban** (BloopAI) | Kanban + Git worktree + MCP | N/A |
| **Claw-Kanban** | Kanban + role-based auto-assignment | N/A |
| **Agent Orchestrator** (ComposioHQ) | Plugin-based, tracker-agnostic | N/A |
RunMaestro (отдельный проект) — самый серьёзный конкурент для AI Maestro: 2000+ stars, desktop app, Group Chat, Auto Run, Mobile Remote Control.
---
## Оценки
### Надёжность решения: 6/10
- Проект одного разработчика (249 из ~270 коммитов)
- Зависимость от CozoDB (нишевая БД)
- 5 релизов за 2 дня — признак незрелости
- AMP протокол — 20 stars, единственная реализация
- Нет community reviews (Reddit/HN)
- Нет automated tests (не видно в описании)
### Уровень угрозы для нашего продукта: 4/10
- Другая ниша: мультиагентный терминальный оркестратор vs нативный Claude Teams UI
- Наша аудитория — пользователи Claude Code Agent Teams
- Их аудитория — пользователи 3+ разных AI-инструментов
- Пересечение небольшое: только если пользователь Claude Code решит добавить другие инструменты
### Что стоит позаимствовать
1. **Memory System** — персистентная память агентов между сессиями. Наши агенты теряют контекст при рестарте. CozoDB — overengineered для нас, но концепция ценная.
2. **Code Graph** — визуализация кодобазы. Можно реализовать через tree-sitter или ts-morph + простое хранение.
3. **Multi-machine** — даже не P2P mesh, но хотя бы возможность подключаться к remote Claude Code сессиям.
4. **External integrations** — Slack/Discord уведомления о прогрессе задач.
---
## Источники
- [GitHub: 23blocks-OS/ai-maestro](https://github.com/23blocks-OS/ai-maestro)
- [AI Maestro Website](https://ai-maestro.23blocks.com/)
- [AMP Protocol: agentmessaging/protocol](https://github.com/agentmessaging/protocol)
- [Agent Messaging Protocol Website](https://agentmessaging.org/)
- [CozoDB](https://github.com/cozodb/cozo)
- [Medium: "Your AI Agent Has Amnesia"](https://medium.com/23blocks/your-ai-agent-has-amnesia-heres-how-we-fixed-it-49980712f2e4) (paywall)
- [Medium: "From 47 Terminal Windows to One Dashboard"](https://medium.com/23blocks/building-ai-maestro-from-47-terminal-windows-to-one-beautiful-dashboard-64cd25ff3b43) (paywall)
- [awesome-agent-orchestrators](https://github.com/andyrewlee/awesome-agent-orchestrators)
- [Maestro vs Superpowers vs ECC comparison gist](https://gist.github.com/jeffscottward/de77a769d9e25a8ccdc92b65291b1c34)
Reference in a new issue View git blame Copy permalink