maestro CLI
maestro хранит в общем корне Git работу, решения, сессии и доказательства людей и агентов локально, без фонового сервиса
- 235 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Установщик скачивает и запускает скрипт, пишет хуки и блоки в `CLAUDE.md` и `AGENTS.md` репозитория и создает общее хранилище в домашней папке.
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/ReinaMacCredy/maestro/main/scripts/install.sh | shНужны `git` и Bun. Скрипт клонирует исходники в `~/.maestro/source` и запускает установщик.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Установщик скачивает и запускает скрипт, пишет хуки и блоки в `CLAUDE.md` и `AGENTS.md` репозитория и создает общее хранилище в домашней папке.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
maestro — консольная система координации на TypeScript и Bun. Она хранит в общем корне Git каждого репозитория долговечную работу, решения, сессии, доказательства, поручения и возвраты результатов. Ядро отвечает за хранилище SQLite, журнал событий, сессии и диспетчеризацию команд, а политики подключаются плагинами: доказательства и разбивку включают или выключают в `.maestro/config`. В команде `maestro` есть глаголы под жизненный цикл: `work add|start|note|done` ведет задачи, `decision draft|lock|confirm` фиксирует решения, `dispatch open|accept` и `handback file` передают поручения и возвраты между сессиями, `status`, `ready` и `attention` показывают состояние и то, что ждет внимания. Методы работы лежат рецептами в Markdown, их показывают `maestro recipe list` и `maestro recipe show`. Установка настраивает адаптеры для Claude и Codex и встраивает хуки `SessionStart` и `UserPromptSubmit`, которые записывают сессию и печатают краткую сводку. Девять управляемых навыков вроде `maestro-work` и `maestro-verify` материализуются в `~/maestro/skills`. Для групп агентов предусмотрен протокол SLP со Supervisor, Lead и Peer.
Для кого. Разработчикам, которые ведут параллельную работу нескольких агентов и людей над репозиториями и хотят видеть задачи, решения и доказательства в одном локальном хранилище.
Подходит, если
- Над репозиторием работают несколько агентов, и нужно видеть, кто какую задачу взял и что готово к старту.
- Важные решения теряются в чатах, и их надо закрепить с причинами и подтверждением.
- Задачу нужно передать другой сессии контрактом и получить результат возвратом с доказательствами.
- Нужны готовые рецепты работы в Markdown, которые агент читает командой `maestro recipe show`.
Не подходит, если
- Нужен сервис с веб-интерфейсом и фоновой синхронизацией: maestro работает локально, без службы.
- Нет возможности поставить Bun и git, а установщик берет исходники из репозитория.
- Вам нужна песочница безопасности для агентов: протокол SLP кооперативный и команды оболочки не блокирует.
Пример запроса к агенту
Открой работу командой `maestro work add`, зафиксируй решение через `maestro decision draft` и покажи `maestro ready`.Ограничения
Maestro распространяется из исходников: установщик клонирует репозиторий в `~/.maestro/source` и требует `git` и Bun. Версия 0.108.0 стала первым релизом на TypeScript после Rust-линии 0.107.x, данные старой версии импортируются командой `maestro import rust`. Протокол SLP создан для кооперации агентов и не служит песочницей: он проверяет девять операций на поддерживаемых границах, а нативные команды и прямые вызовы Herdr остаются без ограничений. Обновление принимает только быстрое слияние и отказывается работать с грязным или разошедшимся источником.
Как отключить. Выполните `maestro uninstall`: команда убирает управляемые хуки и блоки из текущего репозитория, но данные, рантайм и шим не удаляет. Рантайм и шим удалите вручную.
Частые вопросы
Как поставить maestro?
Выполните `curl -fsSL https://raw.githubusercontent.com/ReinaMacCredy/maestro/main/scripts/install.sh | sh`. Нужны `git` и Bun. Из своего клона подойдет `bun bin/maestro.ts install`.
Как проверить установку?
Командой `maestro doctor`: она проверяет шим, рантайм, источник, привязку репозитория, права и доступ к хранилищу и ничего не чинит сама.
Как обновиться?
Командой `maestro update`: она обновляет источник быстрым слиянием и синхронизирует рантайм.
С какими агентами работает?
С Claude Code и Codex: установка пишет управляемые адаптеры и хуки для обоих.
Где хранятся данные?
В общем корне Git каждого репозитория в хранилище SQLite и журнале событий. Отдельная комната Supervisor создается в `~/maestro`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыСкилл с 25 командами для разбора и доработки промптов, инструментов и схем агентов в Cursor, Claude Code, Gemini CLI и Codex
Maestro-Flow по цели строит цепочку от анализа до тестов и гоняет через нее Claude Code, Codex, Gemini и других агентов
Плагин оркестрации для Claude Code, Codex, Gemini CLI и Qwen Code: 39 специалистов, параллельные субагенты, сохраняемые сеансы и отдельные аудиты
Каркас из персон, правил и скиллов в чистом Markdown: Maestro раздает работу разным моделям и экономит основной тариф
Локальный оркестратор на Node.js: Codex, Claude Code, Gemini и OpenCode работают одной командой под руководством оператора
botmux связывает Lark и Feishu с Claude Code, Codex, Gemini CLI и OpenCode: каждое сообщение запускает отдельную сессию агента с живыми карточками
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| maestro (эта карточка) | нет | 235 | |
| maestro-runner | нет | 528 | maestro-runner запускает тесты мобильных приложений, а ReinaMacCredy/maestro координирует работу агентов в Git. |
| agent-memory | нет | 4 315 | agent-memory хранит заметки агента, а здесь учитываются задачи, решения, поручения и доказательства. |
Коротко о README
В README разобраны три слоя: ядро, плагины и рецепты с навыками. Рядом лежат обзор глаголов, режим наблюдателя, настройка адаптеров и правила вклада. Лицензия MIT.